SqlBulkCopyColumnOrderHintCollection Třída

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v7.1.0

SqlBulkCopyColumnOrderHint Kolekce objektů, které dědí z CollectionBase.

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

public sealed class SqlBulkCopyColumnOrderHintCollection : System.Collections.CollectionBase

type SqlBulkCopyColumnOrderHintCollection = class
    inherit CollectionBase

Public NotInheritable Class SqlBulkCopyColumnOrderHintCollection
Inherits CollectionBase

Dědičnost

CollectionBase

SqlBulkCopyColumnOrderHintCollection

Příklady

Následující příklad hromadně kopíruje data ze zdrojové tabulky v ukázkové databázi AdventureWorks do cílové tabulky ve stejné databázi. SqlBulkCopyColumnOrderHints se přidají do SqlBulkCopyColumnOrderHintCollection objektu SqlBulkCopy , aby bylo možné určit rady pořadí pro operaci hromadného kopírování.

Important

Tento příklad se nespustí, pokud jste nevytvořili pracovní tabulky, jak je popsáno v Příklad nastavení hromadného kopírování.

Tento kód je k dispozici k předvedení syntaxe pouze pro použití sqlBulkCopy . Pokud jsou zdrojové a cílové tabulky ve stejné instanci SQL Serveru, je jednodušší a rychlejší použít příkaz Transact-SQL INSERT … SELECT ke zkopírování dat.

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.BulkCopyDemoMatchingColumns;",
                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.BulkCopyDemoMatchingColumns";

                // Specify the sort order for the ProductNumber column in 
                // the destination table.
                bulkCopy.ColumnOrderHints.Add("ProductNumber", SortOrder.Ascending);

                // 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;";
    }
}

Poznámky

Rady pořadí sloupců definují pořadí řazení sloupce v cílové tabulce.

Výkon sqlBulkCopy se zlepší, pokud se importovaná data seřadí podle clusterovaného indexu v tabulce( pokud existuje). Pokud jsou data seřazená v pořadí, které se liší od pořadí clusterovaného indexového klíče nebo pokud v tabulce není žádný clusterovaný index, bude tip pořadí ignorován.

Nápovědu pořadí je možné zadat pro libovolný počet sloupců v cílové tabulce. Ve výchozím nastavení operace hromadného vložení předpokládá, že data nejsou seřazena, pokud nejsou k dispozici žádné rady.

Zadané názvy sloupců musí být platné názvy sloupců v cílové tabulce. Pořadí, ve kterém lze zadat nápovědy, je libovolné. Název jednoho sloupce nelze zadat více než jednou.

ColumnMappings Pokud kolekce není prázdná, dají se pokyny pro pořadí zadat pouze pro platné cílové sloupce, které byly namapovány.

Pokud zadáte nezadanou SortOrder položku, vyvolá se chyba ArgumentException .

Konstruktory

Název	Description
SqlBulkCopyColumnOrderHintCollection()	SqlBulkCopyColumnOrderHint Kolekce objektů, které dědí z CollectionBase.

Vlastnosti

Název	Description
Item[Int32]	SqlBulkCopyColumnOrderHint Získá objekt v zadaném indexu.

Metody

Název	Description
Add(SqlBulkCopyColumnOrderHint)	Přidá do pole SqlBulkCopyColumnOrderHintCollection.
Add(String, SortOrder)	Vytvoří novou SqlBulkCopyColumnOrderHint a přidá ji do kolekce.
Clear()	Vymaže obsah kolekce.
Contains(SqlBulkCopyColumnOrderHint)	Získá hodnotu určující, zda zadaný SqlBulkCopyColumnOrderHint objekt existuje v kolekci.
CopyTo(SqlBulkCopyColumnOrderHint[], Int32)	Zkopíruje prvky SqlBulkCopyColumnOrderHintCollection pole SqlBulkCopyColumnOrderHint položek počínaje konkrétním indexem.
IndexOf(SqlBulkCopyColumnOrderHint)	Získá index zadaného SqlBulkCopyColumnOrderHint objektu.
Insert(Int32, SqlBulkCopyColumnOrderHint)	Vložte nový SqlBulkCopyColumnOrderHint do zadaného indexu.
Remove(SqlBulkCopyColumnOrderHint)	Odebere zadaný SqlBulkCopyColumnOrderHint prvek z objektu SqlBulkCopyColumnOrderHintCollection.
RemoveAt(Int32)	Odebere z kolekce nápovědu pořadí sloupců u zadaného indexu.