DataCommand.DeriveSchema – metoda

Článek
10/27/2012

Schéma vrácené zadaný příkaz označující rozložení položek a bloky v Readeru data pochází.

Obor názvů: Microsoft.VisualStudio.Data
Sestavení: Microsoft.VisualStudio.Data (v Microsoft.VisualStudio.Data.dll)

Syntaxe

'Deklarace
Public Overridable Function DeriveSchema ( _
    command As String, _
    commandType As Integer, _
    parameters As DataParameter(), _
    commandTimeout As Integer _
) As DataReader

public virtual DataReader DeriveSchema(
    string command,
    int commandType,
    DataParameter[] parameters,
    int commandTimeout
)

public:
virtual DataReader^ DeriveSchema(
    String^ command, 
    int commandType, 
    array<DataParameter^>^ parameters, 
    int commandTimeout
)

abstract DeriveSchema : 
        command:string * 
        commandType:int * 
        parameters:DataParameter[] * 
        commandTimeout:int -> DataReader 
override DeriveSchema : 
        command:string * 
        commandType:int * 
        parameters:DataParameter[] * 
        commandTimeout:int -> DataReader

public function DeriveSchema(
    command : String, 
    commandType : int, 
    parameters : DataParameter[], 
    commandTimeout : int
) : DataReader

Parametry

command
Typ: System.String
Pro odvození schématu konkrétní zdroj dat pro příkaz.

commandType
Typ: System.Int32
Typ příkazu pro zadaný příkaz určující jak interpretovat obsah command parametr.

parameters
Typ: array<Microsoft.VisualStudio.Data.DataParameter[]
Pole DataParameter objekty typu zadaného příkazu.DDEX provider je vstupní parametr, je stále možné nastavit vlastnosti jednotlivých out a vrácení hodnoty parametrů.Však tyto nebude naplněn, při odvození schématu.

commandTimeout
Typ: System.Int32
Délka čas v sekundách blokovat klienta před zrušením odvození schématu a návratu k volajícímu.Hodnota 0 označuje časový limit; Hodnota -1 označuje výchozí zprostředkovatel.

Vrácená hodnota

Typ: Microsoft.VisualStudio.Data.DataReader
Vrátí DataReader objektu.Tento objekt obsahuje pouze pro předávání, jen pro čtení datového proudu, který popisuje rozložení položek a bloků, schéma, pro čtenáře objekt vrácený po provedením zadaného příkazu.

Výjimky

Výjimka	Podmínka
ArgumentNullException	Příkaz nebo asyncCommandEvents má hodnotu null.
ArgumentException	CommandType určuje neplatný typ.
ArgumentOutOfRangeException	CommandTimeout je menší než -1.
NotSupportedException	Zprostředkovatel nepodporuje tuto metodu.

Poznámky

Schéma reader dat vrácených tímto způsobem postupujte podle určitého formátu.Pro každý výsledek, který by vrátil při provádění příkazu by měla být výsledkem data reader.Každý z těchto výsledků by měl obsahovat bloky, které popisují položky, které by byla vrácena při provádění příkazu.Popis by měl obsahovat následující položky:

Název (řetězec): název položky.
Řadové (Int32): umístění položky.
UserDataType (řetězec): uživatelský typ dat položky (například "myType").
NativeDataType (řetězec): nativní datový typ položky (například "nvarchar").
ProviderDataType (Int32): Zprostředkovatel datový typ položky (například System.Data.DbType.StringFixedLength).
FrameworkDataType (typ): framework datový typ položky (například System.Int32).
Délka (Int32): maximální délku položky, případně.
Přesnost (Int32): přesnost zboží, popřípadě.
Měřítko (Int32): měřítko zboží, popřípadě.
S možnou hodnotou Null (booleovská hodnota): Null položky.

Položky, které zprostředkovatel nepodporuje (například některé formy datový typ) by měly být ale nastaveny null .

[!POZNÁMKA]

Další výjimky, které nastat označují, že odvození parametru se nezdařilo z důvodu zadat zprostředkovatele.

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

DataCommand Třída

Microsoft.VisualStudio.Data – obor názvů

DataReader

Sdílet prostřednictvím