SqlBulkCopy.SqlRowsCopied Zdarzenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Występuje za każdym razem, gdy liczba wierszy określonych przez NotifyAfter właściwość została przetworzona.
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
Public Event SqlRowsCopied As SqlRowsCopiedEventHandler
Typ zdarzenia
Przykłady
W poniższej aplikacji konsolowej pokazano, jak zbiorczo ładować dane przy użyciu połączenia, które jest już otwarte. Właściwość NotifyAfter jest ustawiana tak, aby program obsługi zdarzeń był wywoływany po każdym 50 wierszach skopiowanych do tabeli.
W tym przykładzie połączenie jest najpierw używane do odczytywania danych z tabeli SQL Server do SqlDataReader wystąpienia. Należy pamiętać, że dane źródłowe nie muszą znajdować się na SQL Server. Można użyć dowolnego źródła danych, które można odczytać do obiektu IDataReader lub załadować do obiektu DataTable.
Ważne
Ten przykład nie zostanie uruchomiony, chyba że tabele robocze zostały utworzone zgodnie z opisem w temacie Konfiguracja przykładu kopiowania zbiorczego.
Ten kod jest dostarczany w celu zademonstrowania składni tylko przy użyciu narzędzia SqlBulkCopy . Jeśli tabele źródłowe i docelowe znajdują się w tym samym wystąpieniu SQL Server, łatwiej i szybciej używać instrukcji Języka Transact-SQL INSERT … SELECT
do kopiowania danych.
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;";
}
}
Uwagi
Należy pamiętać, że ustawienia NotifyAfter i BatchSize są niezależne. SqlRowsCopied Otrzymanie zdarzenia nie oznacza, że do serwera lub zatwierdzenia zostały wysłane żadne wiersze.
Nie można wywołać polecenia SqlBulkCopy.Close (Close()) lub SqlConnection.Close (Close()) z tego zdarzenia. W ten sposób zostanie zgłoszony błąd InvalidOperationException , a SqlBulkCopy stan obiektu nie ulegnie zmianie. Jeśli użytkownik chce anulować operację ze zdarzenia, Abort można użyć właściwości obiektu SqlRowsCopiedEventArgs . (Zobacz Operacje transakcji i kopiowania zbiorczegoAbort, aby zapoznać się z przykładami korzystającymi z właściwości).
Żadna akcja, taka jak aktywność transakcji, jest obsługiwana w połączeniu podczas wykonywania operacji kopiowania zbiorczego i zaleca się, aby nie używać tego samego połączenia używanego podczas SqlRowsCopied zdarzenia. Można jednak otworzyć inne połączenie.