SqlBulkCopy.WriteToServerAsync Méthode
Définition
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.
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.TaskPublic Function WriteToServerAsync (reader As IDataReader, cancellationToken As CancellationToken) As TaskParamè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
Tâche représentant l’opération asynchrone.
Exceptions
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.
Retourné dans l’objet de tâche, toute erreur retournée par SQL Server qui s’est produite à l’ouverture de la connexion.
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).
S’applique à
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.TaskPublic Function WriteToServerAsync (reader As DbDataReader) As TaskParamètres
- reader
- DbDataReader
DbDataReader dont les lignes seront copiées dans la table de destination.
Retours
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).
S’applique à
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.TaskPublic Function WriteToServerAsync (rows As DataRow()) As TaskParamètres
Retours
Tâche représentant l’opération asynchrone.
Exceptions
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.
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[]).
S’applique à
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.TaskPublic Function WriteToServerAsync (table As DataTable) As TaskParamètres
Retours
Tâche représentant l’opération asynchrone.
Exceptions
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.
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).
S’applique à
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.TaskPublic Function WriteToServerAsync (reader As IDataReader) As TaskParamètres
- reader
- IDataReader
IDataReader dont les lignes seront copiées dans la table de destination.
Retours
Tâche représentant l’opération asynchrone.
Exceptions
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.
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).
S’applique à
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.TaskPublic Function WriteToServerAsync (reader As DbDataReader, cancellationToken As CancellationToken) As TaskParamè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
Retourne Task.
Exceptions
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).
S’applique à
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.TaskPublic Function WriteToServerAsync (rows As DataRow(), cancellationToken As CancellationToken) As TaskParamètres
- cancellationToken
- CancellationToken
Instruction d'annulation. Une valeur None dans ce paramètre rend cette méthode équivalente à WriteToServerAsync(DataTable).
Retours
Tâche représentant l’opération asynchrone.
Exceptions
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.
Retourné dans l’objet de tâche, toute erreur retournée par SQL Server qui s’est produite à l’ouverture de la connexion.
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[]).
S’applique à
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.TaskPublic Function WriteToServerAsync (table As DataTable, rowState As DataRowState) As TaskParamètres
- rowState
- DataRowState
Valeur d'énumération DataRowState. Seules les lignes qui correspondent à l'état de ligne sont copiées dans la destination.
Retours
Tâche représentant l’opération asynchrone.
Exceptions
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.
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).
S’applique à
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.TaskPublic Function WriteToServerAsync (table As DataTable, cancellationToken As CancellationToken) As TaskParamètres
- cancellationToken
- CancellationToken
Instruction d'annulation. Une valeur None dans ce paramètre rend cette méthode équivalente à WriteToServerAsync(DataTable).
Retours
Tâche représentant l’opération asynchrone.
Exceptions
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.
Retourné dans l’objet de tâche, toute erreur retournée par SQL Server qui s’est produite à l’ouverture de la connexion.
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).
S’applique à
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.TaskPublic Function WriteToServerAsync (table As DataTable, rowState As DataRowState, cancellationToken As CancellationToken) As TaskParamètres
- 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
Tâche représentant l’opération asynchrone.
Exceptions
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.
Retourné dans l’objet de tâche, toute erreur retournée par SQL Server qui s’est produite à l’ouverture de la connexion.
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).
