SqlParameter Classe
Definizione
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 colonne di DataSet. La classe non può essere ereditata. Per altre informazioni sui parametri, vedere Configurazione dei parametri e tipi di dati dei parametri.
public ref class SqlParameter sealed : System::Data::Common::DbParameterpublic ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameterpublic ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneablepublic 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, ICloneablepublic sealed class SqlParameter : System.Data.Common.DbParameter, ICloneabletype 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 ICloneabletype SqlParameter = class
inherit DbParameter
interface ICloneablePublic NotInheritable Class SqlParameter
Inherits DbParameterPublic NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameterPublic NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable- Ereditarietà
- Ereditarietà
- Ereditarietà
- 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 di parametri e tipi di dati dei parametri.
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
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(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 alla classe DataSet e utilizzata per il caricamento o la restituzione della proprietà Value. |
| SourceColumnNullMapping |
Ottiene o imposta un valore che indica se la colonna di origine ammette valori Null. Questo consente a SqlCommandBuilder di generare correttamente istruzioni Update per le colonne nullable. |
| SourceVersion |
Ottiene o imposta l'enumerazione DataRowVersion da utilizzare per il caricamento della proprietà Value. |
| SourceVersion |
Ottiene o imposta l'enumerazione DataRowVersion da utilizzare per il caricamento della proprietà Value. (Ereditato da DbParameter) |
| 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 |
| 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
| CreateObjRef(Type) |
Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione 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.
Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject) |
| GetType() |
Ottiene l'oggetto 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 dell'oggetto Object corrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject) |
| 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(). |
| IDataParameter.SourceVersion |
Ottiene o imposta l'oggetto DataRowVersion da usare durante il 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) |
