SqlParameterCollection Classe

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v5.2.0

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à

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 un oggetto DataSet e sia SqlDataAdapter già stato creato con lo schema, i comandi e la connessione appropriati.

using Microsoft.Data.SqlClient;
using System.Xml;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet categoriesDataSet;
    protected DataGrid dataGrid1;
    protected SqlDataAdapter categoriesAdapter;


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

    }
}

Commenti

Se il comando contiene un'istruzione SQL ad hoc, anziché un nome di stored procedure, il numero dei parametri della raccolta deve essere uguale al numero di segnaposto dei parametri all'interno del testo del comando o 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 dal valore 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.
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, 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.
GetEnumerator()	Restituisce un enumeratore che esegue l'iterazione di SqlParameterCollection.
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.
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.
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.