実装されるデータ ソースで指定されたコマンドを準備します; コマンドは、複数回さまざまなパラメーターの実行できます。
名前空間: Microsoft.VisualStudio.Data.Framework
アセンブリ: Microsoft.VisualStudio.Data.Framework (Microsoft.VisualStudio.Data.Framework.dll 内)
構文
'宣言
Public Function Prepare ( _
command As String, _
commandType As DataCommandType, _
parameters As IVsDataParameter() _
) As String
public string Prepare(
string command,
DataCommandType commandType,
IVsDataParameter[] parameters
)
public:
virtual String^ Prepare(
String^ command,
DataCommandType commandType,
array<IVsDataParameter^>^ parameters
) sealed
abstract Prepare :
command:string *
commandType:DataCommandType *
parameters:IVsDataParameter[] -> string
override Prepare :
command:string *
commandType:DataCommandType *
parameters:IVsDataParameter[] -> string
public final function Prepare(
command : String,
commandType : DataCommandType,
parameters : IVsDataParameter[]
) : String
パラメーター
- command
型 : System.String
実装するデータ ソースに固有のコマンド。
- commandType
型 : Microsoft.VisualStudio.Data.Services.SupportEntities.DataCommandType
command のパラメーターの内容を解釈する方法を指定するコマンドの型。コマンドの型は DataCommandType の列挙体からの値、整数変換をから DataCommandType の列挙型にキャストを渡すことができるプロバイダーで定義したカスタム コマンドの型であることができます。
- parameters
型 : array<Microsoft.VisualStudio.Data.Services.SupportEntities.IVsDataParameter[]
指定したコマンドのコマンド パラメーターを表す IVsDataParameter のオブジェクト配列は入力します。
戻り値
型 : System.String
ExecuteWithoutResults のメソッドまたは Execute にコマンドの種類 Preparedの使用後にを渡すことができる準備したコマンドの識別子。
実装
IVsDataCommand.Prepare(String, DataCommandType, array<IVsDataParameter[])
例外
| 例外 | 条件 |
|---|---|
| ArgumentNullException | command パラメーターが nullnull 参照 (Visual Basic では Nothing) です。 |
| ArgumentOutOfRangeException | commandTimeout パラメーターが -1 未満です。 |
解説
例外は、ほかの準備がプロバイダー指定された理由で失敗したことを示します。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。