指定されたコマンドから返されるスキーマを取得します。スキーマは、データ リーダーの項目とブロックのレイアウトを示します。
名前空間: Microsoft.VisualStudio.Data.Framework
アセンブリ: Microsoft.VisualStudio.Data.Framework (Microsoft.VisualStudio.Data.Framework.dll 内)
構文
'宣言
Public Function DeriveSchema ( _
command As String, _
commandType As DataCommandType, _
parameters As IVsDataParameter() _
) As IVsDataReader
public IVsDataReader DeriveSchema(
string command,
DataCommandType commandType,
IVsDataParameter[] parameters
)
public:
virtual IVsDataReader^ DeriveSchema(
String^ command,
DataCommandType commandType,
array<IVsDataParameter^>^ parameters
) sealed
abstract DeriveSchema :
command:string *
commandType:DataCommandType *
parameters:IVsDataParameter[] -> IVsDataReader
override DeriveSchema :
command:string *
commandType:DataCommandType *
parameters:IVsDataParameter[] -> IVsDataReader
public final function DeriveSchema(
command : String,
commandType : DataCommandType,
parameters : IVsDataParameter[]
) : IVsDataReader
パラメーター
- command
型 : System.String
データ ソースにスキーマの詳細を取得するには、コマンド。
- commandType
型 : Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType
command のパラメーターの内容を解釈する方法を指定するコマンドの型。コマンドの型は DataCommandType の列挙体からの値、整数変換をから DataCommandType の列挙型にキャストを渡すことができるプロバイダーで定義したカスタム コマンドの型であることができます。
- parameters
型 : array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]
指定したコマンドのコマンド パラメーターを表す IVsDataParameter のオブジェクト配列は入力します。
戻り値
型 : Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataReader
IVsDataReader オブジェクト。このオブジェクトは指定されたコマンドを実行したときに返されるリーダーのオブジェクトに項目とブロックのつまり、スキーマのレイアウトを記述する前方スクロール専用、読み取り専用データ ストリームを提供します。
実装
IVsDataCommand.DeriveSchema(String, DataCommandType, array<IVsDataParameter[])
例外
| 例外 | 条件 |
|---|---|
| ArgumentNullException | command パラメーターが nullnull 参照 (Visual Basic では Nothing) です。 |
解説
返されるデータ リーダーのスキーマは、このメソッドによって特定の形式にする必要があります。コマンドを実行するときに返される結果の各ためには、テーブルにデータ リーダーに結果が表示されます。これらの結果には、コマンドを実行して返される項目を説明するブロックを含める必要があります。ついては、次の項目を含める必要があります:
名前 (文字列) : 項目の名前。
序数 (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 値許容。
プロバイダーが (たとえば、データ型のあるフォーム) サポートしない項目は、現在 nullnull 参照 (Visual Basic では Nothing)に設定されている必要があります。
[!メモ]
例外は、ほかのスキーマ プロバイダーの派生が指定された理由で失敗したことを示します。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。