Compartilhar via


SqlParameterCollection Classe

Definição

Representa uma coleção de parâmetros associados a um SqlCommand e seus respectivos mapeamentos para colunas em um DataSet. Essa classe não pode ser herdada.

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
Herança
SqlParameterCollection
Atributos

Exemplos

O exemplo a seguir cria várias instâncias de SqlParameter por meio da SqlParameterCollection coleção . Os parâmetros são usados para selecionar dados na fonte de dados e preencher o DataSet. Esse código pressupõe que um DataSet e um SqlDataAdapter já foram criados com o esquema, os comandos e a conexão apropriados.

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

    }
}

Comentários

Se o comando contiver uma instrução SQL ad hoc, em vez de um nome de procedimento armazenado, o número dos parâmetros na coleção deverá ser igual ao número de espaços reservados de parâmetro dentro do texto do comando ou SQL Server gerará um erro. Com um procedimento armazenado, todos os parâmetros declarados no procedimento armazenado sem um valor padrão devem ser fornecidos. Os parâmetros declarados com um valor padrão são opcionais. Isso permite que você especifique um valor diferente do padrão.

Para obter mais informações com código de exemplo adicional demonstrando como usar parâmetros, consulte Comandos e parâmetros.

Propriedades

Count

Retorna um inteiro que contém o número de argumentos no SqlParameterCollection. Somente leitura.

IsFixedSize

Obtém um valor que indica se o SqlParameterCollection tem um tamanho fixo.

IsReadOnly

Obtém um valor que indica se o SqlParameterCollection é somente leitura.

IsSynchronized

Obtém um valor que indica se o SqlParameterCollection é sincronizado.

Item[Int32]

Obtém o SqlParameter no índice especificado.

Item[String]

Obtém o SqlParameter com o nome especificado.

SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso ao SqlParameterCollection.

Métodos

Add(Object)

Adiciona o objeto SqlParameter especificado ao SqlParameterCollection.

Add(SqlParameter)

Adiciona o objeto SqlParameter especificado ao SqlParameterCollection.

Add(String, Object)
Obsoleto.

Adiciona o objeto SqlParameter especificado ao SqlParameterCollection.

Add(String, SqlDbType)

Adiciona um SqlParameter ao SqlParameterCollection, dado o nome do parâmetro o tipo de dados.

Add(String, SqlDbType, Int32)

Adiciona um SqlParameter ao SqlParameterCollection, dado o nome do parâmetro especificado, SqlDbType e tamanho.

Add(String, SqlDbType, Int32, String)

Adiciona um SqlParameter ao SqlParameterCollection com o nome do parâmetro, o tipo de dados e o comprimento da coluna.

AddRange(Array)

Adiciona uma matriz de valores ao final do SqlParameterCollection.

AddRange(SqlParameter[])

Adiciona uma matriz de valores SqlParameter ao final do SqlParameterCollection.

AddWithValue(String, Object)

Adiciona um valor ao final do SqlParameterCollection.

Clear()

Remove todos os objetos SqlParameter do SqlParameterCollection.

Contains(Object)

Determina se o Object especificado está neste SqlParameterCollection.

Contains(SqlParameter)

Determina se o SqlParameter especificado está neste SqlParameterCollection.

Contains(String)

Determina se o nome de parâmetro especificado está neste SqlParameterCollection.

CopyTo(Array, Int32)

Copia todos os elementos do SqlParameterCollection atual para o Array unidimensional especificado, começando no índice Array de destino especificado.

CopyTo(SqlParameter[], Int32)

Copia todos os elementos do SqlParameterCollection atual para o SqlParameterCollection especificado, começando no índice de destino especificado.

GetEnumerator()

Retorna um enumerador que itera por meio de SqlParameterCollection.

IndexOf(Object)

Obtém o local do Object especificado na coleção.

IndexOf(SqlParameter)

Obtém o local do SqlParameter especificado na coleção.

IndexOf(String)

Obtém o local do SqlParameter especificado com o nome especificado.

Insert(Int32, Object)

Insere um Object no SqlParameterCollection no índice especificado.

Insert(Int32, SqlParameter)

Insere um objeto SqlParameter no SqlParameterCollection no índice especificado.

Remove(Object)

Remove o SqlParameter especificado da coleção.

Remove(SqlParameter)

Remove o SqlParameter especificado da coleção.

RemoveAt(Int32)

Remove o SqlParameter do SqlParameterCollection no índice especificado.

RemoveAt(String)

Remove o SqlParameter do SqlParameterCollection no nome de parâmetro especificado.

Aplica-se a