Data.Win.ADODB.TParameters.ParamByName

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

Voir aussi