DataCommand.DeriveSchema 方法 (String, DataCommandType, array<IVsDataParameter[], Int32)

發行項
05/16/2015

從指定的命令取得結構描述中傳回。結構描述表示項目和區塊配置資料讀取器。

命名空間： Microsoft.VisualStudio.Data.Framework
組件： Microsoft.VisualStudio.Data.Framework (在 Microsoft.VisualStudio.Data.Framework.dll 中)

語法

'宣告
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

參數

command
類型：String

一個命令可以取得結構描述專屬的資料來源。

commandType
類型：Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType

指定如何解譯 command 參數的內容命令的型別。命令型別可能是來自 DataCommandType 列舉的值或提供者所定義的自訂命令類型，可以強制從整數的轉型傳遞至 DataCommandType 列舉。

parameters
類型：array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]

陣列代表指定的命令類型之 IVsDataParameter 物件命令參數。

commandTimeout
類型：Int32

時間，以秒為單位)，在移除結構描述衍生並傳回之前封鎖用戶端傳遞給呼叫端。 0 表示無限逾時的值;值為 -1 表示預設提供者。

傳回值

類型：Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataReader
IVsDataReader 物件。這個物件為讀取器物件提供說明項目和區塊，也就是說，結構描述設定的順向，唯讀資料流，以及執行指定的命令。

實作

IVsDataCommand.DeriveSchema(String, DataCommandType, array<IVsDataParameter[], Int32)

例外狀況

例外狀況	條件
ArgumentNullException	command 參數為 nullnull 參考 (即 Visual Basic 中的 Nothing)。
ArgumentOutOfRangeException	commandTimeout 參數小於 -1。

備註

資料讀取器的結構描述中傳回必須以這個方法會遵循特定格式。對於要傳回的每個結果，當您執行命令，則應該在資料讀取器的單一結果。這些結果都應該包含描述項目中傳回的區塊，當您執行命令時。描述應該包含下列項目:

名稱 (字串):項目的名稱。
序數 (Int32):項目的位置。
UserDataType (字串):項目 (例如，「myType」) 使用者資料型別。
NativeDataType (字串):項目的原生資料型別 (例如，「nvarchar」)。
ProviderDataType (Int32):項目 (例如， System.Data.SqlDbType.NVarChar) 的提供者資料型別。
ProviderDbType (Int32):項目 (例如， System.Data.DbType.StringFixedLength) 的泛型 ADO.NET 資料型別。
FrameworkDataType (型別):項目 (例如， System.Int32) 的架構資料型別。
長度 (Int32):項目的最大長度，如果適用的話)。
精確度 (Int32):項目的精確度，可能的話。
縮放 (Int32):項目的比例，可能的話。
Null (布林值):項目的可為 Null。