SqlConnection.GetSchemaAsync Yöntem

Tanım

Ad Alanı:: Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:: Microsoft.Data.SqlClient.dll

Paket:: Microsoft.Data.SqlClient v7.1.0

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Aşırı Yüklemeler

Veri Akışı Adı	Description
GetSchemaAsync(CancellationToken)	bu veri kaynağı SqlConnectioniçin şema bilgilerini döndüren zaman uyumsuz sürümüGetSchema(). Şemalar hakkında daha fazla bilgi için bkz. SQL Server Şema Koleksiyonları.
GetSchemaAsync(String, CancellationToken)	Zaman uyumsuz sürümü GetSchema(String), şema adı için belirtilen dizeyi kullanarak bunun SqlConnection veri kaynağı için şema bilgilerini döndürür.
GetSchemaAsync(String, String[], CancellationToken)	Zaman uyumsuz sürümü GetSchema(String, String[]), şema adı için belirtilen dizeyi ve kısıtlama değerleri için belirtilen dize dizisini kullanarak bunun SqlConnection veri kaynağı için şema bilgilerini döndürür.

GetSchemaAsync(CancellationToken)

bu veri kaynağı SqlConnectioniçin şema bilgilerini döndüren zaman uyumsuz sürümüGetSchema(). Şemalar hakkında daha fazla bilgi için bkz. SQL Server Şema Koleksiyonları.

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)

Parametreler

cancellationToken: CancellationToken

İptal belirteci.

Döndürülenler

Task<DataTable>

Zaman uyumsuz işlemi temsil eden bir görev.

Açıklamalar

SQL Server için .NET Framework Veri Sağlayıcısı zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Asynchronous Programming.

Şunlara uygulanır

GetSchemaAsync(String, CancellationToken)

Zaman uyumsuz sürümü GetSchema(String), şema adı için belirtilen dizeyi kullanarak bunun SqlConnection veri kaynağı için şema bilgilerini döndürür.

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)

Parametreler

collectionName: String

Döndürülecek şemanın adını belirtir.

cancellationToken: CancellationToken

İptal belirteci.

Döndürülenler

Task<DataTable>

Zaman uyumsuz işlemi temsil eden bir görev.

Özel durumlar

ArgumentException

collectionName null olarak belirtilir.

Açıklamalar

SQL Server için .NET Framework Veri Sağlayıcısı zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Asynchronous Programming.

Şunlara uygulanır

GetSchemaAsync(String, String[], CancellationToken)

Zaman uyumsuz sürümü GetSchema(String, String[]), şema adı için belirtilen dizeyi ve kısıtlama değerleri için belirtilen dize dizisini kullanarak bunun SqlConnection veri kaynağı için şema bilgilerini döndürür.

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)

Parametreler

collectionName: String

Döndürülecek şemanın adını belirtir.

restrictionValues: String[]

İstenen şema için bir dizi kısıtlama değeri.

cancellationToken: CancellationToken

İptal belirteci.

Döndürülenler

Task<DataTable>

Zaman uyumsuz işlemi temsil eden bir görev.

Özel durumlar

ArgumentException

collectionName null olarak belirtilir.

Açıklamalar

restrictionValues parametresi, belirli bir koleksiyon için kısıtlama koleksiyonu tarafından belirtilen n değer derinliği sağlayabilir. Belirli bir kısıtlamada değer ayarlamak ve diğer kısıtlamaların değerlerini ayarlamamak için, önceki kısıtlamaları null olarak ayarlamanız ve ardından değerini belirtmek istediğiniz kısıtlama için uygun değeri içine koymanız gerekir.

Buna örnek olarak "Tablolar" koleksiyonu verilmiştir. "Tablolar" koleksiyonunun veritabanı, sahip ve tablo adı olmak üzere üç kısıtlaması varsa ve yalnızca "Carl" sahibiyle ilişkili tabloları geri almak istiyorsanız, şu değerleri geçirmeniz gerekir: null, "Carl". Bir kısıtlama değeri geçirilmediyse, bu kısıtlama için varsayılan değerler kullanılır. Bu, parametresi değeri için boş bir dize geçirmekten farklı olan değerini geçirmekle nullaynı eşlemedir. Bu durumda, boş dize ("") belirtilen parametrenin değeri olarak kabul edilir.

Ayrıca bkz.

GetSchema()

Şunlara uygulanır