SqlParameterCollection Clase

  • Referencia

Definición

Espacio de nombres:
System.Data.SqlClient
Ensamblado:
System.Data.SqlClient.dll
Ensamblado:
System.Data.dll
Ensamblados:
netstandard.dll, System.Data.SqlClient.dll
Paquete:
System.Data.SqlClient v4.8.6

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 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
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
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, 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)
Obsoletos.

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

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

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

Consulte también