DataCommand.DeriveSchema - метод (String, DataCommandType, array<IVsDataParameter )

Статья
11/01/2012

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

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

Синтаксис

'Декларация
Public Function DeriveSchema ( _
    command As String, _
    commandType As DataCommandType, _
    parameters As IVsDataParameter() _
) As IVsDataReader

public IVsDataReader DeriveSchema(
    string command,
    DataCommandType commandType,
    IVsDataParameter[] parameters
)

public:
virtual IVsDataReader^ DeriveSchema(
    String^ command, 
    DataCommandType commandType, 
    array<IVsDataParameter^>^ parameters
) sealed

abstract DeriveSchema : 
        command:string * 
        commandType:DataCommandType * 
        parameters:IVsDataParameter[] -> IVsDataReader 
override DeriveSchema : 
        command:string * 
        commandType:DataCommandType * 
        parameters:IVsDataParameter[] -> IVsDataReader

public final function DeriveSchema(
    command : String, 
    commandType : DataCommandType, 
    parameters : IVsDataParameter[]
) : IVsDataReader

Параметры

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

commandType
Тип: Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType
Тип команды, которая определяет, как интерпретировать содержимое параметра command.Тип команды может быть либо значением из перечисления DataCommandType или пользовательским типом команды указанного поставщиком, который может быть передан в путем принудительной приведение от целого числа в перечисление DataCommandType.

parameters
Тип: array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]
Массив объектов IVsDataParameter, представляющий параметры команд для заданной команды.

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

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

Реализации

IVsDataCommand.DeriveSchema(String, DataCommandType, array<IVsDataParameter[])

Исключения

Исключение	Условие
ArgumentNullException	Значение параметра command — nullссылка NULL (Nothing в Visual Basic).

Заметки

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

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

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

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

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

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