DataCommand.DeriveSchema-Methode (String, DataCommandType)

Artikel
05/16/2015

Berechnet das Schema, das von einem angegebenen Befehl zurückgegeben wird. Das Schema wird das Layout von Elementen und von Ausschnitten in einem Datenreader an.

Namespace: Microsoft.VisualStudio.Data.Framework
Assembly: Microsoft.VisualStudio.Data.Framework (in Microsoft.VisualStudio.Data.Framework.dll)

Syntax

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

Parameter

command
Typ: String

Ein Befehl, für den das Schemabesonderen zu einer Datenquelle abgeleitet.

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

Der Typ des Befehls, der angibt, wie die Inhalte des Parameters command interpretiert. Der Befehlstyp kann entweder ein Wert der DataCommandType-Enumeration oder ein benutzerdefinierter Befehlstyp sein, der einem Anbieter definiert wurde, der übergeben werden kann, indem eine Umwandlung einer ganzen Zahl der Enumeration DataCommandType erzwingt.

Rückgabewert

Typ: Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataReader
Ein IVsDataReader-Objekt.Dieses Objekt stellt nur online Vorwärts-Recordsets, schreibgeschützten Datenstream, der das Layout von Elementen und von Blöcken h. das Schema beschrieben, für das Readerobjekt bereit, das nach dem Ausführen des angegebenen Befehls zurückgegeben wird.

Implementiert

IVsDataCommand.DeriveSchema(String, DataCommandType)

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	Der command-Parameter ist nullein Nullverweis (Nothing in Visual Basic).

Hinweise

Das Schema des Datenreaders, muss sich der zurückgegeben wird nach einem bestimmten Format darin, liegt. Für jedes Ergebnis, das zurückgegeben wird, wenn Sie den Befehl ausführen, sollte es ein Ergebnis im Datenreader geben. Jedes dieser Ergebnisse sollte Blöcke enthalten, die die Elemente beschrieben, die zurückgegeben werden, wenn Sie den Befehl ausführen. Die Beschreibung sollte die folgenden Elemente enthalten:

Name (Zeichenfolge): der Name des Elements.
Ordnungszahl (Int32): die Position des Elements.
UserDataType (Zeichenfolge): der Benutzerdatentyp des Elements, (beispielsweise "myType").
NativeDataType (Zeichenfolge): dem systemeigenen Datentyp des Elements (beispielsweise, nvarchar "").
ProviderDataType (Int32): der Anbieterdatentyp des Elements (beispielsweise, System.Data.SqlDbType.NVarChar).
ProviderDbType (Int32): der generische ADO.NET-Datentyp des Elements (beispielsweise, System.Data.DbType.StringFixedLength).
FrameworkDataType (Typ): .NET Framework-Datentyp des Elements, (z System.Int32).
Länge (Int32): die maximale Länge des Elements, sofern zutreffend.
Genauigkeit (Int32): die Genauigkeit des Elements, sofern zutreffend.
Skalierung (Int32): die Skalierung des Elements, sofern zutreffend.
Auf NULL festlegbar (boolesch): die NULL-Zulässigkeit des Elements.

Diese Elemente, die ein Anbieter nicht unterstützt (beispielsweise, einige Formen des Datentyps) sollten vorhanden jedoch auf nullein Nullverweis (Nothing in Visual Basic) festgelegt sein.

Hinweis

Andere Ausnahmen, die auftreten, geben an, dass die Schemaableitung für einen Anbieter-angegebenen Grund fehlgeschlagen ist.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.