SqlParameterCollection Clase

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. No se puede heredar esta clase.This class cannot be inherited.

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection
public ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection
public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection, System::Collections::IList
public 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.DbParameterCollection
[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection, System.Collections.IList
type 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 DbParameterCollection
[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Implements IList
Herencia
SqlParameterCollection
Herencia
Herencia
SqlParameterCollection
Atributos
Implementaciones

Ejemplos

En el ejemplo siguiente se crean varias instancias de SqlParameter a través de la SqlParameterCollection 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 que DataSet ya se han creado un y un SqlDataAdapter 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

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. Solo lectura.Read-only.

IsFixedSize

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

IsFixedSize

Especifica si la colección tiene un tamaño fijo.Specifies whether the collection is a fixed size.

(Heredado de DbParameterCollection)
IsReadOnly

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

IsReadOnly

Especifica si la colección es de solo lectura.Specifies whether the collection is read-only.

(Heredado de DbParameterCollection)
IsSynchronized

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

IsSynchronized

Especifica si la colección está sincronizada.Specifies whether the collection is synchronized.

(Heredado de DbParameterCollection)
Item[Int32]

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

Item[String]

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

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)

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

Add(SqlParameter)

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

Add(String, Object)
Obsoleto.
Obsoleto.

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

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)

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)

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)

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[])

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)

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

Clear()

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

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)

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

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)

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)

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)

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.

(Heredado de MarshalByRefObject)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetEnumerator()

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

GetHashCode()

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

(Heredado de Object)
GetLifetimeService()
Obsoleto.

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.

(Heredado de MarshalByRefObject)
GetParameter(Int32)

Devuelve el objeto DbParameter en el índice especificado de la colección .Returns the DbParameter object at the specified index in the collection.

(Heredado de DbParameterCollection)
GetParameter(String)

Devuelve a DbParameter el objeto con el nombre especificado.Returns DbParameter the object with the specified name.

(Heredado de DbParameterCollection)
GetType()

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

(Heredado de 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)

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)

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

InitializeLifetimeService()
Obsoleto.

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.

(Heredado de MarshalByRefObject)
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)

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

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

(Heredado de Object)
MemberwiseClone(Boolean)

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

(Heredado de MarshalByRefObject)
Remove(Object)

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

Remove(SqlParameter)

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

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)

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

SetParameter(Int32, DbParameter)

Establece el objeto DbParameter del índice especificado en un valor nuevo.Sets the DbParameter object at the specified index to a new value.

(Heredado de DbParameterCollection)
SetParameter(String, DbParameter)

Establece el objeto DbParameter con el nombre especificado en un valor nuevo.Sets the DbParameter object with the specified name to a new value.

(Heredado de DbParameterCollection)
ToString()

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

(Heredado de Object)

Implementaciones de interfaz explícitas

ICollection.IsSynchronized

Obtiene un valor que indica si el acceso a la interfaz ICollection está sincronizado (es seguro para subprocesos).Gets a value indicating whether access to the ICollection is synchronized (thread safe).

(Heredado de DbParameterCollection)
IDataParameterCollection.Item[String]

Obtiene o establece el parámetro en el índice especificado.Gets or sets the parameter at the specified index.

(Heredado de DbParameterCollection)
IList.Add(Object)

Para obtener una descripción de este miembro, vea Add(Object).For a description of this member, see Add(Object).

(Heredado de DbParameterCollection)
IList.Contains(Object)

Para obtener una descripción de este miembro, vea Contains(Object).For a description of this member, see Contains(Object).

(Heredado de DbParameterCollection)
IList.IndexOf(Object)

Para obtener una descripción de este miembro, vea IndexOf(Object).For a description of this member, see IndexOf(Object).

(Heredado de DbParameterCollection)
IList.Insert(Int32, Object)

Para obtener una descripción de este miembro, vea Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

(Heredado de DbParameterCollection)
IList.IsFixedSize

Obtiene un valor que indica si la interfaz IList tiene un tamaño fijo.Gets a value indicating whether the IList has a fixed size.

(Heredado de DbParameterCollection)
IList.IsReadOnly

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

(Heredado de DbParameterCollection)
IList.Item[Int32]

Obtiene o establece el elemento en el índice especificado.Gets or sets the element at the specified index.

(Heredado de DbParameterCollection)
IList.Remove(Object)

Para obtener una descripción de este miembro, vea Remove(Object).For a description of this member, see Remove(Object).

(Heredado de DbParameterCollection)

Métodos de extensión

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)

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)

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

AsQueryable(IEnumerable)

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

Se aplica a

Consulte también