SqlBulkCopy.WriteToServerAsync Metodo

Definizione

Spazio dei nomi:

System.Data.SqlClient

Assembly:

System.Data.dll

Versione asincrona di WriteToServer, che copia tutte le righe da un'origine dati in una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.

Overload

WriteToServerAsync(IDataReader, CancellationToken)	Versione asincrona di WriteToServer(IDataReader) che copia tutte le righe nella matrice IDataReader fornita a una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy. Il token di annullamento può essere utilizzato per richiedere che l'operazione venga abbandonata prima del timeout del comando. Le eccezioni verranno segnalate tramite l'oggetto attività restituito.
WriteToServerAsync(DbDataReader)	Versione asincrona di WriteToServer(DbDataReader), che copia tutte le righe dalla matrice DbDataReader fornita in una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.
WriteToServerAsync(DataRow[])	Versione asincrona di WriteToServer(DataRow[]), che copia tutte le righe dalla matrice DataRow fornita in una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.
WriteToServerAsync(DataTable)	Versione asincrona di WriteToServer(DataTable) che copia tutte le righe nella matrice DataTable fornita a una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.
WriteToServerAsync(IDataReader)	Versione asincrona di WriteToServer(IDataReader) che copia tutte le righe nella matrice IDataReader fornita a una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.
WriteToServerAsync(DbDataReader, CancellationToken)	Versione asincrona di WriteToServer(DbDataReader), che copia tutte le righe dalla matrice DbDataReader fornita in una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.
WriteToServerAsync(DataRow[], CancellationToken)	Versione asincrona di WriteToServer(DataRow[]), che copia tutte le righe dalla matrice DataRow fornita in una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy. Il token di annullamento può essere utilizzato per richiedere che l'operazione venga abbandonata prima del timeout del comando. Le eccezioni verranno segnalate tramite l'oggetto attività restituito.
WriteToServerAsync(DataTable, DataRowState)	La versione asincrona di WriteToServer(DataTable, DataRowState), che copia solo le righe corrispondenti allo stato di riga fornito nell'oggetto DataTable fornito in una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.
WriteToServerAsync(DataTable, CancellationToken)	Versione asincrona di WriteToServer(DataTable) che copia tutte le righe nella matrice DataTable fornita a una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy. Il token di annullamento può essere utilizzato per richiedere che l'operazione venga abbandonata prima del timeout del comando. Le eccezioni verranno segnalate tramite l'oggetto attività restituito.
WriteToServerAsync(DataTable, DataRowState, CancellationToken)	La versione asincrona di WriteToServer(DataTable, DataRowState), che copia solo le righe corrispondenti allo stato di riga fornito nell'oggetto DataTable fornito in una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy. Il token di annullamento può essere utilizzato per richiedere che l'operazione venga abbandonata prima del timeout del comando. Le eccezioni verranno segnalate tramite l'oggetto attività restituito.

Commenti

Se più set di risultati attivi (MARS) è disabilitato, WriteToServer rende la connessione occupata. Se MARS è abilitato, è possibile interleave le chiamate a WriteToServer con altri comandi nella stessa connessione.

Il numero di righe di cui viene eseguito il rollback quando si verifica un errore dipende da diversi aspetti:

• Se UseInternalTransaction è specificato.

• Se si dispone di una transazione personalizzata.

• Valore di BatchSize.

Quando si verifica un errore durante l'invio di dati al server, verrà eseguito il rollback del batch corrente (come specificato da BatchSize). Se UseInternalTransaction non viene specificato e si dispone di una transazione personalizzata, verrà eseguito il rollback dell'intera transazione , che include anche tutti i batch precedenti.

Usare SqlRowsCopied per sapere quante righe sono state copiate nel server.

WriteToServerAsync(IDataReader, CancellationToken)

Versione asincrona di WriteToServer(IDataReader) che copia tutte le righe nella matrice IDataReader fornita a una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.

Il token di annullamento può essere utilizzato per richiedere che l'operazione venga abbandonata prima del timeout del comando. Le eccezioni verranno segnalate tramite l'oggetto attività restituito.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::IDataReader ^ reader, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.IDataReader reader, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.IDataReader * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (reader As IDataReader, cancellationToken As CancellationToken) As Task

Parametri

reader

IDataReader

Oggetto IDataReader le cui righe vengono copiate nella tabella di destinazione.

cancellationToken

CancellationToken

L'istruzione di annullamento. Il valore None in questo parametro rende il metodo equivalente a WriteToServerAsync(DataTable).

Restituisce

Task

Attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

WriteToServerAsync(IDataReader) viene chiamato più volte per la stessa istanza prima del completamento dell'attività.

Chiamare WriteToServerAsync(IDataReader) e WriteToServer(IDataReader) per la stessa istanza prima del completamento dell'attività.

La connessione viene eliminata o chiusa durante l'esecuzione di WriteToServerAsync(IDataReader).

Restituito nell'oggetto attività, l'oggetto SqlBulkCopy è stato chiuso durante l'esecuzione del metodo.

Restituito nell'oggetto attività, si è verificato un timeout del pool di connessioni.

Restituito nell'oggetto attività, l'oggetto SqlConnection viene chiuso prima dell'esecuzione del metodo.

L'oggetto IDataReader è stato chiuso prima della restituzione dell'oggetto Task completato.

La connessione associata dell'oggetto IDataReader è stata chiusa prima che sia stato restituito l'oggetto Task completato.

Context Connection=true è specificato nella stringa di connessione.

SqlException

Restituito nell'oggetto attività, qualsiasi errore restituito da SQL Server che si è verificato durante l'apertura della connessione.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Per altre informazioni sulla programmazione asincrona nel provider di dati .NET Framework per SQL Server, vedere Programmazione asincrona.

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da WriteToServer(IDataReader).

WriteToServerAsync(DbDataReader)

Versione asincrona di WriteToServer(DbDataReader), che copia tutte le righe dalla matrice DbDataReader fornita in una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::Common::DbDataReader ^ reader);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.Common.DbDataReader reader);

member this.WriteToServerAsync : System.Data.Common.DbDataReader -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (reader As DbDataReader) As Task

Parametri

reader

DbDataReader

Oggetto DbDataReader le cui righe vengono copiate nella tabella di destinazione.

Restituisce

Task

Attività che rappresenta l'operazione asincrona.

Commenti

Per altre informazioni sulla programmazione asincrona nel provider di dati .NET Framework per SQL Server, vedere Programmazione asincrona.

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da WriteToServer(DbDataReader).

WriteToServerAsync(DataRow[])

Versione asincrona di WriteToServer(DataRow[]), che copia tutte le righe dalla matrice DataRow fornita in una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(cli::array <System::Data::DataRow ^> ^ rows);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataRow[] rows);

member this.WriteToServerAsync : System.Data.DataRow[] -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (rows As DataRow()) As Task

Parametri

rows

DataRow[]

Matrice di oggetti DataRow che verranno copiati nella tabella di destinazione.

Restituisce

Task

Attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

WriteToServerAsync(DataRow[]) viene chiamato più volte per la stessa istanza prima del completamento dell'attività.

Chiamare WriteToServerAsync(DataRow[]) e WriteToServer(DataRow[]) per la stessa istanza prima del completamento dell'attività.

La connessione viene eliminata o chiusa durante l'esecuzione di WriteToServerAsync(DataRow[]).

Restituito nell'oggetto attività, l'oggetto SqlBulkCopy è stato chiuso durante l'esecuzione del metodo.

Restituito nell'oggetto attività, si è verificato un timeout del pool di connessioni.

Restituito nell'oggetto attività, l'oggetto SqlConnection viene chiuso prima dell'esecuzione del metodo.

Context Connection=true è specificato nella stringa di connessione.

SqlException

Restituito nell'oggetto attività, qualsiasi errore restituito da SQL Server che si è verificato durante l'apertura della connessione.

Commenti

Per altre informazioni sulla programmazione asincrona nel provider di dati .NET Framework per SQL Server, vedere Programmazione asincrona.

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da WriteToServer(DataRow[]).

WriteToServerAsync(DataTable)

Versione asincrona di WriteToServer(DataTable) che copia tutte le righe nella matrice DataTable fornita a una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataTable table);

member this.WriteToServerAsync : System.Data.DataTable -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (table As DataTable) As Task

Parametri

table

DataTable

Oggetto DataTable le cui righe vengono copiate nella tabella di destinazione.

Restituisce

Task

Attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

WriteToServerAsync(DataTable) viene chiamato più volte per la stessa istanza prima del completamento dell'attività.

Chiamare WriteToServerAsync(DataTable) e WriteToServer(DataTable) per la stessa istanza prima del completamento dell'attività.

La connessione viene eliminata o chiusa durante l'esecuzione di WriteToServerAsync(DataTable).

Restituito nell'oggetto attività, l'oggetto SqlBulkCopy è stato chiuso durante l'esecuzione del metodo.

Restituito nell'oggetto attività, si è verificato un timeout del pool di connessioni.

Restituito nell'oggetto attività, l'oggetto SqlConnection viene chiuso prima dell'esecuzione del metodo.

Context Connection=true è specificato nella stringa di connessione.

SqlException

Restituito nell'oggetto attività, qualsiasi errore restituito da SQL Server che si è verificato durante l'apertura della connessione.

Commenti

Per altre informazioni sulla programmazione asincrona nel provider di dati .NET Framework per SQL Server, vedere Programmazione asincrona.

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da WriteToServer(DataTable).

WriteToServerAsync(IDataReader)

Versione asincrona di WriteToServer(IDataReader) che copia tutte le righe nella matrice IDataReader fornita a una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::IDataReader ^ reader);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.IDataReader reader);

member this.WriteToServerAsync : System.Data.IDataReader -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (reader As IDataReader) As Task

Parametri

reader

IDataReader

Oggetto IDataReader le cui righe vengono copiate nella tabella di destinazione.

Restituisce

Task

Attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

WriteToServerAsync(IDataReader) viene chiamato più volte per la stessa istanza prima del completamento dell'attività.

Chiamare WriteToServerAsync(IDataReader) e WriteToServer(IDataReader) per la stessa istanza prima del completamento dell'attività.

La connessione viene eliminata o chiusa durante l'esecuzione di WriteToServerAsync(IDataReader).

Restituito nell'oggetto attività, l'oggetto SqlBulkCopy è stato chiuso durante l'esecuzione del metodo.

Restituito nell'oggetto attività, si è verificato un timeout del pool di connessioni.

Restituito nell'oggetto attività, l'oggetto SqlConnection viene chiuso prima dell'esecuzione del metodo.

L'oggetto IDataReader è stato chiuso prima della restituzione dell'oggetto Task completato.

La connessione associata dell'oggetto IDataReader è stata chiusa prima che sia stato restituito l'oggetto Task completato.

Context Connection=true è specificato nella stringa di connessione.

SqlException

Restituito nell'oggetto attività, qualsiasi errore restituito da SQL Server che si è verificato durante l'apertura della connessione.

Commenti

Per altre informazioni sulla programmazione asincrona nel provider di dati .NET Framework per SQL Server, vedere Programmazione asincrona.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da WriteToServer(IDataReader).

WriteToServerAsync(DbDataReader, CancellationToken)

Versione asincrona di WriteToServer(DbDataReader), che copia tutte le righe dalla matrice DbDataReader fornita in una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::Common::DbDataReader ^ reader, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.Common.DbDataReader reader, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.Common.DbDataReader * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (reader As DbDataReader, cancellationToken As CancellationToken) As Task

Parametri

reader

DbDataReader

Oggetto DbDataReader le cui righe vengono copiate nella tabella di destinazione.

cancellationToken

CancellationToken

L'istruzione di annullamento. Il valore None in questo parametro rende il metodo equivalente a WriteToServerAsync(DbDataReader).

Restituisce

Task

Restituisce Task.

Eccezioni

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da WriteToServer(DbDataReader).

WriteToServerAsync(DataRow[], CancellationToken)

Versione asincrona di WriteToServer(DataRow[]), che copia tutte le righe dalla matrice DataRow fornita in una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.

Il token di annullamento può essere utilizzato per richiedere che l'operazione venga abbandonata prima del timeout del comando. Le eccezioni verranno segnalate tramite l'oggetto attività restituito.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(cli::array <System::Data::DataRow ^> ^ rows, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataRow[] rows, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.DataRow[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (rows As DataRow(), cancellationToken As CancellationToken) As Task

Parametri

rows

DataRow[]

Matrice di oggetti DataRow che verranno copiati nella tabella di destinazione.

cancellationToken

CancellationToken

L'istruzione di annullamento. Il valore None in questo parametro rende il metodo equivalente a WriteToServerAsync(DataTable).

Restituisce

Task

Attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

WriteToServerAsync(DataRow[]) viene chiamato più volte per la stessa istanza prima del completamento dell'attività.

Chiamare WriteToServerAsync(DataRow[]) e WriteToServer(DataRow[]) per la stessa istanza prima del completamento dell'attività.

La connessione viene eliminata o chiusa durante l'esecuzione di WriteToServerAsync(DataRow[]).

Restituito nell'oggetto attività, l'oggetto SqlBulkCopy è stato chiuso durante l'esecuzione del metodo.

Restituito nell'oggetto attività, si è verificato un timeout del pool di connessioni.

Restituito nell'oggetto attività, l'oggetto SqlConnection viene chiuso prima dell'esecuzione del metodo.

Context Connection=true è specificato nella stringa di connessione.

SqlException

Restituito nell'oggetto attività, qualsiasi errore restituito da SQL Server che si è verificato durante l'apertura della connessione.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Per altre informazioni sulla programmazione asincrona nel provider di dati .NET Framework per SQL Server, vedere Programmazione asincrona.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da WriteToServer(DataRow[]).

WriteToServerAsync(DataTable, DataRowState)

La versione asincrona di WriteToServer(DataTable, DataRowState), che copia solo le righe corrispondenti allo stato di riga fornito nell'oggetto DataTable fornito in una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table, System::Data::DataRowState rowState);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataTable table, System.Data.DataRowState rowState);

member this.WriteToServerAsync : System.Data.DataTable * System.Data.DataRowState -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (table As DataTable, rowState As DataRowState) As Task

Parametri

table

DataTable

Oggetto DataTable le cui righe vengono copiate nella tabella di destinazione.

rowState

DataRowState

Valore ottenuto dall'enumerazione DataRowState. Nella destinazione vengono copiate solo le righe che corrispondono allo stato della riga fornito.

Restituisce

Task

Attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

WriteToServerAsync(DataTable, DataRowState) viene chiamato più volte per la stessa istanza prima del completamento dell'attività.

Chiamare WriteToServerAsync(DataTable, DataRowState) e WriteToServer(DataTable, DataRowState) per la stessa istanza prima del completamento dell'attività.

La connessione viene eliminata o chiusa durante l'esecuzione di WriteToServerAsync(DataTable, DataRowState).

Restituito nell'oggetto attività, l'oggetto SqlBulkCopy è stato chiuso durante l'esecuzione del metodo.

Restituito nell'oggetto attività, si è verificato un timeout del pool di connessioni.

Restituito nell'oggetto attività, l'oggetto SqlConnection viene chiuso prima dell'esecuzione del metodo.

Context Connection=true è specificato nella stringa di connessione.

SqlException

Restituito nell'oggetto attività, qualsiasi errore restituito da SQL Server che si è verificato durante l'apertura della connessione.

Commenti

Per altre informazioni sulla programmazione asincrona nel provider di dati .NET Framework per SQL Server, vedere Programmazione asincrona.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da WriteToServer(DataTable, DataRowState).

WriteToServerAsync(DataTable, CancellationToken)

Versione asincrona di WriteToServer(DataTable) che copia tutte le righe nella matrice DataTable fornita a una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.

Il token di annullamento può essere utilizzato per richiedere che l'operazione venga abbandonata prima del timeout del comando. Le eccezioni verranno segnalate tramite l'oggetto attività restituito.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataTable table, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.DataTable * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (table As DataTable, cancellationToken As CancellationToken) As Task

Parametri

table

DataTable

Oggetto DataTable le cui righe vengono copiate nella tabella di destinazione.

cancellationToken

CancellationToken

L'istruzione di annullamento. Il valore None in questo parametro rende il metodo equivalente a WriteToServerAsync(DataTable).

Restituisce

Task

Attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

WriteToServerAsync(DataTable) viene chiamato più volte per la stessa istanza prima del completamento dell'attività.

Chiamare WriteToServerAsync(DataTable) e WriteToServer(DataTable) per la stessa istanza prima del completamento dell'attività.

La connessione viene eliminata o chiusa durante l'esecuzione di WriteToServerAsync(DataTable).

Restituito nell'oggetto attività, l'oggetto SqlBulkCopy è stato chiuso durante l'esecuzione del metodo.

Restituito nell'oggetto attività, si è verificato un timeout del pool di connessioni.

Restituito nell'oggetto attività, l'oggetto SqlConnection viene chiuso prima dell'esecuzione del metodo.

Context Connection=true è specificato nella stringa di connessione.

SqlException

Restituito nell'oggetto attività, qualsiasi errore restituito da SQL Server che si è verificato durante l'apertura della connessione.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Per altre informazioni sulla programmazione asincrona nel provider di dati .NET Framework per SQL Server, vedere Programmazione asincrona.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da WriteToServer(DataTable).

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

La versione asincrona di WriteToServer(DataTable, DataRowState), che copia solo le righe corrispondenti allo stato di riga fornito nell'oggetto DataTable fornito in una tabella di destinazione specificata dalla proprietà DestinationTableName dell'oggetto SqlBulkCopy.

Il token di annullamento può essere utilizzato per richiedere che l'operazione venga abbandonata prima del timeout del comando. Le eccezioni verranno segnalate tramite l'oggetto attività restituito.

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table, System::Data::DataRowState rowState, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataTable table, System.Data.DataRowState rowState, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.DataTable * System.Data.DataRowState * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (table As DataTable, rowState As DataRowState, cancellationToken As CancellationToken) As Task

Parametri

table

DataTable

Oggetto DataTable le cui righe vengono copiate nella tabella di destinazione.

rowState

DataRowState

Valore ottenuto dall'enumerazione DataRowState. Nella destinazione vengono copiate solo le righe che corrispondono allo stato della riga fornito.

cancellationToken

CancellationToken

L'istruzione di annullamento. Il valore None in questo parametro rende il metodo equivalente a WriteToServerAsync(DataTable).

Restituisce

Task

Attività che rappresenta l'operazione asincrona.

Eccezioni

InvalidOperationException

WriteToServerAsync(DataTable, DataRowState) viene chiamato più volte per la stessa istanza prima del completamento dell'attività.

Chiamare WriteToServerAsync(DataTable, DataRowState) e WriteToServer(DataTable, DataRowState) per la stessa istanza prima del completamento dell'attività.

La connessione viene eliminata o chiusa durante l'esecuzione di WriteToServerAsync(DataTable, DataRowState).

Restituito nell'oggetto attività, l'oggetto SqlBulkCopy è stato chiuso durante l'esecuzione del metodo.

Restituito nell'oggetto attività, si è verificato un timeout del pool di connessioni.

Restituito nell'oggetto attività, l'oggetto SqlConnection viene chiuso prima dell'esecuzione del metodo.

Context Connection=true è specificato nella stringa di connessione.

SqlException

Restituito nell'oggetto attività, qualsiasi errore restituito da SQL Server che si è verificato durante l'apertura della connessione.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Per altre informazioni sulla programmazione asincrona nel provider di dati .NET Framework per SQL Server, vedere Programmazione asincrona.

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da WriteToServer(DataTable, DataRowState).