OleDbParameterCollection Classe

Definizione

Spazio dei nomi:

System.Data.OleDb

Assembly:

System.Data.dll

Rappresenta una raccolta di parametri rilevanti per un oggetto OleDbCommand e i rispettivi mapping alle colonne in un oggetto DataSet.

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

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

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

Public NotInheritable Class OleDbParameterCollection
Inherits DbParameterCollection

Ereditarietà

Object

MarshalByRefObject

DbParameterCollection

OleDbParameterCollection

Attributi

ListBindableAttribute

Esempio

Nell'esempio seguente vengono create più istanze di OleDbParameter tramite la OleDbParameterCollection raccolta all'interno di OleDbDataAdapter. Questi parametri vengono usati per selezionare i dati all'interno dell'origine dati e inserire i dati in DataSet. In questo esempio si presuppone che un DataSet oggetto e sia OleDbDataAdapter già stato creato con lo schema, i comandi e la connessione appropriati.

public DataSet GetDataSetFromAdapter(
    DataSet dataSet, string connectionString, string queryString)
{
    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter =
            new OleDbDataAdapter(queryString, connection);

        // Set the parameters.
        adapter.SelectCommand.Parameters.Add(
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters";
        adapter.SelectCommand.Parameters.Add(
            "@SerialNum", OleDbType.Integer).Value = 239;

        // Open the connection and fill the DataSet.
        try
        {
            connection.Open();
            adapter.Fill(dataSet);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
    return dataSet;
}

Public Function GetDataSetFromAdapter( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter(queryString, connection)

        ' Set the parameters.
        adapter.SelectCommand.Parameters.Add( _
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters"
        adapter.SelectCommand.Parameters.Add( _
         "@SerialNum", OleDbType.Integer).Value = 239

        ' Open the connection and fill the DataSet.
        Try
            connection.Open()
            adapter.Fill(dataSet)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using

    Return dataSet
End Function

Commenti

Il numero di parametri nella raccolta deve essere uguale al numero di segnaposto dei parametri all'interno del testo del comando; in caso contrario, il provider di dati di .NET Framework per OLE DB potrebbe generare un errore.

Proprietà

Nome	Descrizione
Count	Restituisce un numero intero che contiene il numero di elementi nell'oggetto OleDbParameterCollection. Read-only.
IsFixedSize	Ottiene un valore che indica se ha OleDbParameterCollection una dimensione fissa. Read-only.
IsReadOnly	Ottiene un valore che indica se l'oggetto OleDbParameterCollection è di sola lettura.
IsSynchronized	Ottiene un valore che indica se l'oggetto OleDbParameterCollection è sincronizzato. Read-only.
Item[Int32]	Ottiene o imposta l'oggetto OleDbParameter in corrispondenza dell'indice specificato.
Item[String]	Ottiene o imposta l'oggetto OleDbParameter con il nome specificato.
SyncRoot	Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso al OleDbParameterCollection. Read-only.

Metodi

Nome	Descrizione
Add(Object)	Aggiunge l'oggetto specificato OleDbParameter all'oggetto OleDbParameterCollection.
Add(OleDbParameter)	Aggiunge l'oggetto specificato OleDbParameter all'oggetto OleDbParameterCollection.
Add(String, Object)	Obsoleti. Aggiunge un OleDbParameter oggetto all'oggetto OleDbParameterCollection specificato il nome e il valore del parametro.
Add(String, OleDbType, Int32, String)	Aggiunge un OleDbParameter oggetto al nome del OleDbParameterCollection parametro, al tipo di dati, alla lunghezza della colonna e al nome della colonna di origine specificati.
Add(String, OleDbType, Int32)	Aggiunge un OleDbParameter oggetto all'oggetto OleDbParameterCollection specificato per il nome del parametro, il tipo di dati e la lunghezza della colonna.
Add(String, OleDbType)	Aggiunge un OleDbParameter oggetto a , in base al OleDbParameterCollectionnome del parametro e al tipo di dati.
AddRange(Array)	Aggiunge una matrice di valori alla fine di OleDbParameterCollection.
AddRange(OleDbParameter[])	Aggiunge una matrice di OleDbParameter valori alla fine di OleDbParameterCollection.
AddWithValue(String, Object)	Aggiunge un valore alla fine dell'oggetto OleDbParameterCollection.
Clear()	Rimuove tutti gli OleDbParameter oggetti da OleDbParameterCollection.
Contains(Object)	Determina se l'oggetto specificato Object si trova in questo OleDbParameterCollectionoggetto .
Contains(OleDbParameter)	Determina se l'oggetto specificato OleDbParameter si trova in questo OleDbParameterCollectionoggetto .
Contains(String)	Determina se l'oggetto specificato String si trova in questo OleDbParameterCollectionoggetto .
CopyTo(Array, Int32)	Copia tutti gli elementi dell'oggetto corrente OleDbParameterCollection nell'oggetto unidimensionale Array specificato a partire dall'indice di destinazione Array specificato.
CopyTo(OleDbParameter[], Int32)	Copia tutti gli elementi dell'oggetto corrente OleDbParameterCollection nell'oggetto specificato OleDbParameterCollection a partire dall'indice di destinazione specificato.
CreateObjRef(Type)	Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare 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 scorre l'oggetto OleDbParameterCollection.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
GetParameter(Int32)	Restituisce l'oggetto DbParameter in corrispondenza dell'indice specificato nell'insieme. (Ereditato da DbParameterCollection)
GetParameter(String)	Restituisce DbParameter l'oggetto con il nome specificato. (Ereditato da DbParameterCollection)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
IndexOf(Object)	Posizione dell'oggetto specificato Object all'interno dell'insieme.
IndexOf(OleDbParameter)	Ottiene la posizione dell'oggetto specificato OleDbParameter all'interno dell'insieme.
IndexOf(String)	Ottiene la posizione dell'oggetto specificato OleDbParameter con il nome specificato.
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 nell'oggetto OleDbParameterCollection in corrispondenza dell'indice specificato.
Insert(Int32, OleDbParameter)	Inserisce un OleDbParameter oggetto nell'oggetto OleDbParameterCollection in corrispondenza dell'indice specificato.
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject)
Remove(Object)	Rimuove l'oggetto Object da OleDbParameterCollection.
Remove(OleDbParameter)	Rimuove l'oggetto OleDbParameterOleDbParameterCollectionda .
RemoveAt(Int32)	Rimuove l'oggetto OleDbParameterOleDbParameterCollection da in corrispondenza dell'indice specificato.
RemoveAt(String)	Rimuove l'oggetto OleDbParameterOleDbParameterCollection da in corrispondenza del nome del parametro 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

Nome	Descrizione
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

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

Vedi anche

• Uso dei comandi
• Uso di parametri con un oggetto DataAdapter