DataCommand.DeriveSchema (Método) (String, DataCommandType, array<IVsDataParameter , Int32)

Deriva el esquema devuelto por un comando especificado.El esquema indica el diseño de los elementos y de bloques en un lector de datos.

Espacio de nombres:  Microsoft.VisualStudio.Data.Framework
Ensamblado:  Microsoft.VisualStudio.Data.Framework (en Microsoft.VisualStudio.Data.Framework.dll)

Sintaxis

'Declaración
Public Overridable Function DeriveSchema ( _
    command As String, _
    commandType As DataCommandType, _
    parameters As IVsDataParameter(), _
    commandTimeout As Integer _
) As IVsDataReader

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

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

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

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

Parámetros

• command
  Tipo: System.String
  Un comando para que se deriva el específico del esquema al origen de datos.

• commandType
  Tipo: Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType
  El tipo de comando que especifica cómo interpretar el contenido del parámetro de command .El tipo de comando puede ser un valor de enumeración de DataCommandType o un tipo de comando personalizado definido por un proveedor, que puede ser pasado fuerza una conversión de un entero en la enumeración de DataCommandType .

• parameters
  Tipo: array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]
  Una matriz de IVsDataParameter se opone representa los parámetros de comando para el tipo de comando especificado.

• commandTimeout
  Tipo: System.Int32
  El tiempo, en segundos, de bloquear el cliente antes de cancelar la derivación de esquema y volver al llamador.Un valor de 0 indica que el tiempo de espera infinito; el valor -1 indica un valor predeterminado del proveedor.

Valor devuelto

Tipo: Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataReader
Un objeto IVsDataReader.Este objeto proporciona una secuencia de datos adelantada - solo, de solo lectura que describe el diseño de los elementos y de bloques, es decir, el esquema, para el objeto de lector devuelto sobre cómo ejecutar el comando especificado.

Implementaciones

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

Excepciones

Comentarios

El esquema del lector de datos devuelto por este método debe seguir un formato concreto.Para cada resultado que se devuelve al ejecutar el comando, debe haber un resultado en el lector de datos.Cada uno de estos resultados debe contener bloques que describen los elementos que se devolverán cuando se ejecuta el comando.La descripción debe contener los siguientes elementos:

• Nombre (cadena): el nombre del elemento.

• Ordinal (Int32): la posición del elemento.

• UserDataType (cadena): el tipo de datos de usuario del elemento (por ejemplo, “myType”).

• NativeDataType (cadena): el tipo de datos nativo de elemento (por ejemplo, “nvarchar”).

• ProviderDataType (Int32): el tipo de datos de proveedor de elemento (por ejemplo, System.Data.SqlDbType.NVarChar).

• ProviderDbType (Int32): el tipo de datos genérico de ADO.NET de elemento (por ejemplo, System.Data.DbType.StringFixedLength).

• FrameworkDataType (tipo): el tipo de datos de elemento (por ejemplo, System.Int32).

• Length (Int32): la longitud máxima del elemento, si es necesario.

• Precisión (Int32): la precisión del elemento, si es necesario.

• Escala (Int32): la escala del elemento, si es necesario.

• Valores NULL (boolean): la nulabilidad del elemento.

Los elementos que un proveedor no admite (por ejemplo, algunas formas del tipo de datos) deben estar presentes pero establecidos en nullreferencia null (Nothing en Visual Basic).

[!NOTA]

Otras excepciones que aparecen indican que la derivación de esquema falla por un motivo proveedor- especificada.

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

DataCommand Clase

DeriveSchema (Sobrecarga)

Microsoft.VisualStudio.Data.Framework (Espacio de nombres)

DataReader