Compartir a través de


SqlParameterCollection Clase

Definición

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
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection
[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection
type SqlParameterCollection = class
    inherit DbParameterCollection
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Herencia
SqlParameterCollection
Atributos

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.

IsSynchronized

Obtiene un valor que indica si el objeto SqlParameterCollection está sincronizado.

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.

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

Se aplica a