SqlParameterCollection Classe

Riferimento

Definizione

Spazio dei nomi:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

public ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection, System::Collections::IList

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

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : MarshalByRefObject, System.Collections.IList, System.Data.IDataParameterCollection

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

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

type SqlParameterCollection = class
    inherit DbParameterCollection

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit MarshalByRefObject
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable

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

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Implements IList

Ereditarietà: Object

DbParameterCollection
SqlParameterCollection

Ereditarietà: Object

MarshalByRefObject

DbParameterCollection
SqlParameterCollection

Ereditarietà: Object

MarshalByRefObject
SqlParameterCollection

Attributi: ListBindableAttribute

Implementazioni: ICollection IEnumerable IList IDataParameterCollection

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 dei parametri 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.
IsFixedSize	Specifica se la raccolta ha dimensioni fisse. (Ereditato da DbParameterCollection)
IsReadOnly	Ottiene un valore che indica se SqlParameterCollection è di sola lettura.
IsReadOnly	Specifica se la raccolta è di sola lettura. (Ereditato da DbParameterCollection)
IsSynchronized	Ottiene un valore che indica se SqlParameterCollection è sincronizzato.
IsSynchronized	Specifica se la raccolta è sincronizzata. (Ereditato da DbParameterCollection)
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)	Obsoleta. Obsoleta. 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()	Obsoleta. 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()	Obsoleta. 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

ICollection.IsSynchronized	Ottiene un valore che indica se l'accesso a ICollection è sincronizzato (thread-safe). (Ereditato da DbParameterCollection)
IDataParameterCollection.Item[String]	Ottiene o imposta il parametro in corrispondenza dell'indice specificato. (Ereditato da DbParameterCollection)
IList.IsFixedSize	Ottiene un valore che indica se IList ha dimensioni fisse. (Ereditato da DbParameterCollection)
IList.IsReadOnly	Ottiene un valore che indica se IList è di sola lettura. (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.

Si applica a