OracleParameterCollection-Klasse

Stellt eine Auflistung von Parametern dar, die für einen OracleCommand relevant sind, sowie deren jeweilige Zuordnung zu Spalten in einem DataSet. Die Klasse kann nicht vererbt werden.

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

Syntax

'Declaration
Public NotInheritable Class OracleParameterCollection
    Inherits DbParameterCollection
'Usage
Dim instance As OracleParameterCollection

public sealed class OracleParameterCollection : DbParameterCollection

public ref class OracleParameterCollection sealed : public DbParameterCollection

public final class OracleParameterCollection extends DbParameterCollection

public final class OracleParameterCollection extends DbParameterCollection

Hinweise

Wenn Sie benannte Parameter verwenden, muss die Anzahl der Parameter in der Auflistung mit der Anzahl der benannten Parameter im Befehlstext übereinstimmen, andernfalls löst der .NET Framework-Datenprovider für Oracle einen Fehler aus.

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 Datenprovider stellt den Doppelpunkt automatisch bereit.

Beispiel

Im folgenden Beispiel werden über die OracleParameterCollection im OracleDataAdapter mehrere Instanzen von OracleParameter erstellt. Mithilfe dieser Parameter werden Daten in der Datenbank ausgewählt und anschließend im DataSet platziert. In diesem Beispiel wird davon ausgegangen, dass bereits ein DataSet und ein OracleDataAdapter mit dem entsprechenden Schema, den entsprechenden Befehlen sowie der entsprechenden Verbindung erstellt wurden.

Public Sub AddOracleParameters()
    ' ...
    ' create dataSet and adapter
    ' ...
adapter.SelectCommand.Parameters.Add("pEName", OracleType.VarChar, 80).Value = "Smith"
adapter.SelectCommand.Parameters.Add("pEmpNo", OracleType.Int32).Value = 7369
adapter.Fill(dataSet)
End Sub 

public void AddOracleParameters() 
 {
 // ...
 // create dataSet and adapter
 // ...
   adapter.SelectCommand.Parameters.Add("pEName", OracleType.VarChar, 80).Value = "Smith";
   adapter.SelectCommand.Parameters.Add("pEmpNo", OracleType.Int32).Value = 7369;
   adapter.Fill(dataSet);
 }

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.Data.Common.DbParameterCollection
      System.Data.OracleClient.OracleParameterCollection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

OracleParameterCollection-Member
System.Data.OracleClient-Namespace