Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais
Nous recommandons d’utiliser Visual Studio 2017

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)

public IVsDataReader DeriveSchema(
	string command,
	DataCommandType commandType
)

Paramètres

command
Type : String

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

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

Le type de commande qui spécifie comment interpréter le contenu du paramètre command. Type de commande peut être une valeur de l'énumération d'un DataCommandType ou un type personnalisé de commande défini par un fournisseur, qui peut être passé en imposant un cast d'un entier à l'énumération d'DataCommandType.

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)

ExceptionCondition
ArgumentNullException

Le paramètre command est null.

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

RemarqueRemarque

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

Afficher: