DataCommand.DeriveSchema – metoda (String, DataCommandType, array<IVsDataParameter , Int32)
Schéma vrácené zadaný příkaz pochází.Schéma označuje rozložení položek a bloky v Readeru data.
Obor názvů: Microsoft.VisualStudio.Data.Framework
Sestavení: Microsoft.VisualStudio.Data.Framework (v Microsoft.VisualStudio.Data.Framework.dll)
Syntaxe
'Deklarace
Public Overridable Function DeriveSchema ( _
command As String, _
commandType As DataCommandType, _
parameters As IVsDataParameter(), _
commandTimeout As Integer _
) As IVsDataReader
public virtual IVsDataReader DeriveSchema(
string command,
DataCommandType commandType,
IVsDataParameter[] parameters,
int commandTimeout
)
public:
virtual IVsDataReader^ DeriveSchema(
String^ command,
DataCommandType commandType,
array<IVsDataParameter^>^ parameters,
int commandTimeout
)
abstract DeriveSchema :
command:string *
commandType:DataCommandType *
parameters:IVsDataParameter[] *
commandTimeout:int -> IVsDataReader
override DeriveSchema :
command:string *
commandType:DataCommandType *
parameters:IVsDataParameter[] *
commandTimeout:int -> IVsDataReader
public function DeriveSchema(
command : String,
commandType : DataCommandType,
parameters : IVsDataParameter[],
commandTimeout : int
) : IVsDataReader
Parametry
- command
Typ: System.String
Pro odvození schématu konkrétní zdroj dat pro příkaz.
- commandType
Typ: Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType
Typ příkazu, který určuje, jak interpretovat obsah command parametr.Typ příkazu může buď hodnota z DataCommandType výčtu nebo typ vlastní příkaz definované pomocí zprostředkovatele lze předat vynucením nádech z celé DataCommandType výčtu.
- parameters
Typ: array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]
Pole IVsDataParameter objekty představující typ zadaný příkaz parametry příkazu.
- 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 znamená neomezený časový limit; Hodnota -1 označuje výchozí zprostředkovatel.
Vrácená hodnota
Typ: Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataReader
Objekt IVsDataReader. 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.
Implementuje
IVsDataCommand.DeriveSchema(String, DataCommandType, array<IVsDataParameter[], Int32)
Výjimky
Výjimka | Podmínka |
---|---|
ArgumentNullException | The command parameter is nullodkaz null (Nothing v jazyce Visual Basic). |
ArgumentOutOfRangeException | commandTimeout Je menší než parametr. |
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ý bude vrácena při spuště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é budou vráceny při spuště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.SqlDbType.NVarChar).
ProviderDbType (Int32): Obecný ADO.NET 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 zboží.
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í schématu 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.