OracleCommand.Parameters-Eigenschaft

Ruft die OracleParameterCollection ab.

Namespace: System.Data.OracleClient
Assembly: System.Data.OracleClient (in system.data.oracleclient.dll)

Syntax

'Declaration
Public ReadOnly Property Parameters As OracleParameterCollection
'Usage
Dim instance As OracleCommand
Dim value As OracleParameterCollection

value = instance.Parameters

public OracleParameterCollection Parameters { get; }

public:
property OracleParameterCollection^ Parameters {
    OracleParameterCollection^ get ();
}

/** @property */
public OracleParameterCollection get_Parameters ()

public function get Parameters () : OracleParameterCollection

Eigenschaftenwert

Die Parameter der SQL-Anweisung oder der gespeicherten Prozedur. Der Standardwert ist eine leere Auflistung.

Hinweise

Wenn die CommandType-Eigenschaft auf StoredProcedure festgelegt ist, muss die CommandText-Eigenschaft auf den Namen der gespeicherten Prozedur festgelegt werden. Möglicherweise müssen die Benutzer die Escapezeichensyntax verwenden, wenn der Name der gespeicherten Prozedur Sonderzeichen enthält. Der Befehl führt diese gespeicherte Prozedur aus, wenn Sie eine der Execute-Methoden aufrufen.

Der .NET Framework-Datenanbieter für Oracle unterstützt keinen Fragezeichenplatzhalter (?) beim Übergeben von Parametern an eine SQL-Anweisung, die durch einen OracleCommand von CommandType.Text aufgerufen wird. In diesem Fall müssen benannte Parameter verwendet werden. Beispiel:

SELECT * FROM Customers WHERE CustomerID = :pCustomerID

Wenn Sie benannte Parameter in einer SQL-Anweisung verwenden, die durch einen OracleCommand von CommandType.Text aufgerufen wird, müssen Sie vor dem Parameternamen einen Doppelpunkt (:) einfügen. In einer gespeicherten Prozedur oder bei Verweisen auf einen benannten Parameter an einer anderer Stelle im Code (wenn z. B. der Parameters-Eigenschaft OracleParameter-Objekte hinzugefügt werden) darf vor dem benannten Parameter jedoch kein Doppelpunkt (:) eingefügt werden. Der .NET Framework-Datenanbieter für Oracle stellt den Doppelpunkt automatisch bereit.

Beispiel

Im folgenden Beispiel wird ein OracleCommand erstellt, und seine Parameter werden angezeigt. Dazu werden an die Methode eine OracleConnection, eine Abfragezeichenfolge, die eine SQL-SELECT-Anweisung darstellt, sowie ein Array von OracleParameter-Objekten übergeben.

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

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));
        }
    }
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1

Siehe auch

Referenz

OracleCommand-Klasse
OracleCommand-Member
System.Data.OracleClient-Namespace

Weitere Ressourcen

Arbeiten mit Befehlen