Data.Win.ADODB.TParameters.ParamByName
Delphi
function ParamByName(const Value: WideString): TParameter;
C++
TParameter* __fastcall ParamByName(const System::WideString Value);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | Data.Win.ADODB.pas Data.Win.ADODB.hpp |
Data.Win.ADODB | TParameters |
Description
Trouve le paramètre ayant un nom donné.
Utilisez la méthode ParamByName pour trouver un paramètre à partir du nom spécifié dans Value. S'il y en a un correspondant, ParamByName renvoie une référence à l'objet TParameter correspondant. Sinon, la référence à TParameter est à nil (Delphi) ou NULL (C++) et une exception est provoquée. Utilisez cette méthode plutôt qu'une référence directe sur la propriété Items pour éviter de dépendre de l'ordre des entrées.
ADOQuery1.Parameters.ParamByName('Verb').Value := 'propitiate';
ADOQuery1.Open;
ADOQuery1->Parameters->ParamByName("Verb")->Value = "propitiate";
ADOQuery1->Open();
Pour trouver un paramètre par son nom et sans provoquer d'exception si le paramètre n'est pas trouvé, utilisez la méthode FindParam.
Pour trouver plusieurs paramètres en même temps, en recherchant par le nom, utilisez la méthode GetParamList. Pour obtenir uniquement la valeur d'un paramètre nommé, utilisez la propriété ParamValues.
Remarque : ParamByName opère avec les noms des paramètres comme ils apparaissent dans une instruction SQL ou une procédure stockée, et non avec la propriété Name des objets TParameter. Les deux ne doivent pas être confondus.