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

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

Parametri

• command
  Tipo: String

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

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

  Il tipo di comando che specifica come interpretare il contenuto del parametro command. Il tipo di comando potrebbe essere un valore di enumerazione DataCommandType o un tipo personalizzato di comando definito da un provider, che può essere passato forzare un cast da un integer all'enumerazione DataCommandType.

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

  Una matrice di oggetti IVsDataParameter che rappresentano i parametri di comando per il tipo specificato di comando.

• commandTimeout
  Tipo: Int32

  La durata, in secondi, bloccare il client prima di annullare la derivazione dello schema e di ritornare al chiamante. Un valore pari a 0 indica che il timeout infinito; un valore pari a -1 indica un valore predefinito del provider.

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, DataCommandType, array<IVsDataParameter[], Int32)

Eccezioni

Eccezione	Condizione
ArgumentNullException	Il parametro command è nullriferimento null (Nothing in Visual Basic).
ArgumentOutOfRangeException	Il parametro commandTimeout è minore di -1.

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 del 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.

Vedere anche

Riferimenti

DataCommand Classe

Overload DeriveSchema

Spazio dei nomi Microsoft.VisualStudio.Data.Framework

DataReader