SqlBulkCopy.WriteToServerAsync Méthode

Définition

Espace de noms:

System.Data.SqlClient

Assembly:

System.Data.dll

Version asynchrone de WriteToServer, qui copie toutes les lignes depuis une source de données vers une table de destination spécifiée par la propriété DestinationTableName de l’objet SqlBulkCopy.

Surcharges

WriteToServerAsync(IDataReader, CancellationToken)	Version asynchrone de WriteToServer(IDataReader), qui copie toutes les lignes dans le tableau IDataReader dans une table de destination spécifiée par la propriété DestinationTableName de l'objet SqlBulkCopy. Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l’objet Task retourné.
WriteToServerAsync(DbDataReader)	Version asynchrone de WriteToServer(DbDataReader), qui copie toutes les lignes du tableau DbDataReader fourni dans une table de destination spécifiée par la propriété DestinationTableName de l’objet SqlBulkCopy.
WriteToServerAsync(DataRow[])	Version asynchrone de WriteToServer(DataRow[]), qui copie toutes les lignes du tableau DataRow fourni dans une table de destination spécifiée par la propriété DestinationTableName de l’objet SqlBulkCopy.
WriteToServerAsync(DataTable)	Version asynchrone de WriteToServer(DataTable), qui copie toutes les lignes dans le tableau DataTable dans une table de destination spécifiée par la propriété DestinationTableName de l'objet SqlBulkCopy.
WriteToServerAsync(IDataReader)	Version asynchrone de WriteToServer(IDataReader), qui copie toutes les lignes dans le tableau IDataReader dans une table de destination spécifiée par la propriété DestinationTableName de l'objet SqlBulkCopy.
WriteToServerAsync(DbDataReader, CancellationToken)	Version asynchrone de WriteToServer(DbDataReader), qui copie toutes les lignes du tableau DbDataReader fourni dans une table de destination spécifiée par la propriété DestinationTableName de l’objet SqlBulkCopy.
WriteToServerAsync(DataRow[], CancellationToken)	Version asynchrone de WriteToServer(DataRow[]), qui copie toutes les lignes du tableau DataRow fourni dans une table de destination spécifiée par la propriété DestinationTableName de l’objet SqlBulkCopy. Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l’objet Task retourné.
WriteToServerAsync(DataTable, DataRowState)	Version asynchrone de WriteToServer(DataTable, DataRowState), qui copie uniquement les lignes qui correspondent à l’état de ligne fourni dans le DataTable fourni, dans une table de destination spécifiée par la propriété DestinationTableName de l’objet SqlBulkCopy.
WriteToServerAsync(DataTable, CancellationToken)	Version asynchrone de WriteToServer(DataTable), qui copie toutes les lignes dans le tableau DataTable dans une table de destination spécifiée par la propriété DestinationTableName de l'objet SqlBulkCopy. Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l’objet Task retourné.
WriteToServerAsync(DataTable, DataRowState, CancellationToken)	Version asynchrone de WriteToServer(DataTable, DataRowState), qui copie uniquement les lignes qui correspondent à l’état de ligne fourni dans le DataTable fourni, dans une table de destination spécifiée par la propriété DestinationTableName de l’objet SqlBulkCopy. Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l’objet Task retourné.

Remarques

Si mars (Multiple Active Result Sets) est désactivé, WriteToServer la connexion est occupée. Si MARS est activé, vous pouvez entrelacer les appels à WriteToServer avec d’autres commandes dans la même connexion.

Le nombre de lignes restaurées en cas d’échec dépend de plusieurs éléments :

• Si UseInternalTransaction est spécifié.

• Si vous avez votre propre transaction.

• la valeur de la propriété BatchSize ;

En cas d’erreur lors de l’envoi de données au serveur, le lot actuel (comme spécifié par BatchSize) est restauré. Si UseInternalTransaction n’est pas spécifié et que vous avez votre propre transaction, l’intégralité de la transaction est restaurée (ce qui inclut également tous les lots précédents).

Utilisez SqlRowsCopied pour savoir combien de lignes ont été copiées sur le serveur.

WriteToServerAsync(IDataReader, CancellationToken)

Version asynchrone de WriteToServer(IDataReader), qui copie toutes les lignes dans le tableau IDataReader dans une table de destination spécifiée par la propriété DestinationTableName de l'objet SqlBulkCopy.

Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l’objet Task retourné.

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

Paramètres

reader

IDataReader

IDataReader dont les lignes seront copiées dans la table de destination.

cancellationToken

CancellationToken

Instruction d'annulation. Une valeur None dans ce paramètre rend cette méthode équivalente à WriteToServerAsync(DataTable).

Retours

Task

Tâche représentant l’opération asynchrone.

Exceptions

InvalidOperationException

Appels multiples de WriteToServerAsync(IDataReader) pour la même instance avant la fin de la tâche.

Appel de WriteToServerAsync(IDataReader) et WriteToServer(IDataReader) pour la même instance avant l'achèvement de la tâche.

La connexion est perdue ou fermée pendant l'exécution de WriteToServerAsync(IDataReader) .

Retourné dans l'objet de tâche, l'objet SqlBulkCopy a été fermé au cours de l'exécution de méthode.

Retourné dans l'objet de tâche, il existe un délai d'attente du pool de connexions.

Retourné dans l'objet de tâche, l'objet SqlConnection est fermé avant l'exécution de méthode.

IDataReader a été fermé avant le retour du Task terminé.

La connexion associée à IDataReader a été fermée avant le retour du Task terminé.

Context Connection=true est spécifié dans la chaîne de connexion.

SqlException

Retourné dans l’objet de tâche, toute erreur retournée par SQL Server qui s’est produite à l’ouverture de la connexion.

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par WriteToServer(IDataReader).

WriteToServerAsync(DbDataReader)

Version asynchrone de WriteToServer(DbDataReader), qui copie toutes les lignes du tableau DbDataReader fourni dans une table de destination spécifiée par la propriété DestinationTableName de l’objet 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

Paramètres

reader

DbDataReader

DbDataReader dont les lignes seront copiées dans la table de destination.

Retours

Task

Tâche représentant l’opération asynchrone.

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par WriteToServer(DbDataReader).

WriteToServerAsync(DataRow[])

Version asynchrone de WriteToServer(DataRow[]), qui copie toutes les lignes du tableau DataRow fourni dans une table de destination spécifiée par la propriété DestinationTableName de l’objet 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

Paramètres

rows

DataRow[]

Tableau d'objets DataRow qui seront copiés dans la table de destination.

Retours

Task

Tâche représentant l’opération asynchrone.

Exceptions

InvalidOperationException

Appels multiples de WriteToServerAsync(DataRow[]) pour la même instance avant la fin de la tâche.

Appel de WriteToServerAsync(DataRow[]) et WriteToServer(DataRow[]) pour la même instance avant l'achèvement de la tâche.

La connexion est perdue ou fermée pendant l'exécution de WriteToServerAsync(DataRow[]) .

Retourné dans l'objet de tâche, l'objet SqlBulkCopy a été fermé au cours de l'exécution de méthode.

Retourné dans l'objet de tâche, il existe un délai d'attente du pool de connexions.

Retourné dans l'objet de tâche, l'objet SqlConnection est fermé avant l'exécution de méthode.

Context Connection=true est spécifié dans la chaîne de connexion.

SqlException

Retourné dans l’objet de tâche, toute erreur retournée par SQL Server qui s’est produite à l’ouverture de la connexion.

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par WriteToServer(DataRow[]).

WriteToServerAsync(DataTable)

Version asynchrone de WriteToServer(DataTable), qui copie toutes les lignes dans le tableau DataTable dans une table de destination spécifiée par la propriété DestinationTableName de l'objet 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

Paramètres

table

DataTable

DataTable dont les lignes seront copiées dans la table de destination.

Retours

Task

Tâche représentant l’opération asynchrone.

Exceptions

InvalidOperationException

Appels multiples de WriteToServerAsync(DataTable) pour la même instance avant la fin de la tâche.

Appel de WriteToServerAsync(DataTable) et WriteToServer(DataTable) pour la même instance avant l'achèvement de la tâche.

La connexion est perdue ou fermée pendant l'exécution de WriteToServerAsync(DataTable) .

Retourné dans l'objet de tâche, l'objet SqlBulkCopy a été fermé au cours de l'exécution de méthode.

Retourné dans l'objet de tâche, il existe un délai d'attente du pool de connexions.

Retourné dans l'objet de tâche, l'objet SqlConnection est fermé avant l'exécution de méthode.

Context Connection=true est spécifié dans la chaîne de connexion.

SqlException

Retourné dans l’objet de tâche, toute erreur retournée par SQL Server qui s’est produite à l’ouverture de la connexion.

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par WriteToServer(DataTable).

WriteToServerAsync(IDataReader)

Version asynchrone de WriteToServer(IDataReader), qui copie toutes les lignes dans le tableau IDataReader dans une table de destination spécifiée par la propriété DestinationTableName de l'objet 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

Paramètres

reader

IDataReader

IDataReader dont les lignes seront copiées dans la table de destination.

Retours

Task

Tâche représentant l’opération asynchrone.

Exceptions

InvalidOperationException

Appels multiples de WriteToServerAsync(IDataReader) pour la même instance avant la fin de la tâche.

Appel de WriteToServerAsync(IDataReader) et WriteToServer(IDataReader) pour la même instance avant l'achèvement de la tâche.

La connexion est perdue ou fermée pendant l'exécution de WriteToServerAsync(IDataReader) .

Retourné dans l'objet de tâche, l'objet SqlBulkCopy a été fermé au cours de l'exécution de méthode.

Retourné dans l'objet de tâche, il existe un délai d'attente du pool de connexions.

Retourné dans l'objet de tâche, l'objet SqlConnection est fermé avant l'exécution de méthode.

IDataReader a été fermé avant le retour du Task terminé.

La connexion associée à IDataReader a été fermée avant le retour du Task terminé.

Context Connection=true est spécifié dans la chaîne de connexion.

SqlException

Retourné dans l’objet de tâche, toute erreur retournée par SQL Server qui s’est produite à l’ouverture de la connexion.

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par WriteToServer(IDataReader).

WriteToServerAsync(DbDataReader, CancellationToken)

Version asynchrone de WriteToServer(DbDataReader), qui copie toutes les lignes du tableau DbDataReader fourni dans une table de destination spécifiée par la propriété DestinationTableName de l’objet 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

Paramètres

reader

DbDataReader

DbDataReader dont les lignes seront copiées dans la table de destination.

cancellationToken

CancellationToken

Instruction d'annulation. Une valeur None dans ce paramètre rend cette méthode équivalente à WriteToServerAsync(DbDataReader).

Retours

Task

Retourne Task.

Exceptions

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par WriteToServer(DbDataReader).

WriteToServerAsync(DataRow[], CancellationToken)

Version asynchrone de WriteToServer(DataRow[]), qui copie toutes les lignes du tableau DataRow fourni dans une table de destination spécifiée par la propriété DestinationTableName de l’objet SqlBulkCopy.

Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l’objet Task retourné.

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

Paramètres

rows

DataRow[]

Tableau d'objets DataRow qui seront copiés dans la table de destination.

cancellationToken

CancellationToken

Instruction d'annulation. Une valeur None dans ce paramètre rend cette méthode équivalente à WriteToServerAsync(DataTable).

Retours

Task

Tâche représentant l’opération asynchrone.

Exceptions

InvalidOperationException

Appels multiples de WriteToServerAsync(DataRow[]) pour la même instance avant la fin de la tâche.

Appel de WriteToServerAsync(DataRow[]) et WriteToServer(DataRow[]) pour la même instance avant l'achèvement de la tâche.

La connexion est perdue ou fermée pendant l'exécution de WriteToServerAsync(DataRow[]) .

Retourné dans l'objet de tâche, l'objet SqlBulkCopy a été fermé au cours de l'exécution de méthode.

Retourné dans l'objet de tâche, il existe un délai d'attente du pool de connexions.

Retourné dans l'objet de tâche, l'objet SqlConnection est fermé avant l'exécution de méthode.

Context Connection=true est spécifié dans la chaîne de connexion.

SqlException

Retourné dans l’objet de tâche, toute erreur retournée par SQL Server qui s’est produite à l’ouverture de la connexion.

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par WriteToServer(DataRow[]).

WriteToServerAsync(DataTable, DataRowState)

Version asynchrone de WriteToServer(DataTable, DataRowState), qui copie uniquement les lignes qui correspondent à l’état de ligne fourni dans le DataTable fourni, dans une table de destination spécifiée par la propriété DestinationTableName de l’objet 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

Paramètres

table

DataTable

DataTable dont les lignes seront copiées dans la table de destination.

rowState

DataRowState

Valeur d'énumération DataRowState. Seules les lignes qui correspondent à l'état de ligne sont copiées dans la destination.

Retours

Task

Tâche représentant l’opération asynchrone.

Exceptions

InvalidOperationException

Appels multiples de WriteToServerAsync(DataTable, DataRowState) pour la même instance avant la fin de la tâche.

Appel de WriteToServerAsync(DataTable, DataRowState) et WriteToServer(DataTable, DataRowState) pour la même instance avant l'achèvement de la tâche.

La connexion est perdue ou fermée pendant l'exécution de WriteToServerAsync(DataTable, DataRowState) .

Retourné dans l'objet de tâche, l'objet SqlBulkCopy a été fermé au cours de l'exécution de méthode.

Retourné dans l'objet de tâche, il existe un délai d'attente du pool de connexions.

Retourné dans l'objet de tâche, l'objet SqlConnection est fermé avant l'exécution de méthode.

Context Connection=true est spécifié dans la chaîne de connexion.

SqlException

Retourné dans l’objet de tâche, toute erreur retournée par SQL Server qui s’est produite à l’ouverture de la connexion.

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par WriteToServer(DataTable, DataRowState).

WriteToServerAsync(DataTable, CancellationToken)

Version asynchrone de WriteToServer(DataTable), qui copie toutes les lignes dans le tableau DataTable dans une table de destination spécifiée par la propriété DestinationTableName de l'objet SqlBulkCopy.

Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l’objet Task retourné.

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

Paramètres

table

DataTable

DataTable dont les lignes seront copiées dans la table de destination.

cancellationToken

CancellationToken

Instruction d'annulation. Une valeur None dans ce paramètre rend cette méthode équivalente à WriteToServerAsync(DataTable).

Retours

Task

Tâche représentant l’opération asynchrone.

Exceptions

InvalidOperationException

Appels multiples de WriteToServerAsync(DataTable) pour la même instance avant la fin de la tâche.

Appel de WriteToServerAsync(DataTable) et WriteToServer(DataTable) pour la même instance avant l'achèvement de la tâche.

La connexion est perdue ou fermée pendant l'exécution de WriteToServerAsync(DataTable) .

Retourné dans l'objet de tâche, l'objet SqlBulkCopy a été fermé au cours de l'exécution de méthode.

Retourné dans l'objet de tâche, il existe un délai d'attente du pool de connexions.

Retourné dans l'objet de tâche, l'objet SqlConnection est fermé avant l'exécution de méthode.

Context Connection=true est spécifié dans la chaîne de connexion.

SqlException

Retourné dans l’objet de tâche, toute erreur retournée par SQL Server qui s’est produite à l’ouverture de la connexion.

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par WriteToServer(DataTable).

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

Version asynchrone de WriteToServer(DataTable, DataRowState), qui copie uniquement les lignes qui correspondent à l’état de ligne fourni dans le DataTable fourni, dans une table de destination spécifiée par la propriété DestinationTableName de l’objet SqlBulkCopy.

Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l’objet Task retourné.

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

Paramètres

table

DataTable

DataTable dont les lignes seront copiées dans la table de destination.

rowState

DataRowState

Valeur d'énumération DataRowState. Seules les lignes qui correspondent à l'état de ligne sont copiées dans la destination.

cancellationToken

CancellationToken

Instruction d'annulation. Une valeur None dans ce paramètre rend cette méthode équivalente à WriteToServerAsync(DataTable).

Retours

Task

Tâche représentant l’opération asynchrone.

Exceptions

InvalidOperationException

Appels multiples de WriteToServerAsync(DataTable, DataRowState) pour la même instance avant la fin de la tâche.

Appel de WriteToServerAsync(DataTable, DataRowState) et WriteToServer(DataTable, DataRowState) pour la même instance avant l'achèvement de la tâche.

La connexion est perdue ou fermée pendant l'exécution de WriteToServerAsync(DataTable, DataRowState) .

Retourné dans l'objet de tâche, l'objet SqlBulkCopy a été fermé au cours de l'exécution de méthode.

Retourné dans l'objet de tâche, il existe un délai d'attente du pool de connexions.

Retourné dans l'objet de tâche, l'objet SqlConnection est fermé avant l'exécution de méthode.

Context Connection=true est spécifié dans la chaîne de connexion.

SqlException

Retourné dans l’objet de tâche, toute erreur retournée par SQL Server qui s’est produite à l’ouverture de la connexion.

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par WriteToServer(DataTable, DataRowState).