Partager via


DataCommand.DeriveSchema, méthode (String)

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.Framework
Assembly :  Microsoft.VisualStudio.Data.Framework (dans Microsoft.VisualStudio.Data.Framework.dll)

Syntaxe

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

Paramètres

  • command
    Type : System.String
    Une commande pour laquelle dérive le schéma spécifique à 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, c. autrement dit., le schéma, pour l'objet retourné lecteur en exécutant la commande spécifiée.

Implémentations

IVsDataCommand.DeriveSchema(String)

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.

  • 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.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) : 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).

[!REMARQUE]

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