DataCommand.DeriveSchema - метод

Статья
11/01/2012

Выводит схему, возвращаемую из указанной команды, указывающее расположение элементов и блоков в модуле чтения данных.

Пространство имен: Microsoft.VisualStudio.Data
Сборка: Microsoft.VisualStudio.Data (в Microsoft.VisualStudio.Data.dll)

Синтаксис

'Декларация
Public Overridable Function DeriveSchema ( _
    command As String, _
    commandType As Integer, _
    parameters As DataParameter(), _
    commandTimeout As Integer _
) As DataReader

public virtual DataReader DeriveSchema(
    string command,
    int commandType,
    DataParameter[] parameters,
    int commandTimeout
)

public:
virtual DataReader^ DeriveSchema(
    String^ command, 
    int commandType, 
    array<DataParameter^>^ parameters, 
    int commandTimeout
)

abstract DeriveSchema : 
        command:string * 
        commandType:int * 
        parameters:DataParameter[] * 
        commandTimeout:int -> DataReader 
override DeriveSchema : 
        command:string * 
        commandType:int * 
        parameters:DataParameter[] * 
        commandTimeout:int -> DataReader

public function DeriveSchema(
    command : String, 
    commandType : int, 
    parameters : DataParameter[], 
    commandTimeout : int
) : DataReader

Параметры

command
Тип: System.String
Команда, для которой произведен зависит от схемы в источнике данных.

commandType
Тип: System.Int32
Тип команды для указанной команды, указывающие, как интерпретировать содержимое параметра command.

parameters
Тип: array<Microsoft.VisualStudio.Data.DataParameter[]
Массив объектов DataParameter для конкретного командного типа.Это входной параметр, поставщик DDEX может по-прежнему задавать свойства для индивидуале out и возвращаемым значением.Однако они не будут заполнены производный схему.

commandTimeout
Тип: System.Int32
Продолжительность времени в секундах перед отменой блокировки клиент вывода схемы и передачи вызывающему приложению.Значение 0 указывает на бесконечное время ожидания. значение -1 указывает значение по умолчанию для поставщика.

Возвращаемое значение

Тип: Microsoft.VisualStudio.Data.DataReader
Возвращает объект DataReader.Данный объект предоставляет только вперед - только для чтения поток данных, который описывает структуру элементов и блоков, т е схемы для объекта средства чтения, возвращаемого по выполнена указанная команда.

Исключения

Исключение	Условие
ArgumentNullException	Команда или asyncCommandEvents значение null.
ArgumentException	CommandType определяет недопустимый тип.
ArgumentOutOfRangeException	CommandTimeout меньше -1.
NotSupportedException	Поставщик не поддерживает данный метод.

Заметки

Схема возвращенного модуля чтения данных этим методом, должна соответствовать определенный формат.Для каждого результата, который был бы возвращен, выполняющий команду, должен иметь результаты в модуле чтения данных.Каждый из этих результатов должно содержать блоки, описывающих элементы, которые возвращаются при выполнении команды.Описание должно содержать следующие элементы:

Имя (строка): имя элемента.
Порядковый номер (Int32). положение элемента.
UserDataType (строка): пользователь тип данных элемента (например, "myType").
NativeDataType (строка): собственный тип данных элемента (например, "nvarchar").
ProviderDataType (Int32). тип данных поставщика элемента (например, System.Data.DbType.StringFixedLength).
FrameworkDataType (тип): тип данных границ элемента (например, System.Int32).
Длина (Int32). максимальная длина элемента, если соответствующий.
Точность (Int32). точность элемента, если соответствующий.
Масштаб (Int32). масштаб элементов, если соответствующий.
Null (логическое значение): допустимость значений NULL элемента.

Те элементы, которые поставщик не поддерживает (например, некоторые форм типа данных) должны присутствовать, но установлены на nullссылка NULL (Nothing в Visual Basic).

Примечание
Другие исключения, происходящие указывает, что вывод параметра завершился ошибкой, поставщик- указанной причине.

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

DataCommand Класс

Microsoft.VisualStudio.Data - пространство имен

DataReader

Поделиться через