SqlParameterCollection Clase

Referencia

Definición

Espacio de nombres:: System.Data.SqlClient

Ensamblado:: System.Data.SqlClient.dll

Ensamblado:: System.Data.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa una colección de parámetros asociados a SqlCommand y sus correspondientes asignaciones a columnas de una clase DataSet. Esta clase no puede heredarse.

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: Object

DbParameterCollection
SqlParameterCollection

Herencia: Object

MarshalByRefObject

DbParameterCollection
SqlParameterCollection

Herencia: Object

MarshalByRefObject
SqlParameterCollection

Atributos: ListBindableAttribute

Implementaciones: ICollection IEnumerable IList IDataParameterCollection

Ejemplos

En el ejemplo siguiente se crean varias instancias de a través de SqlParameter la SqlParameterCollection colección . Los parámetros se usan para seleccionar datos dentro del origen de datos y rellenar .DataSet En este código se supone que ya se ha creado un DataSet objeto y SqlDataAdapter con el esquema, los comandos y la conexión adecuados.

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 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. Con un procedimiento almacenado, se deben proporcionar todos los parámetros declarados en el procedimiento almacenado sin un valor predeterminado. Los parámetros declarados con un valor predeterminado son opcionales. Esto le permite especificar un valor distinto del predeterminado.

Para obtener más información con código de ejemplo adicional que muestra cómo usar parámetros, vea Comandos y parámetros.

Propiedades

Count	Devuelve un valor de tipo Integer que contiene el número de elementos incluidos en SqlParameterCollection. Solo lectura.
IsFixedSize	Obtiene un valor que indica si el objeto SqlParameterCollection tiene un tamaño fijo.
IsFixedSize	Especifica si la colección tiene un tamaño fijo. (Heredado de DbParameterCollection)
IsReadOnly	Obtiene un valor que indica si SqlParameterCollection es de solo lectura.
IsReadOnly	Especifica si la colección es de solo lectura. (Heredado de DbParameterCollection)
IsSynchronized	Obtiene un valor que indica si el objeto SqlParameterCollection está sincronizado.
IsSynchronized	Especifica si la colección está sincronizada. (Heredado de DbParameterCollection)
Item[Int32]	Obtiene el objeto SqlParameter en el índice especificado.
Item[String]	Obtiene el objeto SqlParameter con el nombre especificado.
SyncRoot	Obtiene un objeto que se puede usar para sincronizar el acceso a SqlParameterCollection.

Métodos

Add(Object)	Agrega el objeto SqlParameter especificado al objeto SqlParameterCollection.
Add(SqlParameter)	Agrega el objeto SqlParameter especificado al objeto SqlParameterCollection.
Add(String, Object)	Obsoleto. Obsoleto. Agrega el objeto SqlParameter especificado al objeto SqlParameterCollection.
Add(String, SqlDbType)	Agrega un objeto SqlParameter a la colección SqlParameterCollection dados el nombre del parámetro y el tipo de datos.
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.
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.
AddRange(Array)	Agrega una matriz de valores al final de la colección SqlParameterCollection.
AddRange(SqlParameter[])	Agrega una matriz de valores SqlParameter al final de la colección SqlParameterCollection.
AddWithValue(String, Object)	Agrega un valor al final de la colección SqlParameterCollection.
Clear()	Quita todos los objetos SqlParameter de la colección SqlParameterCollection.
Contains(Object)	Determina si el objeto Object especificado está en esta colección SqlParameterCollection.
Contains(SqlParameter)	Determina si el objeto SqlParameter especificado está en esta colección SqlParameterCollection.
Contains(String)	Determina si el nombre del parámetro especificado está en este objeto 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.
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.
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección SqlParameterCollection.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoleto. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetParameter(Int32)	Devuelve el objeto DbParameter en el índice especificado de la colección . (Heredado de DbParameterCollection)
GetParameter(String)	Devuelve a DbParameter el objeto con el nombre especificado. (Heredado de DbParameterCollection)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IndexOf(Object)	Obtiene la ubicación del objeto Object especificado dentro de la colección.
IndexOf(SqlParameter)	Obtiene la ubicación del objeto SqlParameter especificado dentro de la colección.
IndexOf(String)	Obtiene la ubicación del objeto SqlParameter especificado con el nombre indicado.
InitializeLifetimeService()	Obsoleto. Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
Insert(Int32, Object)	Inserta un objeto Object en la colección SqlParameterCollection, en el índice especificado.
Insert(Int32, SqlParameter)	Inserta un objeto SqlParameter en la colección SqlParameterCollection, en el índice especificado.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
Remove(Object)	Quita el objeto SqlParameter especificado de la colección.
Remove(SqlParameter)	Quita el objeto SqlParameter especificado de la colección.
RemoveAt(Int32)	Quita el objeto SqlParameter de la colección SqlParameterCollection, en el índice especificado.
RemoveAt(String)	Quita el objeto SqlParameter de la colección SqlParameterCollection, en el nombre de parámetro especificado
SetParameter(Int32, DbParameter)	Establece el objeto DbParameter del índice especificado en un valor nuevo. (Heredado de DbParameterCollection)
SetParameter(String, DbParameter)	Establece el objeto DbParameter con el nombre especificado en un valor nuevo. (Heredado de DbParameterCollection)
ToString()	Devuelve una cadena que representa el objeto actual. (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). (Heredado de DbParameterCollection)
IDataParameterCollection.Item[String]	Obtiene o establece el parámetro en el índice especificado. (Heredado de DbParameterCollection)
IList.IsFixedSize	Obtiene un valor que indica si la interfaz IList tiene un tamaño fijo. (Heredado de DbParameterCollection)
IList.IsReadOnly	Obtiene un valor que indica si IList es de solo lectura. (Heredado de DbParameterCollection)
IList.Item[Int32]	Obtiene o establece el elemento en el índice especificado. (Heredado de DbParameterCollection)

Métodos de extensión

Cast<TResult>(IEnumerable)	Convierte los elementos de IEnumerable en el tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de IEnumerable en función de un tipo especificado.
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte una interfaz IEnumerable en IQueryable.

Se aplica a