DataCommand.DeriveSchema (Método) (String)

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 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
    Un comando para que se deriva el esquema que es específico de un origen de datos.

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)

Excepciones

Excepción Condición
ArgumentNullException

El valor del parámetro command es nullreferencia null (Nothing en Visual Basic).

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 .NET Framework 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

Vea también

Referencia

DataCommand Clase

DeriveSchema (Sobrecarga)

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