SqlBulkCopy.SqlRowsCopied Événement

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Se produit chaque fois que le nombre de lignes spécifié par la propriété NotifyAfter a été traité.

public:
 event Microsoft::Data::SqlClient::SqlRowsCopiedEventHandler ^ SqlRowsCopied;

public event Microsoft.Data.SqlClient.SqlRowsCopiedEventHandler SqlRowsCopied;

member this.SqlRowsCopied : Microsoft.Data.SqlClient.SqlRowsCopiedEventHandler 

Public Custom Event SqlRowsCopied As SqlRowsCopiedEventHandler 

Type d'événement

SqlRowsCopiedEventHandler

Exemples

L’application console suivante montre comment charger des données en bloc à l’aide d’une connexion déjà ouverte. La NotifyAfter propriété est définie de telle sorte que le gestionnaire d’événements soit appelé après chaque copie de 50 lignes dans la table.

Dans cet exemple, la connexion est d’abord utilisée pour lire les données d’une table SQL Server vers une SqlDataReader instance. Notez que les données sources n’ont pas besoin d’être situées sur SQL Server ; vous pouvez utiliser n’importe quelle source de données qui peut être lue dans un IDataReader ou chargée dans un DataTable.

Important

Cet exemple ne s’exécutera que si vous avez créé les tables de travail comme décrit dans Configuration de l’exemple 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 le même SQL Server instance, il est plus facile et plus rapide d’utiliser une instruction Transact-SQL INSERT … SELECT pour copier les données.

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("NotifyAfter Sample");
            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. 
            // 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))
            {
                bulkCopy.DestinationTableName =
                    "dbo.BulkCopyDemoMatchingColumns";

                // Set up the event handler to notify after 50 rows.
                bulkCopy.SqlRowsCopied +=
                    new SqlRowsCopiedEventHandler(OnSqlRowsCopied);
                bulkCopy.NotifyAfter = 50;

                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 void OnSqlRowsCopied(
        object sender, SqlRowsCopiedEventArgs e)
    {
        Console.WriteLine("Copied {0} so far...", e.RowsCopied);
    }
    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;";
    }
}

Remarques

Notez que les paramètres de NotifyAfter et BatchSize sont indépendants. La réception d’un SqlRowsCopied événement n’implique pas que des lignes aient été envoyées au serveur ou validées.

Vous ne pouvez pas appeler SqlBulkCopy.Close (Close()) ou SqlConnection.Close (Close()) à partir de cet événement. Cela entraîne la levée d’un InvalidOperationException objet et l’état de l’objet SqlBulkCopy ne change pas. Si l’utilisateur souhaite annuler l’opération de l’événement, la Abort propriété de peut SqlRowsCopiedEventArgs être utilisée. (Voir Opérations de transaction et de copie en bloc pour obtenir des exemples qui utilisent la Abort propriété.)

Aucune action, telle que l’activité de transaction, n’est prise en charge dans la connexion pendant l’exécution de l’opération de copie en bloc, et il est recommandé de ne pas utiliser la même connexion que celle utilisée pendant l’événement SqlRowsCopied . Toutefois, vous pouvez ouvrir une autre connexion.