DataCommand.DeriveSchema, méthode (String, DataCommandType)

Dérive le schéma retourné d'une commande spécifiée. Le schéma affiche la disposition des éléments et des blocs à un lecteur de données.

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

Syntaxe

'Déclaration
Public Function DeriveSchema ( _
    command As String, _
    commandType As DataCommandType _
) As IVsDataReader
public IVsDataReader DeriveSchema(
    string command,
    DataCommandType commandType
)
public:
virtual IVsDataReader^ DeriveSchema(
    String^ command, 
    DataCommandType commandType
) sealed
abstract DeriveSchema : 
        command:string * 
        commandType:DataCommandType -> IVsDataReader  
override DeriveSchema : 
        command:string * 
        commandType:DataCommandType -> IVsDataReader
public final function DeriveSchema(
    command : String, 
    commandType : DataCommandType
) : IVsDataReader

Paramètres

  • command
    Type : String

    Une commande pour laquelle dérive des détails de schéma schéma à une source de données.

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, autrement. Autrement dit., le schéma, pour l'objet lecteur retourné en exécutant la commande spécifiée.

Implémentations

IVsDataCommand.DeriveSchema(String, DataCommandType)

Exceptions

Exception Condition
ArgumentNullException

Le paramètre command est nullune référence null (Nothing en Visual Basic).

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.

  • Nombre ordinale (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.SqlDbType.NVarChar).

  • ProviderDbType (Int32) : le type de données générique ADO.NET de l'élément (par exemple, System.Data.DbType.StringFixedLength).

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

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

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

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

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

Ces éléments qu'un fournisseur ne prend pas en charge (par exemple, certains types de type de données) doivent être présents mais la valeur nullune référence null (Nothing en Visual Basic).

Notes

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

Sécurité .NET Framework

Voir aussi

Référence

DataCommand Classe

DeriveSchema, surcharge

Microsoft.VisualStudio.Data.Framework, espace de noms

DataReader