OracleCommand.Parameters OracleCommand.Parameters OracleCommand.Parameters OracleCommand.Parameters Property

Definition

public:
 property System::Data::OracleClient::OracleParameterCollection ^ Parameters { System::Data::OracleClient::OracleParameterCollection ^ get(); };
public System.Data.OracleClient.OracleParameterCollection Parameters { get; }
member this.Parameters : System.Data.OracleClient.OracleParameterCollection
Public ReadOnly Property Parameters As OracleParameterCollection

Eigenschaftswert

Die Parameter der SQL-Anweisung bzw. der gespeicherten Prozedur.The parameters of the SQL statement or stored procedure. Der Standard ist eine leere Auflistung.The default is an empty collection.

Beispiele

Im folgenden Beispiel wird ein OracleCommand erstellt und die zugehörigen Parameter angezeigt.The following example creates an OracleCommand and displays its parameters. Um dies zu erreichen, wird an die- OracleConnectionMethode ein, eine Abfrage Zeichenfolge, die eine SQL SELECT-Anweisung OracleParameter ist, und ein Array von-Objekten übermittelt.To accomplish this, the method is passed an OracleConnection, a query string that is an SQL SELECT statement, and an array of OracleParameter objects.

public void CreateOracleCommand(OracleConnection connection,
    string queryString, OracleParameter[] myParamArray)
{

    OracleCommand command = new OracleCommand(queryString, connection);
    command.CommandText = 
        "SELECT * FROM Emp WHERE Job = :pJob AND Sal = :pSal";

    for (int j = 0; j < myParamArray.Length; j++)
        command.Parameters.Add(myParamArray[j]);

    string message = "";

    for (int i = 0; i < command.Parameters.Count; i++) 
        message += command.Parameters[i].ToString() + "\n";

    Console.WriteLine(message);

    using (OracleDataReader row = command.ExecuteReader()) 
    {
        while(row.Read()) 
        {
            Console.WriteLine(row.GetValue(0));
        }
    }
}

Public Sub CreateOracleCommand(ByVal connection As OracleConnection, _
ByVal queryString As String, ByVal prmArray() As OracleParameter)

    Dim command As New OracleCommand(queryString, connection)
    command.CommandText = _
        "SELECT * FROM Emp WHERE Job = :pJob AND Sal = :pSal"

    Dim j As Integer
    For j = 0 To prmArray.Length - 1
        command.Parameters.Add(prmArray(j))
    Next j

    Dim message As String = ""
    Dim i As Integer
    For i = 0 To command.Parameters.Count - 1
        message += command.Parameters(i).ToString() + ControlChars.Cr
    Next i

    Console.WriteLine(message)

    Dim reader As OracleDataReader = command.ExecuteReader
    While reader.Read
        Console.WriteLine(reader.GetValue(0))
    End While

End Sub

Hinweise

Wenn die CommandType -Eigenschaft auf StoredProcedurefestgelegt ist CommandText , sollte die-Eigenschaft auf den Namen der gespeicherten Prozedur festgelegt werden.When the CommandType property is set to StoredProcedure, the CommandText property should be set to the name of the stored procedure. Der Benutzer muss möglicherweise die Escapezeichensyntax verwenden, wenn der Name der gespeicherten Prozedur Sonderzeichen enthält.The user may be required to use escape character syntax if the stored procedure name contains any special characters. Der-Befehl führt diese gespeicherte Prozedur aus, wenn Sie eine der Execute-Methoden aufruft.The command executes this stored procedure when you call one of the Execute methods.

Der .NET Framework Datenanbieter für Oracle unterstützt den Platzhalter für Fragezeichen (?) nicht zum Übergeben von Parametern an eine SQL- OracleCommand Anweisung CommandType.Text, die von einem von aufgerufen wird.The .NET Framework Data Provider for Oracle does not support the question mark (?) placeholder for passing parameters to an SQL statement called by an OracleCommand of CommandType.Text. In diesem Fall müssen benannte Parameter verwendet werden.In this case, named parameters must be used. Beispiel:For example:

SELECT * FROM Customers WHERE CustomerID = :pCustomerID  

Wenn Sie benannte Parameter in einer SQL-Anweisung verwenden, OracleCommand die CommandType.Textvon einem von aufgerufen wird, müssen Sie dem Parameternamen einen Doppelpunkt (:).When using named parameters in an SQL statement called by an OracleCommand of CommandType.Text, you must precede the parameter name with a colon (:). In einer gespeicherten Prozedur oder beim Verweis auf einen benannten Parameter an anderer Stelle im Code (z. b. beim Hinzufügen OracleParameter von Objekten Parameters zur-Eigenschaft) ist der benannte Parameter nicht mit einem Doppelpunkt (:).However, in a stored procedure, or when referring to a named parameter elsewhere in your code (for example, when adding OracleParameter objects to the Parameters property), do not precede the named parameter with a colon (:). Der .NET Framework Datenanbieter für Oracle liefert den Doppelpunkt automatisch.The .NET Framework Data Provider for Oracle supplies the colon automatically.

Gilt für:

Siehe auch