Home Library Formazione Code Download Supporto Community Forums
Il presente articolo è stato tradotto manualmente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale.
Traduzione
Originale
Questo argomento non è stato ancora valutato - Valuta questo argomento

Classe SqlParameter

.NET Framework 4

Rappresenta un parametro di un oggetto SqlCommand e facoltativamente il relativo mapping alle colonne di DataSet. La classe non può essere ereditata. Per ulteriori informazioni sui parametri Configurazione di parametri e di tipi di dati dei parametri (ADO.NET), vedere .

Spazio dei nomi:  System.Data.SqlClient
Assembly:  System.Data (in System.Data.dll)
C#
C++
F#
VB
Copia 
public sealed class SqlParameter : DbParameter, 
	IDbDataParameter, IDataParameter, ICloneable

Il tipo SqlParameter espone i seguenti membri.

  NomeDescrizione
Metodo pubblicoSqlParameter()Inizializza una nuova istanza della classe SqlParameter.
Metodo pubblicoSqlParameter(String, SqlDbType)Inizializza una nuova istanza della classe SqlParameter che utilizza il nome del parametro e il tipo di dati.
Metodo pubblicoSqlParameter(String, Object)Inizializza una nuova istanza della classe SqlParameter che utilizza il nome del parametro e un valore del nuovo oggetto SqlParameter.
Metodo pubblicoSqlParameter(String, SqlDbType, Int32)Inizializza una nuova istanza della classe SqlParameter con il nome del parametro, l'oggetto SqlDbType e le dimensioni.
Metodo pubblicoSqlParameter(String, SqlDbType, Int32, String)Inizializza una nuova istanza della classe SqlParameter che utilizza il nome del parametro, l'oggetto SqlDbType, le dimensioni e il nome della colonna di origine.
Metodo pubblicoSqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)Inizializza una nuova istanza della classe SqlParameter che utilizza il nome, il tipo e le dimensioni del parametro, un oggetto ParameterDirection, la precisione del parametro, la scala, la colonna di origine, un oggetto DataRowVersion da utilizzare e il valore del parametro.
Metodo pubblicoSqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)Inizializza una nuova istanza della classe SqlParameter che utilizza il nome, il tipo e la lunghezza del parametro, la precisione, la scala e il nome della colonne di origine, uno dei valori di DataRowVersion, un valore Boolean per il mapping della colonna di origine, il valore del parametro SqlParameter, il nome del database in cui si trova l'insieme di schema per questa istanza XML, lo schema relazionale di appartenenza in cui si trova l'insieme di schema di questa istanza XML e il nome dell'insieme di schema per questo parametro.
In alto
  NomeDescrizione
Proprietà pubblicaCompareInfoOttiene o imposta l'oggetto CompareInfo che definisce le modalità di esecuzione dei confronti tra stringhe per il parametro.
Proprietà pubblicaDbTypeOttiene o imposta il valore SqlDbType del parametro. (Esegue l'override di DbParameter.DbType).
Proprietà pubblicaDirectionOttiene o imposta un valore che indica se il parametro è solo di input, solo di output, bidirezionale o è un parametro di valore restituito da una stored procedure. (Esegue l'override di DbParameter.Direction).
Proprietà pubblicaIsNullableOttiene o imposta un valore che indica se il parametro accetta valori null. (Esegue l'override di DbParameter.IsNullable).
Proprietà pubblicaLocaleIdOttiene o imposta l'identificatore delle impostazioni locali che determina convenzioni e lingue per una determinata area.
Proprietà pubblicaOffsetOttiene o imposta l'offset sulla proprietà Value.
Proprietà pubblicaParameterNameOttiene o imposta il nome dell'oggetto SqlParameter. (Esegue l'override di DbParameter.ParameterName).
Proprietà pubblicaPrecisionOttiene o imposta il numero massimo di cifre utilizzate per rappresentare la proprietà Value.
Proprietà pubblicaScaleOttiene o imposta il numero di posizioni decimali in cui viene risolta la proprietà Value.
Proprietà pubblicaSizeOttiene o imposta la dimensione massima, in byte, dei dati all'interno della colonna. (Esegue l'override di DbParameter.Size).
Proprietà pubblicaSourceColumnOttiene o imposta il nome della colonna di origine mappata all'oggetto DataSet e utilizzata per il caricamento o la restituzione della proprietà Value. (Esegue l'override di DbParameter.SourceColumn).
Proprietà pubblicaSourceColumnNullMappingOttiene o imposta un valore che indica se la colonna di origine è nullable. In tal modo, l'oggetto SqlCommandBuilder può generare correttamente le istruzioni Update per le colonne nullable. (Esegue l'override di DbParameter.SourceColumnNullMapping).
Proprietà pubblicaSourceVersionOttiene o imposta l'oggetto DataRowVersion da utilizzare per il caricamento della proprietà Value (Esegue l'override di DbParameter.SourceVersion).
Proprietà pubblicaSqlDbTypeOttiene o imposta il valore SqlDbType del parametro.
Proprietà pubblicaSqlValueOttiene o imposta il valore del parametro come tipo SQL.
Proprietà pubblicaTypeNameOttiene o imposta il nome del tipo per un parametro con valori di tabella.
Proprietà pubblicaUdtTypeNameOttiene o imposta un oggetto string che rappresenta un tipo definito dall'utente come parametro.
Proprietà pubblicaValueOttiene o imposta il valore del parametro. (Esegue l'override di DbParameter.Value).
Proprietà pubblicaXmlSchemaCollectionDatabaseOttiene il nome del database in cui si trova l'insieme di schemi di questa istanza XML.
Proprietà pubblicaXmlSchemaCollectionNameOttiene il nome dell'insieme di schemi di questa istanza XML.
Proprietà pubblicaXmlSchemaCollectionOwningSchemaSchema relazionale di appartenenza in cui si trova l'insieme di schemi di questa istanza XML.
In alto
  NomeDescrizione
Metodo pubblicoCreateObjRefConsente 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)
Metodo pubblicoEquals(Object)Determina se l'oggetto Object specificato è uguale all'oggetto Object corrente. (Ereditato da Object)
Metodo protettoFinalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblicoGetHashCodeFunge da funzione hash per un determinato tipo. (Ereditato da Object)
Metodo pubblicoGetLifetimeServiceConsente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
Metodo pubblicoGetTypeOttiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblicoInitializeLifetimeServiceConsente di ottenere un oggetto servizio di durata per il controllo dei criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
Metodo protettoMemberwiseClone()Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo protettoMemberwiseClone(Boolean)Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
Metodo pubblicoResetDbTypeReimposta il tipo associato a questo oggetto SqlParameter. (Esegue l'override di DbParameter.ResetDbType()).
Metodo pubblicoResetSqlDbTypeReimposta il tipo associato a questo oggetto SqlParameter.
Metodo pubblicoToStringOttiene una stringa che contiene la proprietà ParameterName. (Esegue l'override di Object.ToString()).
In alto
  NomeDescrizione
Implementazione esplicita dell'interfacciaMetodo privatoICloneable.ClonePer una descrizione di questo membro, vedere Clone.
Implementazione esplicita dell'interfacciaProprietà privataIDbDataParameter.PrecisionIndica la precisione dei parametri numerici. (Ereditato da DbParameter)
Implementazione esplicita dell'interfacciaProprietà privataIDbDataParameter.ScalePer una descrizione di questo membro, vedere IDbDataParameter.Scale. (Ereditato da DbParameter)
In alto

Per i nomi di parametro non è prevista distinzione tra maiuscole e minuscole.

Per ulteriori informazioni, nonché altro codice di esempio che illustra come utilizzare i parametri, vedere Comandi e parametri (ADO.NET).

NotaNota

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

Nell'esempio che segue vengono create più istanze di SqlParameter attraverso l'insieme SqlParameterCollection all'interno dell'oggetto SqlDataAdapter. Questi parametri sono utilizzati per la selezione dei dati dall'origine dati e per la loro immissione nell'oggetto DataSet. Nell'esempio si presuppone la precedente creazione di un oggetto DataSet e di un oggetto SqlDataAdapter con lo schema, i comandi e la connessione appropriati. Per ulteriori informazioni ed esempi aggiuntivi sull'utilizzo dei parametri, vedere Recupero e modifica di dati in ADO.NET e Configurazione di parametri e di tipi di dati dei parametri (ADO.NET).

C#
VB
Copia 

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

}

.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Il documento è risultato utile?
(1500 caratteri rimanenti)

Aggiunte alla community

AGGIUNGI
© 2013 Microsoft. Tutti i diritti riservati.
|
Commenti e suggerimenti sul sito
© 2013 Microsoft. Tutti i diritti riservati.