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