SqlConnection.GetSchemaAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
| Název | Description |
|---|---|
| GetSchemaAsync(CancellationToken) |
Asynchronní verze GetSchema(), která vrací informace o schématu pro zdroj dat tohoto SqlConnection. Další informace o schématech najdete v tématu SQL Server kolekce schémat. |
| GetSchemaAsync(String, CancellationToken) |
Asynchronní verze GetSchema(String), která vrací informace o schématu pro zdroj dat tohoto SqlConnection pomocí zadaného řetězce pro název schématu. |
| GetSchemaAsync(String, String[], CancellationToken) |
Asynchronní verze GetSchema(String, String[]), která vrací informace o schématu pro zdroj dat tohoto SqlConnection pomocí zadaného řetězce pro název schématu a zadané pole řetězců pro hodnoty omezení. |
GetSchemaAsync(CancellationToken)
Asynchronní verze GetSchema(), která vrací informace o schématu pro zdroj dat tohoto SqlConnection. Další informace o schématech najdete v tématu SQL Server kolekce schémat.
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 zrušení.
Návraty
Úloha představující asynchronní operaci.
Poznámky
Další informace o asynchronním programování v Zprostředkovatel dat .NET Framework pro SQL Server naleznete v tématu Synchronous Programming.
Platí pro
GetSchemaAsync(String, CancellationToken)
Asynchronní verze GetSchema(String), která vrací informace o schématu pro zdroj dat tohoto SqlConnection pomocí zadaného řetězce pro název schématu.
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
Určuje název schématu, který se má vrátit.
- cancellationToken
- CancellationToken
Token zrušení.
Návraty
Úloha představující asynchronní operaci.
Výjimky
collectionName je zadána jako null.
Poznámky
Další informace o asynchronním programování v Zprostředkovatel dat .NET Framework pro SQL Server naleznete v tématu Synchronous Programming.
Platí pro
GetSchemaAsync(String, String[], CancellationToken)
Asynchronní verze GetSchema(String, String[]), která vrací informace o schématu pro zdroj dat tohoto SqlConnection pomocí zadaného řetězce pro název schématu a zadané pole řetězců pro hodnoty omezení.
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
Určuje název schématu, který se má vrátit.
- restrictionValues
- String[]
Sada hodnot omezení požadovaného schématu.
- cancellationToken
- CancellationToken
Token zrušení.
Návraty
Úloha představující asynchronní operaci.
Výjimky
collectionName je zadána jako null.
Poznámky
Parametr restrictionValues může poskytnout n hloubku hodnot, které jsou určeny kolekcí omezení pro konkrétní kolekci. Pokud chcete nastavit hodnoty pro dané omezení a nenastavovat hodnoty jiných omezení, musíte nastavit předchozí omezení null a potom zadat odpovídající hodnotu pro omezení, pro které chcete zadat hodnotu.
Příkladem je kolekce Tables (Tabulky). Pokud má kolekce Tables tři omezení – databáze, vlastník a název tabulky – a chcete získat zpět pouze tabulky přidružené k vlastníkovi Carl, musíte předat následující hodnoty: null, "Carl". Pokud se hodnota omezení nepředá, použijí se pro toto omezení výchozí hodnoty. Toto je stejné mapování jako předávání null, které se liší od předání prázdného řetězce pro hodnotu parametru. V takovém případě se prázdný řetězec ("") považuje za hodnotu zadaného parametru.