SqlParameter Classe

Definizione

Spazio dei nomi:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Origine:: System.Data.SqlClient.notsupported.cs

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 un parametro di un oggetto SqlCommand e, facoltativamente, il relativo mapping alle DataSet colonne. La classe non può essere ereditata. Per altre informazioni sui parametri, vedere Configurazione dei parametri e dei tipi di dati dei parametri.

Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.

public ref class SqlParameter sealed : System::Data::Common::DbParameter

public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter

public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable

public sealed class SqlParameter : System.Data.Common.DbParameter

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))]
public sealed class SqlParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

type SqlParameter = class
    inherit DbParameter

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))>]
type SqlParameter = class
    inherit MarshalByRefObject
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

Public NotInheritable Class SqlParameter
Inherits DbParameter

Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

Ereditarietà: Object

DbParameter
SqlParameter

Ereditarietà: Object

MarshalByRefObject

DbParameter
SqlParameter

Ereditarietà: Object

MarshalByRefObject
SqlParameter

Attributi: TypeConverterAttribute

Implementazioni: IDataParameter IDbDataParameter ICloneable

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 un DataSet oggetto e sia SqlDataAdapter già stato creato usando lo schema, i comandi e la connessione appropriati. Per altre informazioni e altri esempi sull'uso dei parametri, vedere Retrieving and Modifying Data in ADO.NET and Configuring Parameters and Parameter Data Types.

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

I nomi dei parametri non fanno distinzione tra maiuscole e minuscole.

Note

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

Nome	Descrizione
SqlParameter()	Inizializza una nuova istanza della classe SqlParameter. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
SqlParameter(String, Object)	Inizializza una nuova istanza della SqlParameter classe che utilizza il nome del parametro e un valore del nuovo SqlParameteroggetto . Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Inizializza una nuova istanza della SqlParameter classe che utilizza il nome del parametro, il tipo del parametro, le dimensioni del parametro, un ParameterDirection, la precisione del parametro, la scala del parametro, la colonna di origine, un DataRowVersion oggetto da usare e il valore del parametro. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Inizializza una nuova istanza della SqlParameter classe che utilizza il nome del parametro, il tipo del parametro, la lunghezza del parametro, la direzione, la precisione, la scala, il nome della colonna di origine, uno dei DataRowVersion valori, un valore Boolean per il mapping delle colonne di origine, il valore di `SqlParameter`, il nome del database in cui si trova l'insieme di schemi per questa istanza XML, 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. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, String)	Inizializza una nuova istanza della SqlParameter classe che usa il nome del parametro, le SqlDbTypedimensioni e il nome della colonna di origine. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32)	Inizializza una nuova istanza della SqlParameter classe che utilizza il nome del parametro, l'oggetto SqlDbTypee le dimensioni. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
SqlParameter(String, SqlDbType)	Inizializza una nuova istanza della SqlParameter classe che utilizza il nome del parametro e il tipo di dati. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.

Proprietà

Nome	Descrizione
CompareInfo	Ottiene o imposta l'oggetto che definisce la CompareInfo modalità di esecuzione dei confronti tra stringhe per questo parametro. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
DbType	Ottiene o imposta l'oggetto SqlDbType del parametro . Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
Direction	Ottiene o imposta un valore che indica se il parametro è di sola input, solo output, bidirezionale o un parametro del valore restituito della stored procedure. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
ForceColumnEncryption	Applica la crittografia di un parametro quando si usa Always Encrypted. Se SQL Server informa il driver che il parametro non deve essere crittografato, la query che usa il parametro avrà esito negativo. Questa proprietà offre una protezione aggiuntiva contro gli attacchi di sicurezza che comportano un SQL Server compromesso fornendo metadati di crittografia non corretti al client, che può causare la divulgazione dei dati. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
IsNullable	Ottiene o imposta un valore che indica se il parametro accetta valori Null. IsNullable non viene usato per convalidare il valore del parametro e non impedirà l'invio o la ricezione di un valore Null durante l'esecuzione di un comando. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
LocaleId	Ottiene o imposta l'identificatore delle impostazioni locali che determina le convenzioni e la lingua per una determinata area. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
Offset	Ottiene o imposta l'offset sulla Value proprietà . Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
ParameterName	Ottiene o imposta il nome dell'oggetto SqlParameter. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
Precision	Ottiene o imposta il numero massimo di cifre utilizzate per rappresentare la Value proprietà . Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
Scale	Ottiene o imposta il numero di posizioni decimali in cui Value viene risolto. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
Size	Ottiene o imposta le dimensioni massime, in byte, dei dati all'interno della colonna. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
SourceColumn	Ottiene o imposta il nome della colonna di origine mappata a DataSet e utilizzata per il caricamento o la restituzione di Value. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
SourceColumnNullMapping	Ottiene o imposta un valore che indica se la colonna di origine è nullable. In questo modo è possibile SqlCommandBuilder generare correttamente istruzioni Update per le colonne nullable. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
SourceVersion	Ottiene o imposta l'oggetto DataRowVersion da utilizzare quando si carica Value. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
SqlDbType	Ottiene o imposta l'oggetto SqlDbType del parametro . Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
SqlValue	Ottiene o imposta il valore del parametro come tipo SQL. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
TypeName	Ottiene o imposta il nome del tipo per un parametro con valori di tabella. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
UdtTypeName	Ottiene o imposta un oggetto `string` che rappresenta un tipo definito dall'utente come parametro. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
Value	Ottiene o imposta il valore del parametro. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
XmlSchemaCollectionDatabase	Ottiene il nome del database in cui si trova la raccolta di schemi per questa istanza XML. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
XmlSchemaCollectionName	Ottiene il nome della raccolta di schemi per questa istanza XML. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
XmlSchemaCollectionOwningSchema	Schema relazionale proprietario in cui si trova la raccolta di schemi per questa istanza XML. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.

Metodi

Nome	Descrizione
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)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject)
ResetDbType()	Reimposta il tipo associato all'oggetto SqlParameter. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
ResetSqlDbType()	Reimposta il tipo associato all'oggetto SqlParameter. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
ToString()	Ottiene una stringa contenente l'oggetto ParameterName. Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
ICloneable.Clone()	Per una descrizione di questo membro, vedere Clone(). Per il nuovo sviluppo, usare Microsoft. Data.SqlClient. Questa pagina documenta System.Data.SqlClient.
IDataParameter.SourceVersion	Ottiene o imposta l'oggetto da utilizzare durante il DataRowVersion caricamento di Value. (Ereditato da DbParameter)
IDbDataParameter.Precision	Indica la precisione dei parametri numerici. (Ereditato da DbParameter)
IDbDataParameter.Scale	Per una descrizione di questo membro, vedere Scale. (Ereditato da DbParameter)

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?