SqlConnection.GetSchemaAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przeciążenia
| Nazwisko | Opis |
|---|---|
| GetSchemaAsync(CancellationToken) |
Asynchroniczna wersja programu GetSchema(), która zwraca informacje o schemacie dla źródła danych tego SqlConnectionelementu . Aby uzyskać więcej informacji na temat schematów, zobacz SQL Server Kolekcje schematów. |
| GetSchemaAsync(String, CancellationToken) |
Asynchroniczna wersja GetSchema(String)programu , która zwraca informacje o schemacie dla źródła SqlConnection danych przy użyciu określonego ciągu dla nazwy schematu. |
| GetSchemaAsync(String, String[], CancellationToken) |
Asynchroniczna wersja GetSchema(String, String[])programu , która zwraca informacje o schemacie dla źródła danych tego SqlConnection przy użyciu określonego ciągu dla nazwy schematu i określonej tablicy ciągów dla wartości ograniczeń. |
GetSchemaAsync(CancellationToken)
Asynchroniczna wersja programu GetSchema(), która zwraca informacje o schemacie dla źródła danych tego SqlConnectionelementu . Aby uzyskać więcej informacji na temat schematów, zobacz SQL Server Kolekcje schematów.
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)Parametry
- cancellationToken
- CancellationToken
Token anulowania.
Zwraca
Zadanie reprezentujące operację asynchroniczną.
Uwagi
Aby uzyskać więcej informacji na temat programowania asynchronicznego w Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.
Dotyczy
GetSchemaAsync(String, CancellationToken)
Asynchroniczna wersja GetSchema(String)programu , która zwraca informacje o schemacie dla źródła SqlConnection danych przy użyciu określonego ciągu dla nazwy schematu.
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)Parametry
- collectionName
- String
Określa nazwę schematu do zwrócenia.
- cancellationToken
- CancellationToken
Token anulowania.
Zwraca
Zadanie reprezentujące operację asynchroniczną.
Wyjątki
collectionName parametr jest określony jako null.
Uwagi
Aby uzyskać więcej informacji na temat programowania asynchronicznego w Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.
Dotyczy
GetSchemaAsync(String, String[], CancellationToken)
Asynchroniczna wersja GetSchema(String, String[])programu , która zwraca informacje o schemacie dla źródła danych tego SqlConnection przy użyciu określonego ciągu dla nazwy schematu i określonej tablicy ciągów dla wartości ograniczeń.
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)Parametry
- collectionName
- String
Określa nazwę schematu do zwrócenia.
- restrictionValues
- String[]
Zestaw wartości ograniczeń dla żądanego schematu.
- cancellationToken
- CancellationToken
Token anulowania.
Zwraca
Zadanie reprezentujące operację asynchroniczną.
Wyjątki
collectionName parametr jest określony jako null.
Uwagi
Parametr restrictionValues może dostarczyć n głębokości wartości, które są określone przez kolekcję ograniczeń dla określonej kolekcji. Aby ustawić wartości dla danego ograniczenia, a nie ustawić wartości innych ograniczeń, należy ustawić powyższe ograniczenia na null , a następnie umieścić odpowiednią wartość dla ograniczenia, dla którego chcesz określić wartość.
Przykładem jest kolekcja "Tabele". Jeśli kolekcja "Tabele" ma trzy ograniczenia — baza danych, właściciel i nazwa tabeli — i chcesz wrócić tylko do tabel skojarzonych z właścicielem "Carl", musisz przekazać następujące wartości: null, "Carl". Jeśli wartość ograniczenia nie jest przekazywana, wartości domyślne są używane dla tego ograniczenia. Jest to to samo mapowanie co przekazywanie elementu null, które różni się od przekazywania pustego ciągu dla wartości parametru. W takim przypadku pusty ciąg ("") jest uważany za wartość określonego parametru.