SqlParameterCollection 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 una raccolta di parametri associati a un oggetto SqlCommand e i rispettivi mapping alle colonne in un oggetto DataSet. La classe non può essere ereditata.
public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollectionpublic ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollectionpublic sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : MarshalByRefObject, System.Collections.IList, System.Data.IDataParameterCollection[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollectiontype SqlParameterCollection = class
inherit DbParameterCollection[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
inherit MarshalByRefObject
interface IDataParameterCollection
interface IList
interface ICollection
interface IEnumerable[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
inherit DbParameterCollectionPublic NotInheritable Class SqlParameterCollection
Inherits DbParameterCollectionPublic NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList- Ereditarietà
- Ereditarietà
- Ereditarietà
- Attributi
- Implementazioni
Esempio
Nell'esempio seguente vengono create più istanze di SqlParameter tramite la SqlParameterCollection raccolta . I parametri vengono usati per selezionare i dati all'interno dell'origine dati e popolare .DataSet Questo codice presuppone che sia già stato creato un oggetto DataSet e SqlDataAdapter con lo schema, i comandi e la connessione appropriati.
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
Se il comando contiene un'istruzione SQL ad hoc, anziché un nome di stored procedure, il numero dei parametri nella raccolta deve essere uguale al numero di segnaposto del parametro all'interno del testo del comando oppure SQL Server genera un errore. Con una stored procedure, è necessario specificare tutti i parametri dichiarati nella stored procedure senza un valore predefinito. I parametri dichiarati con un valore predefinito sono facoltativi. In questo modo è possibile specificare un valore diverso da quello predefinito.
Per altre informazioni con codice di esempio aggiuntivo che illustra come usare i parametri, vedere Comandi e parametri.
Proprietà
| Count |
Restituisce un intero contenente il numero di elementi nella classe SqlParameterCollection. Di sola lettura. |
| IsFixedSize |
Ottiene un valore che indica se le dimensioni dell'oggetto SqlParameterCollection sono fisse. |
| IsFixedSize |
Specifica se la raccolta ha dimensioni fisse. (Ereditato da DbParameterCollection) |
| IsReadOnly |
Ottiene un valore che indica se SqlParameterCollection è di sola lettura. |
| IsReadOnly |
Specifica se la raccolta è di sola lettura. (Ereditato da DbParameterCollection) |
| IsSynchronized |
Ottiene un valore che indica se SqlParameterCollection è sincronizzato. |
| IsSynchronized |
Specifica se la raccolta è sincronizzata. (Ereditato da DbParameterCollection) |
| Item[Int32] |
Ottiene SqlParameter in corrispondenza dell'indice specificato. |
| Item[String] |
Ottiene SqlParameter con il nome specificato. |
| SyncRoot |
Ottiene un oggetto che può essere usato per sincronizzare l'accesso a SqlParameterCollection. |
Metodi
| Add(Object) |
Aggiunge l'oggetto SqlParameter specificato all'oggetto SqlParameterCollection. |
| Add(SqlParameter) |
Aggiunge l'oggetto SqlParameter specificato all'oggetto SqlParameterCollection. |
| Add(String, Object) |
Obsoleti.
Aggiunge l'oggetto SqlParameter specificato all'oggetto SqlParameterCollection. |
| Add(String, SqlDbType) |
Aggiunge un oggetto SqlParameter a SqlParameterCollection quando vengono specificati il nome di parametro e il tipo di dati. |
| Add(String, SqlDbType, Int32) |
Aggiunge un oggetto SqlParameter all'insieme SqlParameterCollection, dati il nome del parametro specificato e la classe SqlDbType e le dimensioni. |
| Add(String, SqlDbType, Int32, String) |
Aggiunge un oggetto SqlParameter a SqlParameterCollection con il nome di parametro, il tipo di dati e la lunghezza di colonna. |
| AddRange(Array) |
Aggiunge una matrice di valori alla fine di SqlParameterCollection. |
| AddRange(SqlParameter[]) |
Aggiunge una matrice di valori SqlParameter alla fine di SqlParameterCollection. |
| AddWithValue(String, Object) |
Aggiunge un valore alla fine di SqlParameterCollection. |
| Clear() |
Rimuove tutti gli oggetti SqlParameter da SqlParameterCollection. |
| Contains(Object) |
Determina se l'oggetto Object specificato è contenuto in SqlParameterCollection. |
| Contains(SqlParameter) |
Determina se l'oggetto SqlParameter specificato è contenuto in SqlParameterCollection. |
| Contains(String) |
Determina se il nome del parametro specificato si trova in SqlParameterCollection. |
| CopyTo(Array, Int32) |
Copia tutti gli elementi dell'oggetto SqlParameterCollection corrente nell'oggetto Array unidimensionale specificato a partire dall'indice di destinazione Array indicato. |
| CopyTo(SqlParameter[], Int32) |
Copia tutti gli elementi dell'oggetto SqlParameterCollection corrente nell'oggetto SqlParameterCollection specificato, a partire dall'indice di destinazione indicato. |
| 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) |
| GetEnumerator() |
Restituisce un enumeratore che esegue l'iterazione di SqlParameterCollection. |
| 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) |
| GetParameter(Int32) |
Restituisce l'oggetto DbParameter in corrispondenza dell'indice specificato nella raccolta. (Ereditato da DbParameterCollection) |
| GetParameter(String) |
Restituisce l'oggetto DbParameter con il nome specificato. (Ereditato da DbParameterCollection) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| IndexOf(Object) |
Ottiene la posizione della classe Object specificata all'interno dell'insieme. |
| IndexOf(SqlParameter) |
Ottiene la posizione della classe SqlParameter specificata all'interno dell'insieme. |
| IndexOf(String) |
Ottiene la posizione dell'oggetto SqlParameter specificato con il nome indicato. |
| InitializeLifetimeService() |
Obsoleti.
Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| Insert(Int32, Object) |
Inserisce un oggetto Object in SqlParameterCollection in corrispondenza dell'indice specificato. |
| Insert(Int32, SqlParameter) |
Inserisce un oggetto SqlParameter in SqlParameterCollection in corrispondenza dell'indice specificato. |
| 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) |
| Remove(Object) |
Rimuove l'oggetto SqlParameter specificato dalla raccolta. |
| Remove(SqlParameter) |
Rimuove l'oggetto SqlParameter specificato dalla raccolta. |
| RemoveAt(Int32) |
Rimuove l'oggetto SqlParameter da SqlParameterCollection in corrispondenza dell'indice specificato. |
| RemoveAt(String) |
Rimuove l'oggetto SqlParameter da SqlParameterCollection in corrispondenza del nome di parametro specificato. |
| SetParameter(Int32, DbParameter) |
Imposta l'oggetto DbParameter in corrispondenza dell'indice specificato su un nuovo valore. (Ereditato da DbParameterCollection) |
| SetParameter(String, DbParameter) |
Imposta l'oggetto DbParameter con il nome specificato su un nuovo valore. (Ereditato da DbParameterCollection) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
| ICollection.IsSynchronized |
Ottiene un valore che indica se l'accesso a ICollection è sincronizzato (thread-safe). (Ereditato da DbParameterCollection) |
| IDataParameterCollection.Item[String] |
Ottiene o imposta il parametro in corrispondenza dell'indice specificato. (Ereditato da DbParameterCollection) |
| IList.IsFixedSize |
Ottiene un valore che indica se IList ha dimensioni fisse. (Ereditato da DbParameterCollection) |
| IList.IsReadOnly |
Ottiene un valore che indica se IList è di sola lettura. (Ereditato da DbParameterCollection) |
| IList.Item[Int32] |
Ottiene o imposta l'elemento in corrispondenza dell'indice specificato. (Ereditato da DbParameterCollection) |
Metodi di estensione
| Cast<TResult>(IEnumerable) |
Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato. |
| OfType<TResult>(IEnumerable) |
Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato. |
| AsParallel(IEnumerable) |
Consente la parallelizzazione di una query. |
| AsQueryable(IEnumerable) |
Converte un oggetto IEnumerable in un oggetto IQueryable. |
