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

Cuando es implementada por una clase, 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.Services.SupportEntities
Ensamblado:  Microsoft.VisualStudio.Data.Services (en Microsoft.VisualStudio.Data.Services.dll)

Sintaxis

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

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

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

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

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

Parámetros

• command
  Tipo: String

  Un comando para que se deriva el esquema que es específico de un origen de datos.

• commandType
  Tipo: Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType

  Un valor de enumeración de DataCommandType que representa el tipo de comando para el comando indicado, especificando cómo interpretar el contenido del parámetro de command .

• parameters
  Tipo: array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]

  Una matriz de DataParameter se opone para el tipo de comando especificado. Aunque esto es un parámetro de entrada, el proveedor de DDEX todavía puede establecer propiedades en individuales out y parámetros de valor devuelto. Sin embargo, estos no se rellenan al derivar esquemas.

• commandTimeout
  Tipo: 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.

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.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 parámetro 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

IVsDataCommand Interfaz

DeriveSchema (Sobrecarga)

Microsoft.VisualStudio.Data.Services.SupportEntities (Espacio de nombres)