SqlBulkCopyColumnMapping Klasse

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Definiert die Zuordnung zwischen einer Spalte in der Datenquelle einer SqlBulkCopy-Instanz und einer Spalte in der Zieltabelle der Instanz.

public ref class SqlBulkCopyColumnMapping sealed

public sealed class SqlBulkCopyColumnMapping

type SqlBulkCopyColumnMapping = class

Public NotInheritable Class SqlBulkCopyColumnMapping

Vererbung

Object

SqlBulkCopyColumnMapping

Beispiele

Im folgenden Beispiel werden Daten aus einer Quelltabelle in der Beispieldatenbank AdventureWorks in eine Zieltabelle derselben Datenbank massenkopiert. Obwohl die Anzahl der Spalten im Ziel mit der Anzahl der Spalten in der Quelle übereinstimmt und sich jede Zielspalte an derselben Ordnungsposition wie die entsprechende Quellspalte befindet, stimmen die Spaltennamen nicht überein. SqlBulkCopyColumnMapping -Objekte werden verwendet, um eine Spaltenzuordnung für den Massenkopiervorgang zu erstellen.

Wichtig

Dieses Beispiel wird nur ausgeführt, wenn Sie die Arbeitstabellen erstellt haben, wie unter Massenkopierbeispielsetup beschrieben. Der angegebene Code dient nur zur Demonstration der Syntax für die Verwendung von SqlBulkCopy. Wenn sich die Quell- und Zieltabellen in derselben SQL Server Instanz befinden, ist es einfacher und schneller, eine Transact-SQL-Anweisung INSERT … SELECT zum Kopieren der Daten zu verwenden.

using System;
using System.Data;
using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        string connectionString = GetConnectionString();
        // Open a sourceConnection to the AdventureWorks database.
        using (SqlConnection sourceConnection =
                   new SqlConnection(connectionString))
        {
            sourceConnection.Open();

            // Perform an initial count on the destination table.
            SqlCommand commandRowCount = new SqlCommand(
                "SELECT COUNT(*) FROM " +
                "dbo.BulkCopyDemoDifferentColumns;",
                sourceConnection);
            long countStart = System.Convert.ToInt32(
                commandRowCount.ExecuteScalar());
            Console.WriteLine("Starting row count = {0}", countStart);

            // Get data from the source table as a SqlDataReader.
            SqlCommand commandSourceData = new SqlCommand(
                "SELECT ProductID, Name, " +
                "ProductNumber " +
                "FROM Production.Product;", sourceConnection);
            SqlDataReader reader =
                commandSourceData.ExecuteReader();

            // Set up the bulk copy object.
            using (SqlBulkCopy bulkCopy =
                       new SqlBulkCopy(connectionString))
            {
                bulkCopy.DestinationTableName =
                    "dbo.BulkCopyDemoDifferentColumns";

                // Set up the column mappings by name.
                SqlBulkCopyColumnMapping mapID =
                    new SqlBulkCopyColumnMapping("ProductID", "ProdID");
                bulkCopy.ColumnMappings.Add(mapID);

                SqlBulkCopyColumnMapping mapName =
                    new SqlBulkCopyColumnMapping("Name", "ProdName");
                bulkCopy.ColumnMappings.Add(mapName);

                SqlBulkCopyColumnMapping mapMumber =
                    new SqlBulkCopyColumnMapping("ProductNumber", "ProdNum");
                bulkCopy.ColumnMappings.Add(mapMumber);

                // Write from the source to the destination.
                try
                {
                    bulkCopy.WriteToServer(reader);
                }
                catch (Exception ex)
                {
                    Console.WriteLine(ex.Message);
                }
                finally
                {
                    // Close the SqlDataReader. The SqlBulkCopy
                    // object is automatically closed at the end
                    // of the using block.
                    reader.Close();
                }
            }

            // Perform a final count on the destination 
            // table to see how many rows were added.
            long countEnd = System.Convert.ToInt32(
                commandRowCount.ExecuteScalar());
            Console.WriteLine("Ending row count = {0}", countEnd);
            Console.WriteLine("{0} rows were added.", countEnd - countStart);
            Console.WriteLine("Press Enter to finish.");
            Console.ReadLine();
        }
    }

    private static string GetConnectionString()
    // To avoid storing the sourceConnection string in your code, 
    // you can retrieve it from a configuration file. 
    {
        return "Data Source=(local); " +
            " Integrated Security=true;" +
            "Initial Catalog=AdventureWorks;";
    }
}

Hinweise

Spaltenzuordnungen definieren die Zuordnung zwischen Datenquelle und Zieltabelle.

Wenn Zuordnungen nicht definiert sind , d. h. die ColumnMappings Auflistung leer ist, werden die Spalten implizit basierend auf der Ordnungsposition zugeordnet. Damit dies funktioniert, müssen Quell- und Zielschema übereinstimmen. Andernfalls wird ein InvalidOperationException ausgelöst.

Wenn die ColumnMappings Auflistung nicht leer ist, muss nicht jede Spalte in der Datenquelle angegeben werden. Diejenigen, die nicht von der Auflistung zugeordnet sind, werden ignoriert.

Sie können auf Quell- und Zielspalten über den Namen oder die Ordnungszahl verweisen. Sie können auch Nachnamen- und By-Ordinal-Spaltenverweise in derselben Zuordnungssammlung kombinieren.

Konstruktoren

SqlBulkCopyColumnMapping()	Der parameterlose Konstruktor, der ein neues SqlBulkCopyColumnMapping-Objekt initialisiert.
SqlBulkCopyColumnMapping(Int32, Int32)	Erstellt eine neue Spaltenzuordnung, wobei auf die Quell- und Zielspalten mithilfe von Spaltenordnungszahlen verwiesen wird.
SqlBulkCopyColumnMapping(Int32, String)	Erstellt eine neue Spaltenzuordnung, wobei auf die Quellspalten mithilfe von Spaltenordnungszahlen und auf die Zielspalten mithilfe von Spaltennamen verwiesen wird.
SqlBulkCopyColumnMapping(String, Int32)	Erstellt eine neue Spaltenzuordnung, wobei auf die Quellspalten mithilfe von Spaltennamen und auf die Zielspalten mithilfe von Spaltenordnungszahlen verwiesen wird.
SqlBulkCopyColumnMapping(String, String)	Erstellt eine neue Spaltenzuordnung, wobei auf die Quell- und Zielspalten mithilfe von Spaltennamen verwiesen wird.

Eigenschaften

DestinationColumn	Name der Spalte, die in der Zieldatenbanktabelle zugeordnet wird.
DestinationOrdinal	Der Ordinalwert der Zielspalte innerhalb der Zieltabelle.
SourceColumn	Der Name der Spalte, die in der Datenquelle zugeordnet wird.
SourceOrdinal	Die Ordinalposition der Quellspalte innerhalb der Datenquelle.