DbConnection.GetSchema 方法

定義

命名空間:

System.Data.Common

組件:

System.Data.Common.dll

傳回這個 DbConnection 之資料來源的結構描述資訊。

多載

GetSchema()	傳回這個 DbConnection 之資料來源的結構描述資訊。
GetSchema(String)	使用結構描述名稱的特定字串，傳回這個 DbConnection 之資料來源的結構描述資訊。
GetSchema(String, String[])	使用結構描述名稱的特定字串和限制值的特定字串陣列，傳回這個 DbConnection 的資料來源的結構描述資訊。

備註

如果連接與交易相關聯，執行 GetSchema 呼叫可能會導致某些提供者擲回例外狀況。

GetSchema()

來源:

DbConnection.cs

傳回這個 DbConnection 之資料來源的結構描述資訊。

public:
 virtual System::Data::DataTable ^ GetSchema();

public virtual System.Data.DataTable GetSchema ();

abstract member GetSchema : unit -> System.Data.DataTable
override this.GetSchema : unit -> System.Data.DataTable

Public Overridable Function GetSchema () As DataTable

傳回

DataTable

包含結構描述資訊的 DataTable。

備註

如果連接與交易相關聯，執行 GetSchema 呼叫可能會導致某些提供者擲回例外狀況。

另請參閱

• 從資料庫取得架構資訊
• ADO.NET 概觀 \(部分機器翻譯\)

GetSchema(String)

來源:

DbConnection.cs

使用結構描述名稱的特定字串，傳回這個 DbConnection 之資料來源的結構描述資訊。

public:
 virtual System::Data::DataTable ^ GetSchema(System::String ^ collectionName);

public virtual System.Data.DataTable GetSchema (string collectionName);

abstract member GetSchema : string -> System.Data.DataTable
override this.GetSchema : string -> System.Data.DataTable

Public Overridable Function GetSchema (collectionName As String) As DataTable

參數

collectionName

String

指定要傳回之結構描述的名稱。

傳回

DataTable

包含結構描述資訊的 DataTable。

例外狀況

ArgumentException

collectionName 指定為 null。

備註

如果連接與交易相關聯，執行 GetSchema 呼叫可能會導致某些提供者擲回例外狀況。

另請參閱

• 從資料庫取得架構資訊
• ADO.NET 概觀 \(部分機器翻譯\)

GetSchema(String, String[])

來源:

DbConnection.cs

使用結構描述名稱的特定字串和限制值的特定字串陣列，傳回這個 DbConnection 的資料來源的結構描述資訊。

public:
 virtual System::Data::DataTable ^ GetSchema(System::String ^ collectionName, cli::array <System::String ^> ^ restrictionValues);

public virtual System.Data.DataTable GetSchema (string collectionName, string?[] restrictionValues);

abstract member GetSchema : string * string[] -> System.Data.DataTable
override this.GetSchema : string * string[] -> System.Data.DataTable

Public Overridable Function GetSchema (collectionName As String, restrictionValues As String()) As DataTable

參數

collectionName

String

指定要傳回之結構描述的名稱。

restrictionValues

String[]

指定所要求之結構描述的限制值集合。

傳回

DataTable

包含結構描述資訊的 DataTable。

例外狀況

ArgumentException

collectionName 指定為 null。

備註

參數 restrictionValues 可以提供 n 個值的深度，這些深度是由特定集合的限制集合所指定。 若要在指定的限制上設定值，而不設定其他限制的值，您必須將上述限制設定為 null，然後將適當的值放在您想要指定值的限制中。

其中一個範例是 「Tables」 集合。 如果 「Tables」 集合有三個限制 (資料庫、擁有者和數據表名稱) ，而且您想要只傳回與擁有者 「Carl」 相關聯的數據表，您至少必須傳入下列值：null、“Carl”。 如果未傳入限制值，則會使用該限制的預設值。 這是與傳入 null 相同的對應，與傳入參數值的空字串不同。 在此情況下，空字串 (“”) 會被視為指定參數的值。

如果連接與交易相關聯，執行 GetSchema 呼叫可能會導致某些提供者擲回例外狀況。

另請參閱

• 從資料庫取得架構資訊
• ADO.NET 概觀 \(部分機器翻譯\)