SqlParameterCollection SqlParameterCollection SqlParameterCollection SqlParameterCollection Class

Definición

Representa una colección de parámetros asociados a SqlCommand y sus correspondientes asignaciones a columnas de una clase DataSet.Represents a collection of parameters associated with a SqlCommand and their respective mappings to columns in a DataSet. Esta clase no puede heredarse.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
Herencia
SqlParameterCollectionSqlParameterCollectionSqlParameterCollectionSqlParameterCollection
Atributos
Implementaciones

Ejemplos

En el ejemplo siguiente se crean varias SqlParameter instancias de SqlParameterCollection a través de la colección.The following example creates multiple instances of SqlParameter through the SqlParameterCollection collection. Los parámetros se utilizan para seleccionar los datos del origen de datos y rellenar el DataSet.The parameters are used to select data within the data source and populate the DataSet. En este código se supone DataSet que ya SqlDataAdapter se han creado un y un con el esquema, los comandos y la conexión adecuados.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  

Comentarios

Si el comando contiene una instrucción SQL ad hoc, en lugar de un nombre de procedimiento almacenado, el número de los parámetros de la colección debe ser igual al número de marcadores de posición de parámetro dentro del texto del comando o SQL Server genera un error.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 un procedimiento almacenado, se deben proporcionar todos los parámetros declarados en el procedimiento almacenado sin un valor predeterminado.With a stored procedure, all the parameters declared in the stored procedure without a default value must be provided. Los parámetros declarados con un valor predeterminado son opcionales.Parameters declared with a default value are optional. Esto le permite especificar un valor distinto del predeterminado.This lets you specify a value other than the default.

Para obtener más información sobre el uso de código de ejemplo adicional en el que se muestra cómo usar los parámetros, vea comandos y parámetros.For more information with additional sample code demonstrating how to use parameters, see Commands and Parameters.

Propiedades

Count Count Count Count

Devuelve un valor de tipo Integer que contiene el número de elementos incluidos en SqlParameterCollection.Returns an Integer that contains the number of elements in the SqlParameterCollection. Sólo lectura.Read-only.

IsFixedSize IsFixedSize IsFixedSize IsFixedSize

Obtiene un valor que indica si el objeto SqlParameterCollection tiene un tamaño fijo.Gets a value that indicates whether the SqlParameterCollection has a fixed size.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Obtiene un valor que indica si SqlParameterCollection es de solo lectura.Gets a value that indicates whether the SqlParameterCollection is read-only.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Obtiene un valor que indica si el objeto SqlParameterCollection está sincronizado.Gets a value that indicates whether the SqlParameterCollection is synchronized.

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

Obtiene el objeto SqlParameter en el índice especificado.Gets the SqlParameter at the specified index.

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

Obtiene el objeto SqlParameter con el nombre especificado.Gets the SqlParameter with the specified name.

SyncRoot SyncRoot SyncRoot SyncRoot

Obtiene un objeto que se puede usar para sincronizar el acceso a SqlParameterCollection.Gets an object that can be used to synchronize access to the SqlParameterCollection.

Métodos

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

Agrega el objeto SqlParameter especificado a SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

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

Agrega el objeto SqlParameter especificado a SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

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

Agrega el objeto SqlParameter especificado a SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

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

Agrega un objeto SqlParameter a la colección SqlParameterCollection dados el nombre del parámetro y el tipo de datos.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)

Agrega un objeto SqlParameter a la colección SqlParameterCollection a partir del nombre de parámetro, el SqlDbType y el tamaño especificados.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)

Agrega un objeto SqlParameter a la colección SqlParameterCollection con el nombre de parámetro, el tipo de datos y la longitud de columna.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)

Agrega una matriz de valores al final de la colección SqlParameterCollection.Adds an array of values to the end of the SqlParameterCollection.

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

Agrega una matriz de valores SqlParameter al final de la colección 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)

Agrega un valor al final de la colección SqlParameterCollection.Adds a value to the end of the SqlParameterCollection.

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

Quita todos los objetos SqlParameter de la colección SqlParameterCollection.Removes all the SqlParameter objects from the SqlParameterCollection.

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

Determina si el objeto Object especificado está en esta colección SqlParameterCollection.Determines whether the specified Object is in this SqlParameterCollection.

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

Determina si el objeto SqlParameter especificado está en esta colección SqlParameterCollection.Determines whether the specified SqlParameter is in this SqlParameterCollection.

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

Determina si el nombre del parámetro especificado está en este objeto SqlParameterCollection.Determines whether the specified parameter name is in this SqlParameterCollection.

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

Copia todos los elementos de la colección SqlParameterCollection actual en el objeto Array unidimensional especificado, empezando en el índice del objeto Array de destino especificado.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 todos los elementos de la colección SqlParameterCollection actual en la colección SqlParameterCollection especificada, empezando en el índice de destino indicado.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)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto 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 si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Devuelve un enumerador que recorre en iteración la colección SqlParameterCollection.Returns an enumerator that iterates through the SqlParameterCollection.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Obtiene la ubicación del objeto Object especificado dentro de la colección.Gets the location of the specified Object within the collection.

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

Obtiene la ubicación del objeto SqlParameter especificado dentro de la colección.Gets the location of the specified SqlParameter within the collection.

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

Obtiene la ubicación del objeto SqlParameter especificado con el nombre indicado.Gets the location of the specified SqlParameter with the specified name.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.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)

Inserta un objeto Object en la colección SqlParameterCollection, en el índice especificado.Inserts an Object into the SqlParameterCollection at the specified index.

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

Inserta un objeto SqlParameter en la colección SqlParameterCollection, en el índice especificado.Inserts a SqlParameter object into the SqlParameterCollection at the specified index.

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

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

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

Quita el objeto SqlParameter especificado de la colección.Removes the specified SqlParameter from the collection.

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

Quita el objeto SqlParameter especificado de la colección.Removes the specified SqlParameter from the collection.

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

Quita el objeto SqlParameter de la colección SqlParameterCollection, en el índice especificado.Removes the SqlParameter from the SqlParameterCollection at the specified index.

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

Quita el objeto SqlParameter de la colección SqlParameterCollection, en el nombre de parámetro especificadoRemoves the SqlParameter from the SqlParameterCollection at the specified parameter name.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Métodos de extensión

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

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

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

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

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

Habilita la paralelización de una consulta.Enables parallelization of a query.

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

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a

Consulte también: