OracleParameterCollection Classe

Definizione

Spazio dei nomi:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Rappresenta una raccolta di parametri relativi a un oggetto OracleCommand, nonché i rispettivi mapping alle colonne in un oggetto DataSet. La classe non può essere ereditata.

public ref class OracleParameterCollection sealed : System::Data::Common::DbParameterCollection

[System.ComponentModel.ListBindable(false)]
public sealed class OracleParameterCollection : System.Data.Common.DbParameterCollection

[<System.ComponentModel.ListBindable(false)>]
type OracleParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class OracleParameterCollection
Inherits DbParameterCollection

Ereditarietà

Object

MarshalByRefObject

DbParameterCollection

OracleParameterCollection

Attributi

ListBindableAttribute

Esempio

Nell'esempio seguente vengono create più istanze di OracleParameter tramite all'interno OracleParameterCollection di OracleDataAdapter. Questi parametri vengono usati per selezionare i dati all'interno del database e quindi inserire i dati in DataSet. In questo esempio si presuppone che un DataSet oggetto e OracleDataAdapter sia già stato creato con lo schema, i comandi e la connessione appropriati.

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

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

Commenti

Quando si usano parametri denominati, il numero di parametri nella raccolta deve essere uguale al numero di parametri denominati all'interno del testo del comando o del provider di dati .NET Framework per Oracle genera un errore.

Il provider di dati .NET Framework per Oracle non supporta il segnaposto interrogativo (?) per passare i parametri a un'istruzione SQL chiamata da un OracleCommand oggetto .CommandType.Text In questo caso, i parametri denominati devono essere usati. Ad esempio:

SELECT * FROM Customers WHERE CustomerID = :pCustomerID  

Quando si usano parametri denominati in un'istruzione SQL denominata da OracleCommandCommandType.Text, è necessario precedere il nome del parametro con due punti (:). Tuttavia, in una stored procedure o quando si fa riferimento a un parametro denominato altrove nel codice (ad esempio, quando si aggiungono OracleParameter oggetti alla Parameters proprietà), non precedere il parametro denominato con due punti (:). Il provider di dati fornisce automaticamente i due punti.

Costruttori

OracleParameterCollection()

Inizializza una nuova istanza della classe OracleParameterCollection.

Proprietà

Count	Restituisce un intero contenente il numero di elementi dell'insieme OracleParameterCollection. Di sola lettura.
IsFixedSize	Ottiene un valore che indica se le dimensioni dell'oggetto OracleParameterCollection sono fisse.
IsReadOnly	Ottiene un valore che indica se OracleParameterCollection è di sola lettura.
IsSynchronized	Ottiene un valore che indica se OracleParameterCollection è sincronizzato.
Item[Int32]	Ottiene o imposta l'oggetto OracleParameter in corrispondenza dell'indice specificato.
Item[String]	Ottiene o imposta la classe OracleParameter con il nome specificato.
SyncRoot	Ottiene un oggetto che può essere usato per sincronizzare l'accesso a OracleParameterCollection.

Metodi

Add(Object)	Aggiunge l'oggetto OracleParameter specificato all'oggetto OracleParameterCollection.
Add(OracleParameter)	Aggiunge l'oggetto OracleParameter specificato alla raccolta OracleParameterCollection.
Add(String, Object)	Obsoleti. Aggiunge una classe OracleParameter alla classe OracleParameterCollection, dati il nome e il valore del parametro.
Add(String, OracleType)	Aggiunge un oggetto OracleParameter all'oggetto OracleParameterCollection, dati il nome del parametro e il tipo di dati.
Add(String, OracleType, Int32)	Aggiunge una classe OracleParameter alla classe OracleParameterCollection, dati il nome del parametro, il tipo di dati e la lunghezza della colonna.
Add(String, OracleType, Int32, String)	Aggiunge una classe OracleParameter alla classe OracleParameterCollection, dati il nome del parametro, il tipo di dati, la lunghezza della colonna e il nome della colonna di origine.
AddRange(Array)	Aggiunge una matrice di valori alla fine di OracleParameterCollection.
AddRange(OracleParameter[])	Aggiunge una matrice di valori OracleParameter alla fine di OracleParameterCollection.
AddWithValue(String, Object)	Aggiunge un valore alla fine di OracleParameterCollection.
Clear()	Rimuove tutti gli oggetti OracleParameter da OracleParameterCollection.
Contains(Object)	Determina se l'oggetto specificato è incluso nell'insieme OracleParameterCollection.
Contains(OracleParameter)	Determina se l'oggetto OracleParameter specificato è presente nell'insieme OracleParameterCollection.
Contains(String)	Indica se nell’insieme è contenuto un oggetto OracleParameter con il nome specificato.
CopyTo(Array, Int32)	Copia tutti gli elementi dell'oggetto OracleParameterCollection corrente nell'oggetto Array unidimensionale specificato a partire dall'indice di destinazione Array indicato.
CopyTo(OracleParameter[], Int32)	Copia tutti gli elementi dell'oggetto OracleParameterCollection corrente nell'oggetto OracleParameterCollection specificato, a partire dall'indice di destinazione indicato.
CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetEnumerator()	Restituisce un enumeratore che esegue l'iterazione di OracleParameterCollection.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetParameter(Int32)	Restituisce l'oggetto DbParameter in corrispondenza dell'indice specificato nella raccolta. (Ereditato da DbParameterCollection)
GetParameter(String)	Restituisce l'oggetto DbParameter con il nome specificato. (Ereditato da DbParameterCollection)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(Object)	Ottiene la posizione della classe Object specificata all'interno dell'insieme.
IndexOf(OracleParameter)	Ottiene la posizione della classe OracleParameter specificata all'interno dell'insieme.
IndexOf(String)	Ottiene la posizione dell'oggetto OracleParameter specificato con il nome indicato.
InitializeLifetimeService()	Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
Insert(Int32, Object)	Inserisce un oggetto Object in OracleParameterCollection in corrispondenza dell'indice specificato.
Insert(Int32, OracleParameter)	Inserisce un oggetto OracleParameter in OracleParameterCollection in corrispondenza dell'indice specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
Remove(Object)	Rimuove l'oggetto OracleParameter specificato dalla raccolta.
Remove(OracleParameter)	Rimuove l'oggetto OracleParameter specificato dalla raccolta.
RemoveAt(Int32)	Rimuove l'oggetto OracleParameter in corrispondenza dell'indice specificato dalla raccolta.
RemoveAt(String)	Rimuove dalla raccolta l'oggetto OracleParameter con il nome specificato.
SetParameter(Int32, DbParameter)	Imposta l'oggetto DbParameter in corrispondenza dell'indice specificato su un nuovo valore. (Ereditato da DbParameterCollection)
SetParameter(String, DbParameter)	Imposta l'oggetto DbParameter con il nome specificato su un nuovo valore. (Ereditato da DbParameterCollection)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IDataParameterCollection.Item[String]	Ottiene o imposta il parametro in corrispondenza dell'indice specificato. (Ereditato da DbParameterCollection)
IList.Item[Int32]	Ottiene o imposta l'elemento in corrispondenza dell'indice specificato. (Ereditato da DbParameterCollection)

Metodi di estensione

Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un oggetto IEnumerable in un oggetto IQueryable.