Metodo DataCommand.DeriveSchema (String)

Articolo
05/16/2015

Deriva lo schema restituito dal comando specificato. Lo schema indica il layout degli elementi e dei blocchi di un lettore dati.

Spazio dei nomi: Microsoft.VisualStudio.Data.Framework
Assembly: Microsoft.VisualStudio.Data.Framework (in Microsoft.VisualStudio.Data.Framework.dll)

Sintassi

'Dichiarazione
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

Parametri

command
Tipo: String

Un comando per cui derivare lo schema specifico a un'origine dati.

Valore restituito

Tipo: Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataReader
Un oggetto IVsDataReader.Questo oggetto fornisce un flusso di dati forward-only in sola lettura che descrive il layout degli elementi e dei blocchi, ovvero, lo schema, per l'oggetto del lettore restituito sull'esecuzione del comando specificato.

Implementa

IVsDataCommand.DeriveSchema(String)

Eccezioni

Eccezione	Condizione
ArgumentNullException	Il parametro command è nullriferimento null (Nothing in Visual Basic).

Note

Lo schema del lettore dati restituito da questo metodo deve seguire un formato specifico. Per ogni risultato che verrà restituito quando si esegue il comando, si otterrà un risultato nel lettore dati. Ognuno di questi risultati deve contenere blocchi che descrivono gli elementi che verranno restituiti quando si esegue il comando. La descrizione deve contenere punti seguenti:

Nome (stringa): il nome dell'elemento.
(Int32) ordinale: la posizione dell'elemento.
UserDataType (stringa): il tipo di dati utente dell'elemento, ad esempio "tipo").
NativeDataType (stringa): il tipo di dati nativo dell'elemento, ad esempio "nvarchar").
ProviderDataType (Int32): il tipo di dati del provider dell'elemento (ad esempio, System.Data.SqlDbType.NVarChar).
ProviderDbType (Int32): il tipo di dati generico ADO.NET dell'elemento (ad esempio, System.Data.DbType.StringFixedLength).
FrameworkDataType (tipo): il tipo di dati.NET Framework dell'elemento (ad esempio, System.Int32).
Lunghezza (Int32): la lunghezza massima dell'elemento, se disponibile.
(Int32) precisione: la precisione dell'elemento, se disponibile.
(Int32) scala: la scala dell'elemento, se disponibile.
Nullable (booleane): il nullability dell'elemento.

Gli elementi che un provider non supporta, ad esempio una qualche forma del tipo di dati) devono essere presenti ma impostata su nullriferimento null (Nothing in Visual Basic).

Nota

Altre eccezioni che si verificano indicano che la derivazione dello schema non è riuscita per un motivo specifico momento.

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.