SqlParameterCollection Classe

Definizione

Spazio dei nomi:

System.Data.SqlClient

Assembly:

System.Data.dll

Rappresenta una raccolta di parametri associati a un oggetto SqlCommand e i rispettivi mapping alle colonne in un oggetto DataSet. La classe non può essere ereditata.

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

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

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

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

Ereditarietà

Object

MarshalByRefObject

DbParameterCollection

SqlParameterCollection

Attributi

ListBindableAttribute

Esempio

Nell'esempio seguente vengono create più istanze di SqlParameter tramite la SqlParameterCollection raccolta . I parametri vengono usati per selezionare i dati all'interno dell'origine dati e popolare .DataSet Questo codice presuppone che sia già stato creato un oggetto DataSet e SqlDataAdapter con lo schema, i comandi e la connessione appropriati.

public void AddSqlParameters()
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...

  categoriesAdapter.SelectCommand.Parameters.Add(
    "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
  categoriesAdapter.SelectCommand.Parameters.Add(
    "@SerialNum", SqlDbType.Int).Value = 239;
  categoriesAdapter.Fill(categoriesDataSet);
}

Public Sub AddSqlParameters()
    ' ...
    ' create categoriesDataSet and categoriesAdapter
    ' ...
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters"
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@SerialNum", SqlDbType.Int).Value = 239
    
    categoriesAdapter.Fill(categoriesDataSet)
End Sub

Commenti

Se il comando contiene un'istruzione SQL ad hoc, anziché un nome di stored procedure, il numero dei parametri nella raccolta deve essere uguale al numero di segnaposto del parametro all'interno del testo del comando oppure SQL Server genera un errore. Con una stored procedure, è necessario specificare tutti i parametri dichiarati nella stored procedure senza un valore predefinito. I parametri dichiarati con un valore predefinito sono facoltativi. In questo modo è possibile specificare un valore diverso da quello predefinito.

Per altre informazioni con codice di esempio aggiuntivo che illustra come usare i parametri, vedere Comandi e parametri.

Proprietà

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

Metodi

Add(Object)	Aggiunge l'oggetto SqlParameter specificato all'oggetto SqlParameterCollection.
Add(SqlParameter)	Aggiunge l'oggetto SqlParameter specificato all'oggetto SqlParameterCollection.
Add(String, Object)	Obsoleti. Aggiunge l'oggetto SqlParameter specificato all'oggetto SqlParameterCollection.
Add(String, SqlDbType)	Aggiunge un oggetto SqlParameter a SqlParameterCollection quando vengono specificati il nome di parametro e il tipo di dati.
Add(String, SqlDbType, Int32)	Aggiunge un oggetto SqlParameter all'insieme SqlParameterCollection, dati il nome del parametro specificato e la classe SqlDbType e le dimensioni.
Add(String, SqlDbType, Int32, String)	Aggiunge un oggetto SqlParameter a SqlParameterCollection con il nome di parametro, il tipo di dati e la lunghezza di colonna.
AddRange(Array)	Aggiunge una matrice di valori alla fine di SqlParameterCollection.
AddRange(SqlParameter[])	Aggiunge una matrice di valori SqlParameter alla fine di SqlParameterCollection.
AddWithValue(String, Object)	Aggiunge un valore alla fine di SqlParameterCollection.
Clear()	Rimuove tutti gli oggetti SqlParameter da SqlParameterCollection.
Contains(Object)	Determina se l'oggetto Object specificato è contenuto in SqlParameterCollection.
Contains(SqlParameter)	Determina se l'oggetto SqlParameter specificato è contenuto in SqlParameterCollection.
Contains(String)	Determina se il nome del parametro specificato si trova in SqlParameterCollection.
CopyTo(Array, Int32)	Copia tutti gli elementi dell'oggetto SqlParameterCollection corrente nell'oggetto Array unidimensionale specificato a partire dall'indice di destinazione Array indicato.
CopyTo(SqlParameter[], Int32)	Copia tutti gli elementi dell'oggetto SqlParameterCollection corrente nell'oggetto SqlParameterCollection 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 SqlParameterCollection.
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(SqlParameter)	Ottiene la posizione della classe SqlParameter specificata all'interno dell'insieme.
IndexOf(String)	Ottiene la posizione dell'oggetto SqlParameter 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 SqlParameterCollection in corrispondenza dell'indice specificato.
Insert(Int32, SqlParameter)	Inserisce un oggetto SqlParameter in SqlParameterCollection 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 SqlParameter specificato dalla raccolta.
Remove(SqlParameter)	Rimuove l'oggetto SqlParameter specificato dalla raccolta.
RemoveAt(Int32)	Rimuove l'oggetto SqlParameter da SqlParameterCollection in corrispondenza dell'indice specificato.
RemoveAt(String)	Rimuove l'oggetto SqlParameter da SqlParameterCollection in corrispondenza del nome di 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

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.

Vedi anche

• Comandi e parametri (ADO.NET)
• Parametri DataAdapter (ADO.NET)
• Uso del provider di dati .NET Framework per SQL Server
• Panoramica di ADO.NET