SqlParameterCollection Clase

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

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

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

Herencia

DbParameterCollection

SqlParameterCollection

Atributos

ListBindableAttribute

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.

using Microsoft.Data.SqlClient;
using System.Xml;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet categoriesDataSet;
    protected DataGrid dataGrid1;
    protected SqlDataAdapter categoriesAdapter;


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

    }
}

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.
IsReadOnly	Obtiene un valor que indica si SqlParameterCollection es de solo lectura.
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, 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.
GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección SqlParameterCollection.
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.
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.
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