DbConnection.GetSchema 方法
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
傳回這個 DbConnection 之資料來源的結構描述資訊。
| GetSchema() |
傳回這個 DbConnection 之資料來源的結構描述資訊。 |
| GetSchema(String) |
使用結構描述名稱的特定字串，傳回這個 DbConnection 之資料來源的結構描述資訊。 |
| GetSchema(String, String[]) |
使用結構描述名稱的特定字串和限制值的特定字串陣列，傳回這個 DbConnection 的資料來源的結構描述資訊。 |
如果連接與交易相關聯，執行 GetSchema 呼叫可能會導致某些提供者擲回例外狀況。
傳回這個 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.DataTablePublic Overridable Function GetSchema () As DataTable傳回
包含結構描述資訊的 DataTable。
備註
如果連接與交易相關聯，執行 GetSchema 呼叫可能會導致某些提供者擲回例外狀況。
另請參閱
- 從資料庫取得架構資訊
- ADO.NET 概觀 \(部分機器翻譯\)
適用於
.NET 9 及其他版本
| 產品 | 版本 |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
使用結構描述名稱的特定字串，傳回這個 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.DataTablePublic Overridable Function GetSchema (collectionName As String) As DataTable參數
- collectionName
- String
指定要傳回之結構描述的名稱。
傳回
包含結構描述資訊的 DataTable。
例外狀況
collectionName 指定為 null。
備註
如果連接與交易相關聯，執行 GetSchema 呼叫可能會導致某些提供者擲回例外狀況。
另請參閱
- 從資料庫取得架構資訊
- ADO.NET 概觀 \(部分機器翻譯\)
適用於
.NET 9 及其他版本
| 產品 | 版本 |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
使用結構描述名稱的特定字串和限制值的特定字串陣列，傳回這個 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);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.DataTablePublic Overridable Function GetSchema (collectionName As String, restrictionValues As String()) As DataTable參數
- collectionName
- String
指定要傳回之結構描述的名稱。
- restrictionValues
- String[]
指定所要求之結構描述的限制值集合。
傳回
包含結構描述資訊的 DataTable。
例外狀況
collectionName 指定為 null。
備註
參數 restrictionValues 可以提供 n 個值的深度，這些深度是由特定集合的限制集合所指定。 若要在指定的限制上設定值，而不設定其他限制的值，您必須將上述限制設定為 null，然後將適當的值放在您想要指定值的限制中。
其中一個範例是 「Tables」 集合。 如果 「Tables」 集合有三個限制 (資料庫、擁有者和數據表名稱) ，而且您想要只傳回與擁有者 「Carl」 相關聯的數據表，您至少必須傳入下列值：null、“Carl”。 如果未傳入限制值，則會使用該限制的預設值。 這是與傳入 null 相同的對應，與傳入參數值的空字串不同。 在此情況下，空字串 (“”) 會被視為指定參數的值。
如果連接與交易相關聯，執行 GetSchema 呼叫可能會導致某些提供者擲回例外狀況。
另請參閱
- 從資料庫取得架構資訊
- ADO.NET 概觀 \(部分機器翻譯\)
適用於
.NET 9 及其他版本
| 產品 | 版本 |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
