Add(String, Object)-Methode

Fügt der Sammlung ein neues ULParameter-Objekt hinzu, das mit dem angegebenen Parameternamen und -wert erstellt wurde.

Syntax

Visual Basic
Public Function Add( _
   ByVal parameterName As String, _
   ByVal value As Object _
) As ULParameter

C#
public ULParameter Add(
   string  parameterName,
   object value
);

Parameter

parameterName Der Name des Parameters. Verwenden Sie für nicht benannte Parameter eine leere Zeichenfolge ("") oder eine Nullreferenz ("Nothing" in Visual Basic) für diesen Wert. In UltraLite.NET werden Parameternamen nicht von ULCommand verwendet.
value Ein System.Object-Objekt, das der Wert des Parameters sein soll

Rückgabewert

Das neue ULParameter-Objekt

Bemerkungen

Alle Parameter in der Sammlung werden als positionsbasierte Parameter behandelt und müssen der Sammlung in der Reihenfolge der Fragezeichen-Platzhalter im ULCommand.CommandText-Objekt hinzugefügt werden. Der erste Parameter in der Sammlung entspricht dem ersten Fragezeichen in der SQL-Anweisung, der zweite Parameter in der Sammlung entspricht dem zweiten Fragezeichen in der SQL-Anweisung usw. Es müssen mindestens ebenso viele Fragezeichen im ULCommand.CommandText-Objekt enthalten sein wie in der Sammlung. Für fehlende Parameter wird NULL verwendet.

Aufgrund der speziellen Behandlung der 0- und 0.0-Konstanten und der Weise, wie überladene Methoden gelöst werden, wird dringend empfohlen, für Konstantenwerte explizit Typenobjekte festzulegen, wenn diese Methode verwendet wird.

Beispiel

Der folgende Code fügt dem ULCommand-Objekt cmd ein ULParameter-Objekt mit dem Wert 0 hinzu.

' Visual Basic
cmd.Parameters.Add( "", CType( 0, Object ) )

// C#
cmd.Parameters.Add( "", (object)0 );

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.
Senden Sie uns Feedback über diese Seite via E-Mail.