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