SqlParameterCollection Classe

Definição

Representa uma coleção de parâmetros associados a um SqlCommand e seus respectivos mapeamentos para colunas em um DataSet.Represents a collection of parameters associated with a SqlCommand and their respective mappings to columns in a DataSet. Essa classe não pode ser herdada.This class cannot be inherited.

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection, System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection, System.Collections.IList
type SqlParameterCollection = class
    inherit DbParameterCollection
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Implements IList
Herança
SqlParameterCollection
Atributos
Implementações

Exemplos

O exemplo a seguir cria várias instâncias de SqlParameter por meio da coleção SqlParameterCollection.The following example creates multiple instances of SqlParameter through the SqlParameterCollection collection. Os parâmetros são usados para selecionar dados dentro da fonte de dados e preencher a DataSet.The parameters are used to select data within the data source and populate the DataSet. Esse código pressupõe que um DataSet e um SqlDataAdapter já tenham sido criados com o esquema, os comandos e a conexão apropriados.This code assumes that a DataSet and a SqlDataAdapter have already been created with the appropriate schema, commands, and connection.

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  

Comentários

Se o comando contiver uma instrução SQL ad hoc, em oposição a 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.If the command contains an ad hoc SQL statement, as opposed to a stored-procedure name, the number of the parameters in the collection must be equal to the number of parameter placeholders within the command text, or SQL Server raises an error. Com um procedimento armazenado, todos os parâmetros declarados no procedimento armazenado sem um valor padrão devem ser fornecidos.With a stored procedure, all the parameters declared in the stored procedure without a default value must be provided. Os parâmetros declarados com um valor padrão são opcionais.Parameters declared with a default value are optional. Isso permite que você especifique um valor diferente do padrão.This lets you specify a value other than the default.

Para obter mais informações com um código de exemplo adicional que demonstra como usar parâmetros, consulte comandos e parâmetros.For more information with additional sample code demonstrating how to use parameters, see Commands and Parameters.

Propriedades

Count

Retorna um inteiro que contém o número de argumentos no SqlParameterCollection.Returns an Integer that contains the number of elements in the SqlParameterCollection. Somente leitura.Read-only.

IsFixedSize

Obtém um valor que indica se o SqlParameterCollection tem um tamanho fixo.Gets a value that indicates whether the SqlParameterCollection has a fixed size.

IsReadOnly

Obtém um valor que indica se o SqlParameterCollection é somente leitura.Gets a value that indicates whether the SqlParameterCollection is read-only.

IsSynchronized

Obtém um valor que indica se o SqlParameterCollection é sincronizado.Gets a value that indicates whether the SqlParameterCollection is synchronized.

Item[Int32]

Obtém o SqlParameter no índice especificado.Gets the SqlParameter at the specified index.

Item[String]

Obtém o SqlParameter com o nome especificado.Gets the SqlParameter with the specified name.

SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso ao SqlParameterCollection.Gets an object that can be used to synchronize access to the SqlParameterCollection.

Métodos

Add(Object)

Adiciona o objeto especificado SqlParameter ao SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(SqlParameter)

Adiciona o objeto especificado SqlParameter ao SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, Object)

Adiciona o objeto especificado SqlParameter ao SqlParameterCollection.Adds the specified SqlParameter object to the SqlParameterCollection.

Add(String, SqlDbType)

Adiciona um SqlParameter ao SqlParameterCollection, dado o nome do parâmetro o tipo de dados.Adds a SqlParameter to the SqlParameterCollection given the parameter name and the data type.

Add(String, SqlDbType, Int32)

Adiciona um SqlParameter ao SqlParameterCollection, dado o nome do parâmetro especificado, SqlDbType e tamanho.Adds a SqlParameter to the SqlParameterCollection, given the specified parameter name, SqlDbType and size.

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.Adds a SqlParameter to the SqlParameterCollection with the parameter name, the data type, and the column length.

AddRange(Array)

Adiciona uma matriz de valores ao final do SqlParameterCollection.Adds an array of values to the end of the SqlParameterCollection.

AddRange(SqlParameter[])

Adiciona uma matriz de valores SqlParameter ao final do SqlParameterCollection.Adds an array of SqlParameter values to the end of the SqlParameterCollection.

AddWithValue(String, Object)

Adiciona um valor ao final do SqlParameterCollection.Adds a value to the end of the SqlParameterCollection.

Clear()

Remove todos os objetos SqlParameter do SqlParameterCollection.Removes all the SqlParameter objects from the SqlParameterCollection.

Contains(Object)

Determina se o Object especificado está neste SqlParameterCollection.Determines whether the specified Object is in this SqlParameterCollection.

Contains(SqlParameter)

Determina se o SqlParameter especificado está neste SqlParameterCollection.Determines whether the specified SqlParameter is in this SqlParameterCollection.

Contains(String)

Determina se o nome de parâmetro especificado está neste SqlParameterCollection.Determines whether the specified parameter name is in this SqlParameterCollection.

CopyTo(Array, Int32)

Copia todos os elementos do SqlParameterCollection atual para o Array unidimensional especificado, começando no índice Array de destino especificado.Copies all the elements of the current SqlParameterCollection to the specified one-dimensional Array starting at the specified destination Array index.

CopyTo(SqlParameter[], Int32)

Copia todos os elementos do SqlParameterCollection atual para o SqlParameterCollection especificado, começando no índice de destino especificado.Copies all the elements of the current SqlParameterCollection to the specified SqlParameterCollection starting at the specified destination index.

CreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Herdado de MarshalByRefObject)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetEnumerator()

Retorna um enumerador que itera por meio de SqlParameterCollection.Returns an enumerator that iterates through the SqlParameterCollection.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
IndexOf(Object)

Obtém o local do Object especificado na coleção.Gets the location of the specified Object within the collection.

IndexOf(SqlParameter)

Obtém o local do SqlParameter especificado na coleção.Gets the location of the specified SqlParameter within the collection.

IndexOf(String)

Obtém o local do SqlParameter especificado com o nome especificado.Gets the location of the specified SqlParameter with the specified name.

InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
Insert(Int32, Object)

Insere um Object no SqlParameterCollection no índice especificado.Inserts an Object into the SqlParameterCollection at the specified index.

Insert(Int32, SqlParameter)

Insere um objeto SqlParameter no SqlParameterCollection no índice especificado.Inserts a SqlParameter object into the SqlParameterCollection at the specified index.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Herdado de MarshalByRefObject)
Remove(Object)

Remove o SqlParameter especificado da coleção.Removes the specified SqlParameter from the collection.

Remove(SqlParameter)

Remove o SqlParameter especificado da coleção.Removes the specified SqlParameter from the collection.

RemoveAt(Int32)

Remove o SqlParameter do SqlParameterCollection no índice especificado.Removes the SqlParameter from the SqlParameterCollection at the specified index.

RemoveAt(String)

Remove o SqlParameter do SqlParameterCollection no nome de parâmetro especificado.Removes the SqlParameter from the SqlParameterCollection at the specified parameter name.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Veja também