SqlParameterCollection SqlParameterCollection SqlParameterCollection SqlParameterCollection Class

Definizione

Rappresenta una raccolta di parametri associati a un oggetto SqlCommand e i rispettivi mapping alle colonne in un oggetto DataSet.Represents a collection of parameters associated with a SqlCommand and their respective mappings to columns in a DataSet. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection, System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection, System.Collections.IList
type SqlParameterCollection = class
    inherit DbParameterCollection
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Implements IList
Ereditarietà
SqlParameterCollectionSqlParameterCollectionSqlParameterCollectionSqlParameterCollection
Attributi
Implementazioni

Esempi

L'esempio seguente crea più istanze di SqlParameter attraverso il SqlParameterCollection raccolta.The following example creates multiple instances of SqlParameter through the SqlParameterCollection collection. I parametri vengono utilizzati per selezionare i dati all'interno dell'origine dati e popolare il DataSet.The parameters are used to select data within the data source and populate the DataSet. Questo codice si presuppone che un DataSet e un SqlDataAdapter sono già stati creati con lo schema appropriato, comandi e connessione.This code assumes that a DataSet and a SqlDataAdapter have already been created with the appropriate schema, commands, and connection.

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 di parametri nel testo del comando, o SQL Server genera un errore.If the command contains an ad hoc SQL statement, as opposed to a stored-procedure name, the number of the parameters in the collection must be equal to the number of parameter placeholders within the command text, or SQL Server raises an error. Con una stored procedure, è necessario specificare tutti i parametri dichiarati nella stored procedure senza un valore predefinito.With a stored procedure, all the parameters declared in the stored procedure without a default value must be provided. I parametri dichiarati come valore predefinito sono facoltativi.Parameters declared with a default value are optional. Ciò consente di specificare un valore diverso da quello predefinito.This lets you specify a value other than the default.

Per altre informazioni con ulteriore codice di esempio che illustra come usare i parametri, vedere comandi e parametri.For more information with additional sample code demonstrating how to use parameters, see Commands and Parameters.

Proprietà

Count Count Count Count

Restituisce un intero contenente il numero di elementi nella classe SqlParameterCollection.Returns an Integer that contains the number of elements in the SqlParameterCollection. Sola lettura.Read-only.

IsFixedSize IsFixedSize IsFixedSize IsFixedSize

Ottiene un valore che indica se le dimensioni dell'oggetto SqlParameterCollection sono fisse.Gets a value that indicates whether the SqlParameterCollection has a fixed size.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ottiene un valore che indica se SqlParameterCollection è di sola lettura.Gets a value that indicates whether the SqlParameterCollection is read-only.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Ottiene un valore che indica se SqlParameterCollection è sincronizzato.Gets a value that indicates whether the SqlParameterCollection is synchronized.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ottiene SqlParameter in corrispondenza dell'indice specificato.Gets the SqlParameter at the specified index.

Item[String] Item[String] Item[String] Item[String]

Ottiene SqlParameter con il nome specificato.Gets the SqlParameter with the specified name.

SyncRoot SyncRoot SyncRoot SyncRoot

Ottiene un oggetto che può essere usato per sincronizzare l'accesso a SqlParameterCollection.Gets an object that can be used to synchronize access to the SqlParameterCollection.

Metodi

Add(Object) Add(Object) Add(Object) Add(Object)

Aggiunge l'oggetto SqlParameter specificato a SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(SqlParameter) Add(SqlParameter) Add(SqlParameter) Add(SqlParameter)

Aggiunge l'oggetto SqlParameter specificato a SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, Object) Add(String, Object) Add(String, Object) Add(String, Object)

Aggiunge l'oggetto SqlParameter specificato a SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, SqlDbType) Add(String, SqlDbType) Add(String, SqlDbType) Add(String, SqlDbType)

Aggiunge un oggetto SqlParameter a SqlParameterCollection quando vengono specificati il nome di parametro e il tipo di dati.Adds a SqlParameter to the SqlParameterCollection given the parameter name and the data type.

Add(String, SqlDbType, Int32) Add(String, SqlDbType, Int32) Add(String, SqlDbType, Int32) Add(String, SqlDbType, Int32)

Aggiunge un oggetto SqlParameter all'insieme SqlParameterCollection, dati il nome del parametro specificato e la classe SqlDbType e le dimensioni.Adds a SqlParameter to the SqlParameterCollection, given the specified parameter name, SqlDbType and size.

Add(String, SqlDbType, Int32, String) Add(String, SqlDbType, Int32, String) Add(String, SqlDbType, Int32, String) 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.Adds a SqlParameter to the SqlParameterCollection with the parameter name, the data type, and the column length.

AddRange(Array) AddRange(Array) AddRange(Array) AddRange(Array)

Aggiunge una matrice di valori alla fine di SqlParameterCollection.Adds an array of values to the end of the SqlParameterCollection.

AddRange(SqlParameter[]) AddRange(SqlParameter[]) AddRange(SqlParameter[]) AddRange(SqlParameter[])

Aggiunge una matrice di valori SqlParameter alla fine di SqlParameterCollection.Adds an array of SqlParameter values to the end of the SqlParameterCollection.

AddWithValue(String, Object) AddWithValue(String, Object) AddWithValue(String, Object) AddWithValue(String, Object)

Aggiunge un valore alla fine di SqlParameterCollection.Adds a value to the end of the SqlParameterCollection.

Clear() Clear() Clear() Clear()

Rimuove tutti gli oggetti SqlParameter da SqlParameterCollection.Removes all the SqlParameter objects from the SqlParameterCollection.

Contains(Object) Contains(Object) Contains(Object) Contains(Object)

Determina se l'oggetto Object specificato è contenuto in SqlParameterCollection.Determines whether the specified Object is in this SqlParameterCollection.

Contains(SqlParameter) Contains(SqlParameter) Contains(SqlParameter) Contains(SqlParameter)

Determina se l'oggetto SqlParameter specificato è contenuto in SqlParameterCollection.Determines whether the specified SqlParameter is in this SqlParameterCollection.

Contains(String) Contains(String) Contains(String) Contains(String)

Determina se il nome del parametro specificato si trova in SqlParameterCollection.Determines whether the specified parameter name is in this SqlParameterCollection.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Copia tutti gli elementi dell'oggetto SqlParameterCollection corrente nell'oggetto Array unidimensionale specificato a partire dall'indice di destinazione Array indicato.Copies all the elements of the current SqlParameterCollection to the specified one-dimensional Array starting at the specified destination Array index.

CopyTo(SqlParameter[], Int32) CopyTo(SqlParameter[], Int32) CopyTo(SqlParameter[], Int32) CopyTo(SqlParameter[], Int32)

Copia tutti gli elementi dell'oggetto SqlParameterCollection corrente nell'oggetto SqlParameterCollection specificato, a partire dall'indice di destinazione indicato.Copies all the elements of the current SqlParameterCollection to the specified SqlParameterCollection starting at the specified destination index.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.

(Inherited from MarshalByRefObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Restituisce un enumeratore che esegue l'iterazione di SqlParameterCollection.Returns an enumerator that iterates through the SqlParameterCollection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IndexOf(Object) IndexOf(Object) IndexOf(Object) IndexOf(Object)

Ottiene la posizione della classe Object specificata all'interno dell'insieme.Gets the location of the specified Object within the collection.

IndexOf(SqlParameter) IndexOf(SqlParameter) IndexOf(SqlParameter) IndexOf(SqlParameter)

Ottiene la posizione della classe SqlParameter specificata all'interno dell'insieme.Gets the location of the specified SqlParameter within the collection.

IndexOf(String) IndexOf(String) IndexOf(String) IndexOf(String)

Ottiene la posizione dell'oggetto SqlParameter specificato con il nome indicato.Gets the location of the specified SqlParameter with the specified name.

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

(Inherited from MarshalByRefObject)
Insert(Int32, Object) Insert(Int32, Object) Insert(Int32, Object) Insert(Int32, Object)

Inserisce un oggetto Object in SqlParameterCollection in corrispondenza dell'indice specificato.Inserts an Object into the SqlParameterCollection at the specified index.

Insert(Int32, SqlParameter) Insert(Int32, SqlParameter) Insert(Int32, SqlParameter) Insert(Int32, SqlParameter)

Inserisce un oggetto SqlParameter in SqlParameterCollection in corrispondenza dell'indice specificato.Inserts a SqlParameter object into the SqlParameterCollection at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
Remove(Object) Remove(Object) Remove(Object) Remove(Object)

Rimuove l'oggetto SqlParameter specificato dalla raccolta.Removes the specified SqlParameter from the collection.

Remove(SqlParameter) Remove(SqlParameter) Remove(SqlParameter) Remove(SqlParameter)

Rimuove l'oggetto SqlParameter specificato dalla raccolta.Removes the specified SqlParameter from the collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Rimuove l'oggetto SqlParameter da SqlParameterCollection in corrispondenza dell'indice specificato.Removes the SqlParameter from the SqlParameterCollection at the specified index.

RemoveAt(String) RemoveAt(String) RemoveAt(String) RemoveAt(String)

Rimuove l'oggetto SqlParameter da SqlParameterCollection in corrispondenza del nome di parametro specificato.Removes the SqlParameter from the SqlParameterCollection at the specified parameter name.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Extension Methods

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Consente la parallelizzazione di una query.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Converte un' IEnumerable a un IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a

Vedi anche