SqlParameter Classe

Definizione

Rappresenta un parametro di un oggetto SqlCommand e, facoltativamente, il relativo mapping alle colonne di DataSet. La classe non può essere ereditata. Per altre informazioni sui parametri, vedere Configurazione dei parametri.

public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable
[System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
[<System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable
type SqlParameter = class
    inherit DbParameter
    interface IDataParameter
    interface IDbDataParameter
    interface ICloneable
Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable
Ereditarietà
SqlParameter
Attributi
Implementazioni

Esempio

Nell'esempio seguente vengono create più istanze di SqlParameter tramite la SqlParameterCollection raccolta all'interno di SqlDataAdapter. Questi parametri vengono usati per selezionare i dati dall'origine dati e inserire i dati in DataSet. In questo esempio si presuppone che sia già stato creato un oggetto DataSet e SqlDataAdapter usando lo schema, i comandi e la connessione appropriati. Per altre informazioni ed esempi aggiuntivi sull'uso dei parametri, vedere Recupero e modifica dei dati in ADO.NET e Configurazione dei parametri.

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

Ai nomi di parametro non viene applicata la distinzione tra maiuscole e minuscole.

Nota

I parametri senza nome, detti anche ordinali, non sono supportati dal provider di dati .NET Framework per SQL Server.

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

Costruttori

SqlParameter()

Inizializza una nuova istanza della classe SqlParameter.

SqlParameter(String, Object)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro e un valore del nuovo oggetto SqlParameter.

SqlParameter(String, SqlDbType)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro e il tipo di dati.

SqlParameter(String, SqlDbType, Int32)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro, l'oggetto SqlDbType e la dimensione.

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

Inizializza una nuova istanza della classe SqlParameter che usa il nome, il tipo e la dimensione del parametro, un oggetto ParameterDirection, la precisione e la scala del parametro, la colonna di origine, un oggetto DataRowVersion da usare e il valore del parametro.

SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)

Inizializza una nuova istanza della classe SqlParameter che usa il nome, il tipo e la lunghezza del parametro, la direzione, la precisione, la scala, il nome della colonna di origine, uno dei valori di DataRowVersion, un valore booleano per il mapping della colonna di origine, il valore di SqlParameter, il nome del database in cui si trova la raccolta di schemi di questa istanza XML, lo schema relazionale proprietario in cui si trova la raccolta di schemi per questa istanza XML e il nome della raccolta di schemi per questo parametro.

SqlParameter(String, SqlDbType, Int32, String)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro, l'oggetto SqlDbType, le dimensioni e il nome della colonna di origine.

Proprietà

CompareInfo

Ottiene o imposta l'oggetto CompareInfo che definisce le modalità di esecuzione dei confronti tra stringhe per il parametro.

DbType

Ottiene o imposta l'oggetto SqlDbType del parametro.

Direction

Ottiene o imposta un valore che indica se il parametro è di solo input, di solo output, bidirezionale o un parametro di un valore restituito da una stored procedure.

ForceColumnEncryption

Applica la crittografia di un parametro quando si us Always Encrypted. Se SQL Server indica al driver che il parametro non deve essere crittografato, la query che usa il parametro avrà esito negativo. Questa proprietà fornisce protezione aggiuntiva contro attacchi alla sicurezza in cui un SQL Server compromesso fornisce al client metadati di crittografia non corretti, con conseguente rischio di divulgazione dei dati.

IsNullable

Ottiene o imposta un valore che indica se il parametro ammette valori Null. IsNullable non viene usata per convalidare il valore del parametro e non impedisce l'invio o la ricezione di un valore Null quando si esegue un comando.

LocaleId

Ottiene o imposta l'identificatore delle impostazioni locali che determina le convenzioni e la lingua per una determinata area.

Offset

Ottiene o imposta l'offset per la proprietà Value.

ParameterName

Ottiene o imposta il nome di SqlParameter.

Precision

Ottiene o imposta il numero massimo di cifre utilizzate per rappresentare la proprietà Value.

Scale

Ottiene o imposta il numero di posizioni decimali in cui viene risolto Value.

Size

Ottiene o imposta le dimensioni massime in byte dei dati contenuti nella colonna.

SourceColumn

Ottiene o imposta il nome della colonna di origine mappata all'oggetto DataSet e usata per caricare o restituire l'oggetto Value

SourceColumnNullMapping

Ottiene o imposta un valore che indica se la colonna di origine è nullable. Questo consente a SqlCommandBuilder di generare correttamente istruzioni Update per le colonne nullable.

SourceVersion

Ottiene o imposta l'oggetto DataRowVersion da utilizzare per il caricamento di Value

SqlDbType

Ottiene o imposta l'oggetto SqlDbType del parametro.

SqlValue

Ottiene o imposta il valore del parametro come tipo SQL.

TypeName

Ottiene o imposta il nome del tipo per un parametro con valori di tabella.

UdtTypeName

Ottiene o imposta un oggetto string che rappresenta un tipo definito dall'utente come parametro.

Value

Ottiene o imposta il valore del parametro.

XmlSchemaCollectionDatabase

Ottiene il nome del database in cui si trova la raccolta di schemi per questa istanza XML.

XmlSchemaCollectionName

Ottiene il nome della raccolta di schemi per questa istanza XML.

XmlSchemaCollectionOwningSchema

Schema relazionale proprietario in cui si trova la raccolta di schemi per questa istanza XML.

Metodi

ResetDbType()

Reimposta il tipo associato a SqlParameter.

ResetSqlDbType()

Reimposta il tipo associato a SqlParameter.

ToString()

Ottiene una stringa che contiene ParameterName.

Implementazioni dell'interfaccia esplicita

ICloneable.Clone()

Per una descrizione di questo membro, vedere Clone().

Si applica a

Vedi anche