SqlConnection.GetSchemaAsync 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.
Surcharges
| Nom | Description |
|---|---|
| GetSchemaAsync(CancellationToken) |
Version asynchrone de , qui retourne des informations de GetSchema()schéma pour la source de données de ce SqlConnection. Pour plus d’informations sur les schémas, consultez SQL Server Collections de schémas. |
| GetSchemaAsync(String, CancellationToken) |
Version asynchrone de , qui retourne des informations de schéma pour la source de données de cette SqlConnection méthode à l’aide de GetSchema(String)la chaîne spécifiée pour le nom du schéma. |
| GetSchemaAsync(String, String[], CancellationToken) |
Version asynchrone de GetSchema(String, String[]), qui retourne des informations de schéma pour la source de données de cette SqlConnection méthode à l’aide de la chaîne spécifiée pour le nom du schéma et du tableau de chaînes spécifié pour les valeurs de restriction. |
GetSchemaAsync(CancellationToken)
Version asynchrone de , qui retourne des informations de GetSchema()schéma pour la source de données de ce SqlConnection. Pour plus d’informations sur les schémas, consultez SQL Server Collections de schémas.
public System.Threading.Tasks.Task<System.Data.DataTable> GetSchemaAsync(System.Threading.CancellationToken cancellationToken = default);public override System.Threading.Tasks.Task<System.Data.DataTable> GetSchemaAsync(System.Threading.CancellationToken cancellationToken = default);member this.GetSchemaAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.DataTable>override this.GetSchemaAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.DataTable>Public Function GetSchemaAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of DataTable)Public Overrides Function GetSchemaAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of DataTable)Paramètres
- cancellationToken
- CancellationToken
Jeton d’annulation.
Retours
Tâche représentant l’opération asynchrone.
Remarques
Pour plus d’informations sur la programmation asynchrone dans .NET Framework Fournisseur de données pour SQL Server, consultez Asynchronous Programming.
S’applique à
GetSchemaAsync(String, CancellationToken)
Version asynchrone de , qui retourne des informations de schéma pour la source de données de cette SqlConnection méthode à l’aide de GetSchema(String)la chaîne spécifiée pour le nom du schéma.
public System.Threading.Tasks.Task<System.Data.DataTable> GetSchemaAsync(string collectionName, System.Threading.CancellationToken cancellationToken = default);public override System.Threading.Tasks.Task<System.Data.DataTable> GetSchemaAsync(string collectionName, System.Threading.CancellationToken cancellationToken = default);member this.GetSchemaAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.DataTable>override this.GetSchemaAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.DataTable>Public Function GetSchemaAsync (collectionName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DataTable)Public Overrides Function GetSchemaAsync (collectionName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DataTable)Paramètres
- collectionName
- String
Spécifie le nom du schéma à retourner.
- cancellationToken
- CancellationToken
Jeton d’annulation.
Retours
Tâche représentant l’opération asynchrone.
Exceptions
collectionName est spécifié comme null.
Remarques
Pour plus d’informations sur la programmation asynchrone dans .NET Framework Fournisseur de données pour SQL Server, consultez Asynchronous Programming.
S’applique à
GetSchemaAsync(String, String[], CancellationToken)
Version asynchrone de GetSchema(String, String[]), qui retourne des informations de schéma pour la source de données de cette SqlConnection méthode à l’aide de la chaîne spécifiée pour le nom du schéma et du tableau de chaînes spécifié pour les valeurs de restriction.
public System.Threading.Tasks.Task<System.Data.DataTable> GetSchemaAsync(string collectionName, string[] restrictionValues, System.Threading.CancellationToken cancellationToken = default);public override System.Threading.Tasks.Task<System.Data.DataTable> GetSchemaAsync(string collectionName, string[] restrictionValues, System.Threading.CancellationToken cancellationToken = default);member this.GetSchemaAsync : string * string[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.DataTable>override this.GetSchemaAsync : string * string[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.DataTable>Public Function GetSchemaAsync (collectionName As String, restrictionValues As String(), Optional cancellationToken As CancellationToken = Nothing) As Task(Of DataTable)Public Overrides Function GetSchemaAsync (collectionName As String, restrictionValues As String(), Optional cancellationToken As CancellationToken = Nothing) As Task(Of DataTable)Paramètres
- collectionName
- String
Spécifie le nom du schéma à retourner.
- restrictionValues
- String[]
Ensemble de valeurs de restriction pour le schéma demandé.
- cancellationToken
- CancellationToken
Jeton d’annulation.
Retours
Tâche représentant l’opération asynchrone.
Exceptions
collectionName est spécifié comme null.
Remarques
Le restrictionValues paramètre peut fournir n profondeur de valeurs, qui sont spécifiées par la collection de restrictions pour une collection spécifique. Pour définir des valeurs sur une restriction donnée et ne pas définir les valeurs d’autres restrictions, vous devez définir les restrictions null précédentes, puis placer la valeur appropriée pour la restriction pour laquelle vous souhaitez spécifier une valeur.
Par exemple, il s’agit de la collection « Tables ». Si la collection « Tables » a trois restrictions : base de données, propriétaire et nom de table, et que vous souhaitez récupérer uniquement les tables associées au propriétaire « Carl », vous devez transmettre les valeurs suivantes : null, « Carl ». Si une valeur de restriction n’est pas passée, les valeurs par défaut sont utilisées pour cette restriction. Il s’agit du même mappage que le passage null, différent du passage d’une chaîne vide pour la valeur du paramètre. Dans ce cas, la chaîne vide (« ») est considérée comme la valeur du paramètre spécifié.