SqlConnection.GetSchemaAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Name | Beschreibung |
|---|---|
| GetSchemaAsync(CancellationToken) |
Eine asynchrone Version von GetSchema(), die Schemainformationen für die Datenquelle dieses SqlConnection. Weitere Informationen zu Schemas finden Sie unter SQL Server Schemasammlungen. |
| GetSchemaAsync(String, CancellationToken) |
Eine asynchrone Version von GetSchema(String), die Schemainformationen für die Datenquelle dieser SqlConnection mit der angegebenen Zeichenfolge für den Schemanamen zurückgibt. |
| GetSchemaAsync(String, String[], CancellationToken) |
Eine asynchrone Version von GetSchema(String, String[]), die Schemainformationen für die Datenquelle dieser SqlConnection zurückgibt, wobei die angegebene Zeichenfolge für den Schemanamen und das angegebene Zeichenfolgenarray für die Einschränkungswerte verwendet wird. |
GetSchemaAsync(CancellationToken)
Eine asynchrone Version von GetSchema(), die Schemainformationen für die Datenquelle dieses SqlConnection. Weitere Informationen zu Schemas finden Sie unter SQL Server Schemasammlungen.
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)Parameter
- cancellationToken
- CancellationToken
Das Abbruchtoken.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Hinweise
Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.
Gilt für:
GetSchemaAsync(String, CancellationToken)
Eine asynchrone Version von GetSchema(String), die Schemainformationen für die Datenquelle dieser SqlConnection mit der angegebenen Zeichenfolge für den Schemanamen zurückgibt.
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)Parameter
- collectionName
- String
Gibt den Namen des zurückzugebenden Schemas an.
- cancellationToken
- CancellationToken
Das Abbruchtoken.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
collectionName wird als NULL angegeben.
Hinweise
Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.
Gilt für:
GetSchemaAsync(String, String[], CancellationToken)
Eine asynchrone Version von GetSchema(String, String[]), die Schemainformationen für die Datenquelle dieser SqlConnection zurückgibt, wobei die angegebene Zeichenfolge für den Schemanamen und das angegebene Zeichenfolgenarray für die Einschränkungswerte verwendet wird.
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)Parameter
- collectionName
- String
Gibt den Namen des zurückzugebenden Schemas an.
- restrictionValues
- String[]
Eine Gruppe von Einschränkungswerten für das angeforderte Schema.
- cancellationToken
- CancellationToken
Das Abbruchtoken.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
collectionName wird als NULL angegeben.
Hinweise
Der restrictionValues Parameter kann eine Tiefe von Werten bereitstellen, die durch die Einschränkungsauflistung für eine bestimmte Auflistung angegeben werden. Um Werte für eine bestimmte Einschränkung festzulegen und nicht die Werte anderer Einschränkungen festzulegen, müssen Sie die vorherigen Einschränkungen null festlegen und dann den entsprechenden Wert für die Einschränkung einfügen, für die Sie einen Wert angeben möchten.
Ein Beispiel hierfür ist die "Tables"-Auflistung. Wenn die "Tables"-Auflistung drei Einschränkungen aufweist : Datenbank, Besitzer und Tabellenname - und Sie möchten nur die Tabellen abrufen, die dem Besitzer "Carl" zugeordnet sind, müssen Sie die folgenden Werte übergeben: null, "Carl". Wenn kein Einschränkungswert übergeben wird, werden die Standardwerte für diese Einschränkung verwendet. Dies ist dieselbe Zuordnung wie die Übergabe null, die sich von der Übergabe einer leeren Zeichenfolge für den Parameterwert unterscheidet. In diesem Fall wird die leere Zeichenfolge ("") als Wert für den angegebenen Parameter betrachtet.