SqlParameter Classe

Definizione

Rappresenta un parametro di un oggetto SqlCommand e, facoltativamente, il relativo mapping alle colonne di DataSet.Represents a parameter to a SqlCommand and optionally its mapping to DataSet columns. Questa classe non può essere ereditata.This class cannot be inherited. Per altre informazioni sui parametri, vedere Configurazione dei parametri e tipi di dati dei parametri.For more information on parameters, see Configuring Parameters and Parameter Data Types.

public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable
[System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))]
[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter/SqlParameterConverter))]
[System.ComponentModel.TypeConverter("System.Data.SqlClient.SqlParameter+SqlParameterConverter, System.Data, Version=2.0.5.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable
Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable
Ereditarietà
SqlParameter
Attributi
Implementazioni

Esempi

Nell'esempio seguente vengono create più istanze di SqlParameter tramite la raccolta di SqlParameterCollection all'interno della SqlDataAdapter.The following example creates multiple instances of SqlParameter through the SqlParameterCollection collection within the SqlDataAdapter. Questi parametri vengono usati per selezionare i dati dall'origine dati e inserire i dati nel DataSet.These parameters are used to select data from the data source and put the data in the DataSet. In questo esempio si presuppone che sia già stato creato un DataSet e un SqlDataAdapter utilizzando lo schema, i comandi e la connessione appropriati.This example assumes that a DataSet and a SqlDataAdapter have already been created by using the appropriate schema, commands, and connection. Per ulteriori informazioni ed esempi aggiuntivi sull'utilizzo di parametri, vedere recupero e modifica di dati in ADO.NET e configurazione di parametri e tipi di dati deiparametri.For more information and additional examples on using parameters, see 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

Ai nomi di parametro non viene applicata la distinzione tra maiuscole e minuscole.Parameter names are not case sensitive.

Nota

I parametri senza nome, detti anche ordinali, non sono supportati dal .NET Framework provider di dati per SQL Server.Nameless, also called ordinal, parameters are not supported by the .NET Framework Data Provider for SQL Server.

Per ulteriori informazioni, insieme al codice di esempio aggiuntivo che illustra come utilizzare i parametri, vedere comandi e parametri.For more information, along with additional sample code demonstrating how to use parameters, see Commands and Parameters.

Costruttori

SqlParameter()

Inizializza una nuova istanza della classe SqlParameter.Initializes a new instance of the SqlParameter class.

SqlParameter(String, Object)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro e un valore del nuovo oggetto SqlParameter.Initializes a new instance of the SqlParameter class that uses the parameter name and a value of the new SqlParameter.

SqlParameter(String, SqlDbType)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro e il tipo di dati.Initializes a new instance of the SqlParameter class that uses the parameter name and the data type.

SqlParameter(String, SqlDbType, Int32)

Inizializza una nuova istanza della classe SqlParameter che usa il nome del parametro, l'oggetto SqlDbType e la dimensione.Initializes a new instance of the SqlParameter class that uses the parameter name, the SqlDbType, and the size.

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.Initializes a new instance of the SqlParameter class that uses the parameter name, the type of the parameter, the size of the parameter, a ParameterDirection, the precision of the parameter, the scale of the parameter, the source column, a DataRowVersion to use, and the value of the parameter.

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.Initializes a new instance of the SqlParameter class that uses the parameter name, the SqlDbType, the size, and the source column name.

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

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.Initializes a new instance of the SqlParameter class that uses the parameter name, the type of the parameter, the length of the parameter the direction, the precision, the scale, the name of the source column, one of the DataRowVersion values, a Boolean for source column mapping, the value of the SqlParameter, the name of the database where the schema collection for this XML instance is located, the owning relational schema where the schema collection for this XML instance is located, and the name of the schema collection for this parameter.

Proprietà

CompareInfo

Ottiene o imposta l'oggetto CompareInfo che definisce le modalità di esecuzione dei confronti tra stringhe per il parametro.Gets or sets the CompareInfo object that defines how string comparisons should be performed for this parameter.

DbType

Ottiene o imposta l'oggetto SqlDbType del parametro.Gets or sets the SqlDbType of the parameter.

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.Gets or sets a value that indicates whether the parameter is input-only, output-only, bidirectional, or a stored procedure return value parameter.

ForceColumnEncryption

Applica la crittografia di un parametro quando si us Always Encrypted.Enforces encryption of a parameter when using Always Encrypted. Se SQL Server informa il driver che il parametro non deve essere crittografato, la query che usa il parametro non riuscirà.If SQL Server informs the driver that the parameter does not need to be encrypted, the query using the parameter will fail. Questa proprietà fornisce un'ulteriore protezione contro gli attacchi alla sicurezza che comportano la trasmissione al client di metadati di crittografia non corretti da un'istanza di SQL Server compromessa causando quindi la diffusione di dati.This property provides additional protection against security attacks that involve a compromised SQL Server providing incorrect encryption metadata to the client, which may lead to data disclosure.

IsNullable

Ottiene o imposta un valore che indica se il parametro ammette valori Null.Gets or sets a value that indicates whether the parameter accepts null values. 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.IsNullable is not used to validate the parameter's value and will not prevent sending or receiving a null value when executing a command.

LocaleId

Ottiene o imposta l'identificatore delle impostazioni locali che determina le convenzioni e la lingua per una determinata area.Gets or sets the locale identifier that determines conventions and language for a particular region.

Offset

Ottiene o imposta l'offset per la proprietà Value.Gets or sets the offset to the Value property.

ParameterName

Ottiene o imposta il nome di SqlParameter.Gets or sets the name of the SqlParameter.

Precision

Ottiene o imposta il numero massimo di cifre utilizzate per rappresentare la proprietà Value.Gets or sets the maximum number of digits used to represent the Value property.

Scale

Ottiene o imposta il numero di posizioni decimali in cui viene risolto Value.Gets or sets the number of decimal places to which Value is resolved.

Size

Ottiene o imposta la dimensione massima, in byte, dei dati nella colonna.Gets or sets the maximum size, in bytes, of the data within the column.

SourceColumn

Ottiene o imposta il nome della colonna di origine mappata all'oggetto DataSet e usata per caricare o restituire l'oggetto ValueGets or sets the name of the source column mapped to the DataSet and used for loading or returning the Value

SourceColumnNullMapping

Ottiene o imposta un valore che indica se la colonna di origine è nullable.Sets or gets a value which indicates whether the source column is nullable. Questo consente a SqlCommandBuilder di generare correttamente istruzioni Update per le colonne nullable.This allows SqlCommandBuilder to correctly generate Update statements for nullable columns.

SourceVersion

Ottiene o imposta l'oggetto DataRowVersion da utilizzare per il caricamento di ValueGets or sets the DataRowVersion to use when you load Value

SqlDbType

Ottiene o imposta l'oggetto SqlDbType del parametro.Gets or sets the SqlDbType of the parameter.

SqlValue

Ottiene o imposta il valore del parametro come tipo SQL.Gets or sets the value of the parameter as an SQL type.

TypeName

Ottiene o imposta il nome del tipo per un parametro con valori di tabella.Gets or sets the type name for a table-valued parameter.

UdtTypeName

Ottiene o imposta un oggetto string che rappresenta un tipo definito dall'utente come parametro.Gets or sets a string that represents a user-defined type as a parameter.

Value

Ottiene o imposta il valore del parametro.Gets or sets the value of the parameter.

XmlSchemaCollectionDatabase

Ottiene il nome del database in cui si trova la raccolta di schemi per questa istanza XML.Gets the name of the database where the schema collection for this XML instance is located.

XmlSchemaCollectionName

Ottiene il nome della raccolta di schemi per questa istanza XML.Gets the name of the schema collection for this XML instance.

XmlSchemaCollectionOwningSchema

Schema relazionale proprietario in cui si trova la raccolta di schemi per questa istanza XML.The owning relational schema where the schema collection for this XML instance is located.

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
ResetDbType()

Reimposta il tipo associato a SqlParameter.Resets the type associated with this SqlParameter.

ResetSqlDbType()

Reimposta il tipo associato a SqlParameter.Resets the type associated with this SqlParameter.

ToString()

Ottiene una stringa che contiene ParameterName.Gets a string that contains the ParameterName.

Implementazioni dell'interfaccia esplicita

ICloneable.Clone()

Per una descrizione di questo membro, vedere Clone().For a description of this member, see Clone().

Si applica a

Vedi anche