Data.Win.ADODB.TParameters.ParamByName

Übergeordnet: TParameters

Delphi

function ParamByName(const Value: WideString): TParameter;

C++

TParameter* __fastcall ParamByName(const System::WideString Value);

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	Data.Win.ADODB.pas Data.Win.ADODB.hpp	Data.Win.ADODB	TParameters

Beschreibung

Sucht den Parameter mit dem angegebenen Namen.

Mit ParamByName können Sie nach dem Parameter mit dem in Value angegebenen Namen suchen. Im Erfolgsfall gibt die Methode einen Zeiger auf das betreffende TParameter-Objekt zurück. Andernfalls wird ein nil (Delphi) oder NULL (C++) zurückgegeben und eine Exception ausgelöst. Diese Methode ist einer direkten Referenz auf die Eigenschaft Items vorzuziehen, wenn eine Abhängigkeit von der Reihenfolge der Einträge vermieden werden soll.

ADOQuery1.Parameters.ParamByName('Verb').Value := 'propitiate';
ADOQuery1.Open;

ADOQuery1->Parameters->ParamByName("Verb")->Value = "propitiate";
ADOQuery1->Open();

Mit dieser Methode suchen Sie einen Parameter anhand des Namens, ohne dass eine Exception ausgelöst wird, falls der Parameter nicht gefunden wird.

Wenn mehrere Parameter gleichzeitig gesucht werden sollen, verwenden Sie die Methode GetParamList. Wenn Sie lediglich den Wert eines bestimmten Parameters benötigen, verwenden Sie die Eigenschaft ParamValues.

Anmerkung: ParamByName arbeitet mit den in der SQL-Anweisung oder Stored Procedure verwendeten Parameternamen, nicht mit der Eigenschaft Name der TParameter-Objekte. Verwechseln Sie die beiden Namensangaben nicht.