SqlConnection.GetSchemaAsync Metode

Definisi

Ruang nama:: Microsoft.Data.SqlClient

Rakitan:: Microsoft.Data.SqlClient.dll

Paket:: Microsoft.Data.SqlClient v7.1.0

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Overload

Nama	Deskripsi
GetSchemaAsync(CancellationToken)	Versi asinkron dari GetSchema(), yang mengembalikan informasi skema untuk sumber data ini SqlConnection. Untuk informasi selengkapnya tentang skema, lihat Koleksi Skema SQL Server.
GetSchemaAsync(String, CancellationToken)	Versi asinkron dari GetSchema(String), yang mengembalikan informasi skema untuk sumber data ini SqlConnection menggunakan string yang ditentukan untuk nama skema.
GetSchemaAsync(String, String[], CancellationToken)	Versi asinkron dari GetSchema(String, String[]), yang mengembalikan informasi skema untuk sumber data ini SqlConnection menggunakan string yang ditentukan untuk nama skema dan array string yang ditentukan untuk nilai pembatasan.

GetSchemaAsync(CancellationToken)

Versi asinkron dari GetSchema(), yang mengembalikan informasi skema untuk sumber data ini SqlConnection. Untuk informasi selengkapnya tentang skema, lihat Koleksi Skema SQL Server.

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

Token pembatalan.

Mengembalikan

Task<DataTable>

Tugas yang mewakili operasi asinkron.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron di Data Provider .NET Framework untuk SQL Server, lihat Programan Asinkron.

Berlaku untuk

GetSchemaAsync(String, CancellationToken)

Versi asinkron dari GetSchema(String), yang mengembalikan informasi skema untuk sumber data ini SqlConnection menggunakan string yang ditentukan untuk nama skema.

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

Menentukan nama skema yang akan dikembalikan.

cancellationToken: CancellationToken

Token pembatalan.

Mengembalikan

Task<DataTable>

Tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentException

collectionName ditentukan sebagai null.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron di Data Provider .NET Framework untuk SQL Server, lihat Programan Asinkron.

Berlaku untuk

GetSchemaAsync(String, String[], CancellationToken)

Versi asinkron dari GetSchema(String, String[]), yang mengembalikan informasi skema untuk sumber data ini SqlConnection menggunakan string yang ditentukan untuk nama skema dan array string yang ditentukan untuk nilai pembatasan.

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

Menentukan nama skema yang akan dikembalikan.

restrictionValues: String[]

Sekumpulan nilai pembatasan untuk skema yang diminta.

cancellationToken: CancellationToken

Token pembatalan.

Mengembalikan

Task<DataTable>

Tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentException

collectionName ditentukan sebagai null.

Keterangan

Parameter restrictionValues dapat memberikan n kedalaman nilai, yang ditentukan oleh koleksi pembatasan untuk koleksi tertentu. Untuk mengatur nilai pada pembatasan tertentu, dan tidak mengatur nilai pembatasan lain, Anda perlu mengatur pembatasan sebelumnya ke null lalu menempatkan nilai yang sesuai untuk pembatasan yang ingin Anda tentukan nilainya.

Contohnya adalah koleksi "Tabel". Jika koleksi "Tabel" memiliki tiga batasan--database, pemilik, dan nama tabel--dan Anda hanya ingin mendapatkan kembali tabel yang terkait dengan pemilik "Carl", Anda perlu meneruskan nilai berikut: null, "Carl". Jika nilai pembatasan tidak diteruskan, nilai default digunakan untuk pembatasan tersebut. Ini adalah pemetaan yang sama dengan meneruskan null, yang berbeda dari meneruskan string kosong untuk nilai parameter. Dalam hal ini, string kosong ("") dianggap sebagai nilai untuk parameter yang ditentukan.

Lihat juga

GetSchema()

Berlaku untuk