SqlParameterCollection Clase

Definición

Espacio de nombres:: System.Data.SqlClient

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 respectivas asignaciones a columnas de .DataSet Esta clase no puede heredarse.

public ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection

public ref class SqlParameterCollection sealed : 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)>]
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 MarshalByRefObject
Implements IDataParameterCollection, IList

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

Herencia: Object

MarshalByRefObject
SqlParameterCollection

Herencia: Object

MarshalByRefObject

DbParameterCollection
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 DataSet ya se ha creado un 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

Nombre	Description
Count	Devuelve un entero que contiene el número de elementos de SqlParameterCollection. Solo lectura.
IsFixedSize	Obtiene un valor que indica si SqlParameterCollection tiene un tamaño fijo.
IsReadOnly	Obtiene un valor que indica si es SqlParameterCollection de solo lectura.
IsSynchronized	Obtiene un valor que indica si SqlParameterCollection está sincronizado.
Item[Int32]	Obtiene en SqlParameter el índice especificado.
Item[String]	Obtiene con SqlParameter el nombre especificado.
SyncRoot	Obtiene un objeto que se puede usar para sincronizar el acceso a la SqlParameterCollection.

Métodos

Nombre	Description
Add(Object)	Agrega el objeto especificado SqlParameter a .SqlParameterCollection
Add(SqlParameter)	Agrega el objeto especificado SqlParameter a .SqlParameterCollection
Add(String, Object)	Obsoletos. Agrega el objeto especificado SqlParameter a .SqlParameterCollection
Add(String, SqlDbType, Int32, String)	Agrega un SqlParameter al SqlParameterCollection objeto con el nombre del parámetro, el tipo de datos y la longitud de la columna.
Add(String, SqlDbType, Int32)	Agrega un SqlParameter objeto a , SqlParameterCollectiondado el nombre SqlDbType de parámetro y el tamaño especificados.
Add(String, SqlDbType)	Agrega un SqlParameter objeto al determinado nombre del SqlParameterCollection parámetro y al tipo de datos.
AddRange(Array)	Agrega una matriz de valores al final de .SqlParameterCollection
AddRange(SqlParameter[])	Agrega una matriz de SqlParameter valores al final de .SqlParameterCollection
AddWithValue(String, Object)	Agrega un valor al final de .SqlParameterCollection
Clear()	Quita todos los SqlParameter objetos de .SqlParameterCollection
Contains(Object)	Determina si el objeto especificado Object está en este SqlParameterCollection.
Contains(SqlParameter)	Determina si el objeto especificado SqlParameter está en este SqlParameterCollection.
Contains(String)	Determina si el nombre de parámetro especificado está en este SqlParameterCollection.
CopyTo(Array, Int32)	Copia todos los elementos del actual SqlParameterCollection en la unidimensional Array especificada a partir del índice de destino Array especificado.
CopyTo(SqlParameter[], Int32)	Copia todos los elementos del actual SqlParameterCollection en el especificado SqlParameterCollection a partir del índice de destino especificado.
CreateObjRef(Type)	Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetEnumerator()	Devuelve un enumerador que recorre en iteración .SqlParameterCollection
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	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 DbParameter objeto en el índice especificado de la colección. (Heredado de DbParameterCollection)
GetParameter(String)	Devuelve 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 especificado Object dentro de la colección.
IndexOf(SqlParameter)	Obtiene la ubicación del especificado SqlParameter dentro de la colección.
IndexOf(String)	Obtiene la ubicación del especificado SqlParameter con el nombre especificado.
InitializeLifetimeService()	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 Object objeto en en el SqlParameterCollection índice especificado.
Insert(Int32, SqlParameter)	Inserta un SqlParameter objeto en en el SqlParameterCollection índice especificado.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto actual MarshalByRefObject . (Heredado de MarshalByRefObject)
Remove(Object)	Quita el especificado SqlParameter de la colección.
Remove(SqlParameter)	Quita el especificado SqlParameter de la colección.
RemoveAt(Int32)	Quita de SqlParameter en SqlParameterCollection el índice especificado.
RemoveAt(String)	Quita de SqlParameter en SqlParameterCollection el nombre de parámetro especificado.
SetParameter(Int32, DbParameter)	Establece el DbParameter objeto en el índice especificado en un nuevo valor. (Heredado de DbParameterCollection)
SetParameter(String, DbParameter)	Establece el DbParameter objeto con el nombre especificado en un nuevo valor. (Heredado de DbParameterCollection)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

Nombre	Description
IDataParameterCollection.Item[String]	Obtiene o establece el parámetro en el índice especificado. (Heredado de DbParameterCollection)
IList.Item[Int32]	Obtiene o establece el elemento en el índice especificado. (Heredado de DbParameterCollection)

Métodos de extensión

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

Se aplica a

Consulte también

Comentarios

Resultoulle útil esta páxina?