SqlBulkCopyOptions Énumération

Référence

Définition

Espace de noms:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Indicateur de bits qui spécifie une ou plusieurs options à utiliser avec une instance de SqlBulkCopy.

Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.

public enum class SqlBulkCopyOptions

[System.Flags]
public enum SqlBulkCopyOptions

[<System.Flags>]
type SqlBulkCopyOptions =

Public Enum SqlBulkCopyOptions

Héritage: Object

ValueType

Enum
SqlBulkCopyOptions

Attributs: FlagsAttribute

Champs

AllowEncryptedValueModifications	64	Lorsqu’il est spécifié, AllowEncryptedValueModifications permet la copie en bloc de données chiffrées entre tables ou bases de données, sans déchiffrer les données. En règle générale, une application sélectionne les données à partir de colonnes chiffrées d’une table sans déchiffrer les données (elle se connecte à la base de données avec le mot-clé de paramètre de chiffrement de colonne défini sur « Enabled »), puis utilise cette option pour insérer les données en bloc, qui sont toujours chiffrées. Pour plus d’informations, consultez Always Encrypted. Soyez prudent lorsque vous spécifiez AllowEncryptedValueModifications , car cela peut entraîner une corruption de la base de données, car le pilote ne vérifie pas si les données sont effectivement chiffrées ou si elles sont correctement chiffrées à l’aide du même type de chiffrement, de l’algorithme et de la clé que la colonne cible.
CheckConstraints	2	Vérifie les contraintes pendant l'insertion des données. Par défaut, les contraintes ne sont pas vérifiées.
Default	0	Utilise les valeurs par défaut pour toutes les options.
FireTriggers	16	Si spécifié, entraîne l'exécution par le serveur des déclencheurs d'insertion pour les lignes insérées dans la base de données.
KeepIdentity	1	Conserve les valeurs d'identité sources. Quand cette option n'est pas spécifiée, les valeurs d'identité sont assignées par la destination.
KeepNulls	8	Conserve les valeurs null dans la table de destination, indépendamment des paramètres des valeurs par défaut. Quand cette option n'est pas spécifiée, les valeurs null sont remplacées par les valeurs par défaut, s'il y a lieu.
TableLock	4	Obtient un verrou de mise à jour en bloc pour la durée de l'opération de copie en bloc. Quand cette option n'est pas spécifiée, des verrous de ligne sont utilisés.
UseInternalTransaction	32	Si spécifié, chaque lot de l'opération de copie en bloc se produit dans une transaction. Si vous indiquez cette option et fournissez également un objet SqlTransaction au constructeur, ArgumentException se produit.

Exemples

L’application console suivante montre comment effectuer un chargement en bloc qui copie la valeur dans la colonne d’identité de la table source vers la colonne correspondante de la table de destination, au lieu de générer une nouvelle valeur pour la colonne d’identité de chaque ligne.

Pour voir comment l’option change le fonctionnement du chargement en bloc, exécutez l’exemple avec le dbo. Table BulkCopyDemoMatchingColumns vide. Toutes les lignes sont chargées à partir de la source. Ensuite, réexécutez l’exemple sans vider la table. Une exception est levée et le code écrit un message dans la fenêtre de console vous informant que les lignes n’ont pas été ajoutées en raison de violations de clé primaire.

Important

Cet exemple ne s’exécute pas, sauf si vous avez créé les tables de travail comme décrit dans l’exemple d’installation de copie en bloc. Ce code est fourni uniquement pour illustrer la syntaxe de l’utilisation de SqlBulkCopy. Si les tables source et de destination se trouvent dans la même instance SQL Server, il est plus facile et plus rapide d’utiliser une instruction Transact-SQL INSERT … SELECT pour copier les données.

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

Remarques

Vous pouvez utiliser l’énumération SqlBulkCopyOptions lorsque vous construisez une SqlBulkCopy instance pour modifier le comportement des WriteToServer méthodes de cette instance.

S’applique à