SqlBulkCopyColumnMappingCollection Klasse

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Eine Auflistung von SqlBulkCopyColumnMapping-Objekten, die von CollectionBase erbt.

public ref class SqlBulkCopyColumnMappingCollection sealed : System::Collections::CollectionBase

public sealed class SqlBulkCopyColumnMappingCollection : System.Collections.CollectionBase

type SqlBulkCopyColumnMappingCollection = class
    inherit CollectionBase

Public NotInheritable Class SqlBulkCopyColumnMappingCollection
Inherits CollectionBase

Vererbung

CollectionBase

SqlBulkCopyColumnMappingCollection

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, stimmen die Spaltennamen und Ordnungspositionen nicht überein. SqlBulkCopyColumnMapping werden für das SqlBulkCopyColumnMappingCollectionSqlBulkCopy -Objekt hinzugefügt, 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";

                // The column order in the source doesn't match the order 
                // in the destination, so ColumnMappings must be defined.
                bulkCopy.ColumnMappings.Add("ProductID", "ProdID");
                bulkCopy.ColumnMappings.Add("Name", "ProdName");
                bulkCopy.ColumnMappings.Add("ProductNumber", "ProdNum");

                // 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. Wenn sie dies nicht tun, 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 Nachnamen- und Nach ordinalspaltenverweise in derselben Zuordnungssammlung kombinieren.

Eigenschaften

Item[Int32]

Ruft das SqlBulkCopyColumnMapping-Objekt am angegebenen Index ab.

Methoden

Add(Int32, Int32)	Erstellt ein neues SqlBulkCopyColumnMapping und fügt es der Auflistung hinzu, wobei die Quell- und Zielspalten mithilfe von Ordnungszahlen definiert werden.
Add(Int32, String)	Erstellt ein neues SqlBulkCopyColumnMapping und fügt es der Auflistung hinzu, wobei die Quellspalten mithilfe von Ordnungszahlen und die Zielspalten mithilfe von Zeichenfolgen definiert werden.
Add(SqlBulkCopyColumnMapping)	Fügt der SqlBulkCopyColumnMappingCollection die angegebene Zuordnung hinzu.
Add(String, Int32)	Erstellt ein neues SqlBulkCopyColumnMapping und fügt es der Auflistung hinzu, wobei die Quellspalte mithilfe eines Spaltennamens und die Zielspalte mithilfe einer Ordnungszahl definiert werden.
Add(String, String)	Erstellt ein neues SqlBulkCopyColumnMapping und fügt es der Auflistung hinzu, wobei die die Quell- und die Zielspalte mithilfe von Spaltennamen definiert werden.
Clear()	Löscht den Inhalt der Auflistung.
Contains(SqlBulkCopyColumnMapping)	Ruft einen Wert ab, der angibt, ob ein bestimmtes SqlBulkCopyColumnMapping-Objekt in der Auflistung vorhanden ist.
CopyTo(SqlBulkCopyColumnMapping[], Int32)	Kopiert die Elemente aus SqlBulkCopyColumnMappingCollection in ein Array von SqlBulkCopyColumnMapping-Elementen, beginnend bei einem bestimmten Index.
IndexOf(SqlBulkCopyColumnMapping)	Ruft den Index des angegebenen SqlBulkCopyColumnMapping-Objekts ab.
Insert(Int32, SqlBulkCopyColumnMapping)	Fügen Sie am angegebenen Index eine neue SqlBulkCopyColumnMapping ein.
Remove(SqlBulkCopyColumnMapping)	Entfernt das angegebene SqlBulkCopyColumnMapping aus SqlBulkCopyColumnMappingCollection.
RemoveAt(Int32)	Entfernt am angegebenen Index die Zuordnung aus der Auflistung.