SqlBulkCopyOptions Výčet

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

Bitový příznak, který určuje jednu nebo více možností, které se mají použít s instancí SqlBulkCopy.

Tento výčet podporuje bitové kombinace hodnot jeho členů.

public enum class SqlBulkCopyOptions

[System.Flags]
public enum SqlBulkCopyOptions

[<System.Flags>]
type SqlBulkCopyOptions = 

Public Enum SqlBulkCopyOptions

Dědičnost

Object

ValueType

Enum

SqlBulkCopyOptions

Atributy

FlagsAttribute

Pole

Name	Hodnota	Description
Default	0	Pro všechny možnosti použijte výchozí hodnoty.
KeepIdentity	1	Zachování hodnot zdrojové identity Pokud není zadáno, hodnoty identity jsou přiřazeny cílem.
CheckConstraints	2	Zkontrolujte omezení při vkládání dat. Ve výchozím nastavení nejsou omezení zaškrtnutá.
TableLock	4	Získejte zámek hromadné aktualizace po dobu trvání operace hromadného kopírování. Pokud není zadáno, použijí se zámky řádků.
KeepNulls	8	Zachovat hodnoty null v cílové tabulce bez ohledu na nastavení výchozích hodnot. Pokud nezadáte, hodnoty null se nahradí výchozími hodnotami, pokud je to možné.
FireTriggers	16	Po zadání může server aktivovat triggery vložení pro řádky vložené do databáze.
UseInternalTransaction	32	Při zadání bude každá dávka operace hromadného kopírování probíhat v rámci transakce. Pokud tuto možnost označíte a také zadáte SqlTransaction objekt konstruktoru, dojde k chybě ArgumentException .
AllowEncryptedValueModifications	64	Pokud je zadáno, AllowEncryptedValueModifications umožňuje hromadné kopírování šifrovaných dat mezi tabulkami nebo databázemi bez dešifrování dat. Aplikace obvykle vybere data ze zašifrovaných sloupců z jedné tabulky bez dešifrování dat (aplikace se připojí k databázi pomocí klíčového slova nastavení šifrování sloupce nastaveného na zakázáno) a pak by tuto možnost použila k hromadnému vložení dat, která jsou stále šifrovaná. Další informace naleznete v tématu Always Encrypted. Při zadávání AllowEncryptedValueModifications buďte opatrní, protože to může vést k poškození databáze, protože ovladač nekontroluje, jestli jsou data skutečně šifrovaná, nebo pokud jsou správně zašifrovaná pomocí stejného typu šifrování, algoritmu a klíče jako cílový sloupec.

Příklady

Následující konzolová aplikace ukazuje, jak provést hromadné načtení, které zkopíruje hodnotu ve sloupci identity zdrojové tabulky do odpovídajícího sloupce v cílové tabulce místo generování nové hodnoty pro sloupec identity každého řádku.

Pokud chcete zjistit, jak tato možnost mění způsob, jakým hromadné načítání funguje, spusťte ukázku s dbo. Tabulka BulkCopyDemoMatchingColumns je prázdná. Všechny řádky se načítají ze zdroje. Potom znovu spusťte ukázku bez vyprázdnění tabulky. Vyvolá se výjimka a kód zapíše do okna konzoly zprávu s oznámením, že řádky nebyly přidány kvůli porušení primárního klíče.

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.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();

            // Create the SqlBulkCopy object using a connection string
            // and the KeepIdentity option.
            // In the real world you would not use SqlBulkCopy to move
            // data from one table to the other in the same database.
            using (SqlBulkCopy bulkCopy =
                new SqlBulkCopy(connectionString, SqlBulkCopyOptions.KeepIdentity))
            {
                bulkCopy.DestinationTableName =
                    "dbo.BulkCopyDemoMatchingColumns";

                try
                {
                    // Write from the source to the destination.
                    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;";
    }
}

Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Dim connectionString As String = GetConnectionString()

        ' Open a connection to the AdventureWorks database.
        Using sourceConnection As SqlConnection = _
           New SqlConnection(connectionString)
            sourceConnection.Open()

            ' Perform an initial count on the destination table.
            Dim commandRowCount As New SqlCommand( _
            "SELECT COUNT(*) FROM dbo.BulkCopyDemoMatchingColumns;", _
                sourceConnection)
            Dim countStart As Long = _
               System.Convert.ToInt32(commandRowCount.ExecuteScalar())
            Console.WriteLine("Starting row count = {0}", countStart)

            ' Get data from the source table as a SqlDataReader.
            Dim commandSourceData As SqlCommand = New SqlCommand( _
               "SELECT ProductID, Name, ProductNumber " & _
               "FROM Production.Product;", sourceConnection)
            Dim reader As SqlDataReader = commandSourceData.ExecuteReader

            ' Create the SqlBulkCopy object using a connection string 
            ' and the KeepIdentity option. 
            ' In the real world you would not use SqlBulkCopy to move
            ' data from one table to the other in the same database.
            Using bulkCopy As SqlBulkCopy = _
              New SqlBulkCopy(connectionString, SqlBulkCopyOptions.KeepIdentity)
                bulkCopy.DestinationTableName = "dbo.BulkCopyDemoMatchingColumns"

                Try
                    ' Write from the source to the destination.
                    bulkCopy.WriteToServer(reader)

                Catch ex As Exception
                    Console.WriteLine(ex.Message)

                    Finally
                        ' Close the SqlDataReader. The SqlBulkCopy
                        ' object is automatically closed at the end
                        ' of the Using block.
                        reader.Close()
                End Try
            End Using

            ' Perform a final count on the destination table
            ' to see how many rows were added.
            Dim countEnd As Long = _
                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()
        End Using
    End Sub

    Private Function GetConnectionString() As String
        ' 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;"
    End Function
End Module

Poznámky

Výčet SqlBulkCopyOptions můžete použít při vytváření SqlBulkCopy instance ke změně způsobu WriteToServer chování metod pro danou instanci.

Viz také

• Operace hromadného kopírování na SQL Serveru
• Přehled ADO.NET