SqlParameter Classe

Definizione

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

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.

public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter
public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable
[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
[<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 MarshalByRefObject
Implements ICloneable, IDbDataParameter
Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable
Ereditarietà
Object
MarshalByRefObject
SqlParameter
Ereditarietà
Object
MarshalByRefObject
DbParameter
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.
SqlParameter(String, Object)

Inizializza una nuova istanza della SqlParameter classe che utilizza il nome del parametro e un valore del nuovo SqlParameteroggetto .
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.
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.
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.
SqlParameter(String, SqlDbType, Int32)

Inizializza una nuova istanza della SqlParameter classe che utilizza il nome del parametro, l'oggetto SqlDbTypee le dimensioni.
SqlParameter(String, SqlDbType)

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

Proprietà

Nome Descrizione
CompareInfo

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

Ottiene o imposta l'oggetto SqlDbType del parametro .
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.
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.
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.
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 sulla Value proprietà .
ParameterName

Ottiene o imposta il nome dell'oggetto SqlParameter.
Precision

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

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

Ottiene o imposta le dimensioni massime, in byte, dei dati all'interno della colonna.
SourceColumn

Ottiene o imposta il nome della colonna di origine mappata a DataSet e utilizzata per il caricamento o la restituzione di Value.
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.
SourceVersion

Ottiene o imposta l'oggetto DataRowVersion da utilizzare quando si carica 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

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

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

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.
ResetSqlDbType()

Reimposta il tipo associato all'oggetto SqlParameter.
ToString()

Ottiene una stringa contenente l'oggetto ParameterName.

Implementazioni dell'interfaccia esplicita

Nome Descrizione
ICloneable.Clone()

Per una descrizione di questo membro, vedere Clone().
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