SqlParameterCollection Classe

Definizione

Spazio dei nomi:
System.Data.SqlClient
Assembly:
System.Data.dll

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

public ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection
public ref class SqlParameterCollection sealed : 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)>]
type SqlParameterCollection = class
    inherit MarshalByRefObject
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable
[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection
Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Ereditarietà
Object
MarshalByRefObject
SqlParameterCollection
Ereditarietà
Object
MarshalByRefObject
DbParameterCollection
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 DataSet oggetto 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à

Nome Descrizione
Count

Restituisce un valore Integer che contiene il numero di elementi nell'oggetto SqlParameterCollection. Sola lettura.
IsFixedSize

Ottiene un valore che indica se ha SqlParameterCollection una dimensione fissa.
IsReadOnly

Ottiene un valore che indica se l'oggetto SqlParameterCollection è di sola lettura.
IsSynchronized

Ottiene un valore che indica se l'oggetto SqlParameterCollection è sincronizzato.
Item[Int32]

Ottiene l'oggetto SqlParameter in corrispondenza dell'indice specificato.
Item[String]

Ottiene l'oggetto SqlParameter con il nome specificato.
SyncRoot

Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso al SqlParameterCollection.

Metodi

Nome Descrizione
Add(Object)

Aggiunge l'oggetto specificato SqlParameter all'oggetto SqlParameterCollection.
Add(SqlParameter)

Aggiunge l'oggetto specificato SqlParameter all'oggetto SqlParameterCollection.
Add(String, Object)
Obsoleti.

Aggiunge l'oggetto specificato SqlParameter all'oggetto SqlParameterCollection.
Add(String, SqlDbType, Int32, String)

Aggiunge un SqlParameter oggetto a SqlParameterCollection con il nome del parametro, il tipo di dati e la lunghezza della colonna.
Add(String, SqlDbType, Int32)

Aggiunge un SqlParameter oggetto a , in base al nome SqlDbType e alle SqlParameterCollectiondimensioni del parametro specificati.
Add(String, SqlDbType)

Aggiunge un SqlParameter oggetto all'oggetto SqlParameterCollection specificato per il nome del parametro e il tipo di dati.
AddRange(Array)

Aggiunge una matrice di valori alla fine di SqlParameterCollection.
AddRange(SqlParameter[])

Aggiunge una matrice di SqlParameter valori alla fine di SqlParameterCollection.
AddWithValue(String, Object)

Aggiunge un valore alla fine dell'oggetto SqlParameterCollection.
Clear()

Rimuove tutti gli SqlParameter oggetti da SqlParameterCollection.
Contains(Object)

Determina se l'oggetto specificato Object si trova in questo SqlParameterCollectionoggetto .
Contains(SqlParameter)

Determina se l'oggetto specificato SqlParameter si trova in questo SqlParameterCollectionoggetto .
Contains(String)

Determina se il nome del parametro specificato si trova in questo SqlParameterCollectionoggetto .
CopyTo(Array, Int32)

Copia tutti gli elementi dell'oggetto corrente SqlParameterCollection nell'oggetto unidimensionale Array specificato a partire dall'indice di destinazione Array specificato.
CopyTo(SqlParameter[], Int32)

Copia tutti gli elementi dell'oggetto corrente SqlParameterCollection nell'oggetto specificato SqlParameterCollection 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 SqlParameterCollection.
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)

Ottiene la posizione dell'oggetto specificato Object all'interno dell'insieme.
IndexOf(SqlParameter)

Ottiene la posizione dell'oggetto specificato SqlParameter all'interno dell'insieme.
IndexOf(String)

Ottiene la posizione dell'oggetto specificato SqlParameter 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 SqlParameterCollection in corrispondenza dell'indice specificato.
Insert(Int32, SqlParameter)

Inserisce un SqlParameter oggetto nell'oggetto SqlParameterCollection 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 specificato SqlParameter dalla raccolta.
Remove(SqlParameter)

Rimuove l'oggetto specificato SqlParameter dalla raccolta.
RemoveAt(Int32)

Rimuove l'oggetto SqlParameterSqlParameterCollection da in corrispondenza dell'indice specificato.
RemoveAt(String)

Rimuove l'oggetto SqlParameterSqlParameterCollection 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.

Si applica a

Vedi anche