SqlParameterCollection Classe

Definizione

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

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

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

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

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à

Metodi

Si applica a