Método DataCommand.DeriveSchema (String)

Artigo
10/26/2012

Derivado o esquema retornado de um comando especificado.O esquema indica o layout dos itens e os blocos em um leitor de dados.

Namespace: Microsoft.VisualStudio.Data.Framework
Assembly: Microsoft.VisualStudio.Data.Framework (em Microsoft.VisualStudio.Data.Framework.dll)

Sintaxe

'Declaração
Public Function DeriveSchema ( _
    command As String _
) As IVsDataReader

public IVsDataReader DeriveSchema(
    string command
)

public:
virtual IVsDataReader^ DeriveSchema(
    String^ command
) sealed

abstract DeriveSchema : 
        command:string -> IVsDataReader 
override DeriveSchema : 
        command:string -> IVsDataReader

public final function DeriveSchema(
    command : String
) : IVsDataReader

Parâmetros

command
Tipo: System.String
Um comando para que derivam do esquema que é específico a uma fonte de dados.

Valor de retorno

Tipo: Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataReader
Um objeto IVsDataReader.Este objeto fornece um fluxo de dados somente para frente, somente leitura que descreve o layout de itens e os blocos, isto é, o esquema, para o objeto leitor retornado em cima de executar o comando especificado.

Implementações

IVsDataCommand.DeriveSchema(String)

Exceções

Exceção	Condição
ArgumentNullException	o parâmetro de command é nulluma referência nula (Nothing no Visual Basic).

Comentários

O esquema leitor de dados retornados por esse método deve seguir um formato específico.Para cada resultado que será retornado quando você executar o comando, deve haver um resultado no leitor de dados.Cada um de esses resultados deve conter blocos que descrevem os itens que serão retornados quando você executa o comando.a descrição deve conter os seguintes itens:

Nome (cadeia de caracteres): o nome do item.
Ordinal (Int32): a posição do item.
UserDataType (cadeia de caracteres): o tipo de dados do usuário de item (por exemplo, “myType”).
NativeDataType (cadeia de caracteres): o tipo de dados nativo de item (por exemplo, “nvarchar”).
ProviderDataType (Int32): o tipo de dados do provedor de item (por exemplo, System.Data.SqlDbType.NVarChar).
ProviderDbType (Int32): o tipo de dados do ADO.NET genérica de item (por exemplo, System.Data.DbType.StringFixedLength).
FrameworkDataType (Tipo): o tipo de dados do .NET Framework do item (por exemplo, System.Int32).
Comprimento (Int32): o comprimento máximo do item, se aplicável.
Precisão (Int32): a precisão do item, se aplicável.
Escala (Int32): a escala do item, se aplicável.
Anulável (booleano): a nulidade de item.

Esses itens que um provedor não suporta (por exemplo, alguns formulários do tipo de dados) deve estar presente mas definir a nulluma referência nula (Nothing no Visual Basic).

Observação
Outras exceções que ocorrem indica que a derivação de esquema falhou para um motivo provedor- especificada.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.