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

Une fois implémentée par une classe, qui dérive le schéma retourné d'une commande spécifiée. Le schéma indique la disposition des éléments et des blocs dans un lecteur de données.

Espace de noms :  Microsoft.VisualStudio.Data.Services.SupportEntities
Assembly :  Microsoft.VisualStudio.Data.Services (dans Microsoft.VisualStudio.Data.Services.dll)

Syntaxe

'Déclaration
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

Paramètres

• command
  Type : String

  Une commande pour laquelle dérive le schéma spécifique à une source de données.

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

  Une valeur de l'énumération d' DataCommandType représentant le type de commande pour l'ordre indiqué, spécifiant comment interpréter le contenu du paramètre d' command .

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

  Un tableau d'objets DataParameter pour le type spécifié de commande. Lorsque c'est un paramètre d'entrée, le fournisseur de DDEX peut encore définir des propriétés sur la personne et les paramètres de valeur de retour. Toutefois, ils ne sont pas remplis en dérivant des schémas.

• commandTimeout
  Type : Int32

  La durée, en secondes, pour bloquer le client avant d'annuler la dérivation de schéma et retourner à l'appelant. Une valeur de 0 indique que la minuterie infinie ; une valeur de -1 indique une valeur par défaut de fournisseur.

Valeur de retour

Type : Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataReader
Objet IVsDataReader.Cet objet fournit un flux de données avant uniquement en lecture seule qui décrit la disposition des éléments et des blocs, c. autrement dit., le schéma, pour l'objet retourné lecteur en exécutant la commande spécifiée.

Notes

Le schéma du lecteur de données retourné par cette méthode doit suivre un format spécifique. Pour chaque résultat qui sera retourné lorsque vous exécutez la commande, il doit exister un résultat dans le lecteur de données. Chacun de ces résultats doit contenir les blocs qui décrivent les éléments qui sont retournés lorsque vous exécutez la commande. La description doit contenir les éléments suivants :

• Nom (chaîne) : le nom de l'élément.

• Ordinal (Int32) : la position de l'élément.

• UserDataType (chaîne) : le type de données de l'élément (par exemple, « myType »).

• NativeDataType (chaîne) : le type de données natif de l'élément (par exemple, « nvarchar »).

• ProviderDataType (Int32) : le type de données du fournisseur de l'élément (par exemple, System.Data.DbType.StringFixedLength).

• FrameworkDataType (type) : le type de données d'infrastructure de l'élément (par exemple, System.Int32).

• Longueur (Int32) : la longueur maximale de l'élément, le cas échéant.

• Précision (Int32) : la précision de l'élément, le cas échéant.

• Échelle (Int32) : l'échelle de l'élément, le cas échéant.

• Nullable (Boolean) : le nullability de l'élément.

Ces éléments qu'un fournisseur ne prend pas en charge (par exemple, certaines formes de type de données) doivent être présent mais défini à nullune référence null (Nothing en Visual Basic).

Notes

D'autres exceptions qui se produisent indiquent que la dérivation de paramètre a échoué pour une raison fournisseur- spécifiée.

Sécurité .NET Framework

• Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

IVsDataCommand Interface

DeriveSchema, surcharge

Microsoft.VisualStudio.Data.Services.SupportEntities, espace de noms