Data.Win.ADODB.TParameters.ParamByName
Delphi
function ParamByName(const Value: WideString): TParameter;
C++
TParameter* __fastcall ParamByName(const System::WideString Value);
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | public | Data.Win.ADODB.pas Data.Win.ADODB.hpp |
Data.Win.ADODB | TParameters |
説明
指定された名前のパラメータを検索します。
ParamByName メソッドを使用すると，Value で指定した名前を持つパラメータを検索できます。一致するパラメータを発見すると，ParamByName は一致する TParameter オブジェクトへの参照を返します。そうでない場合，TParameter の参照は nil（Delphi）または NULL（C++）となり，例外が生成されます。Items プロパティへの直接的な参照のかわりにこのメソッドを使用すると，エントリの順序に依存することを避けることができます。
ADOQuery1.Parameters.ParamByName('Verb').Value := 'propitiate';
ADOQuery1.Open;
ADOQuery1->Parameters->ParamByName("Verb")->Value = "propitiate";
ADOQuery1->Open();
パラメータが発見されない場合に例外を生成せずに名前によるパラメータの検索を行うには，FindParam メソッドを使用します。
名前によって一度に複数のパラメータを検索するには，かわりに GetParamList を使用します。指定のパラメータの値だけを取得するには，ParamValues プロパティを使用します。
メモ： ParamByName は，TParameter オブジェクトの Name プロパティではなく，SQL 文またはストアドプロシージャで使用されるパラメータの名前を使用します。これらのパラメータへの 2 つの参照方法は混同しないよう注意してください。