SqlParameterCollection Classe

Definição

Espaço de Nomes:: System.Data.SqlClient

Assemblagem:: System.Data.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa uma coleção de parâmetros associados a a SqlCommand e respetivas correspondências para colunas em um DataSet. Esta classe não pode ser herdada.

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

Herança: Object

MarshalByRefObject
SqlParameterCollection

Herança: Object

MarshalByRefObject

DbParameterCollection
SqlParameterCollection

Atributos: ListBindableAttribute

Implementações: ICollection IEnumerable IList IDataParameterCollection

Exemplos

O exemplo seguinte cria múltiplas instâncias de SqlParameter através da SqlParameterCollection coleção. Os parâmetros são usados para selecionar dados dentro da fonte de dados e preencher o DataSet. Este código assume que a DataSet e a SqlDataAdapter já foram criados com o esquema, comandos e ligação apropriados.

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

Observações

Se o comando contiver uma instrução SQL ad hoc, em vez de um nome de procedimento armazenado, o número de parâmetros na coleção deve ser igual ao número de marcadores de parâmetros no texto do comando, caso contrário o SQL Server gera um erro. Com um procedimento armazenado, todos os parâmetros declarados no procedimento armazenado sem valor padrão devem ser fornecidos. Parâmetros declarados com um valor padrão são opcionais. Isto permite-te especificar um valor diferente do padrão.

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

Propriedades

Name	Description
Count	Devolve um inteiro que contém o número de elementos 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 é apenas de leitura.
IsSynchronized	Obtém um valor que indica se o SqlParameterCollection está sincronizado.
Item[Int32]	Obtém o SqlParameter no índice especificado.
Item[String]	Recebe o SqlParameter nome especificado.
SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso ao SqlParameterCollection.

Métodos

Name	Description
Add(Object)	Adiciona o objeto especificado SqlParameter ao SqlParameterCollection.
Add(SqlParameter)	Adiciona o objeto especificado SqlParameter ao SqlParameterCollection.
Add(String, Object)	Obsoleto. Adiciona o objeto especificado SqlParameter ao SqlParameterCollection.
Add(String, SqlDbType, Int32, String)	Adiciona a SqlParameter ao SqlParameterCollection com o nome do parâmetro, o tipo de dado e o comprimento da coluna.
Add(String, SqlDbType, Int32)	Adiciona um SqlParameter ao SqlParameterCollection, dado o nome do parâmetro especificado, SqlDbType e o tamanho.
Add(String, SqlDbType)	Adiciona a SqlParameter ao SqlParameterCollection nome do parâmetro dado e ao tipo de dado.
AddRange(Array)	Adiciona um array de valores ao final do SqlParameterCollection.
AddRange(SqlParameter[])	Adiciona um array de SqlParameter valores ao final do SqlParameterCollection.
AddWithValue(String, Object)	Adiciona um valor ao final do SqlParameterCollection.
Clear()	Remove todos os SqlParameter objetos do SqlParameterCollection.
Contains(Object)	Determina se o especificado Object pertence a este SqlParameterCollection.
Contains(SqlParameter)	Determina se o especificado SqlParameter pertence a este SqlParameterCollection.
Contains(String)	Determina se o nome do parâmetro especificado pertence a este SqlParameterCollection.
CopyTo(Array, Int32)	Copia todos os elementos da corrente SqlParameterCollection para a unidimensional Array especificada, começando no índice de destino Array especificado.
CopyTo(SqlParameter[], Int32)	Copia todos os elementos da corrente SqlParameterCollection para o índice de destino especificado SqlParameterCollection .
CreateObjRef(Type)	Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Devolve um enumerador que itera através do SqlParameterCollection.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject)
GetParameter(Int32)	Devolve o DbParameter objeto no índice especificado na coleção. (Herdado de DbParameterCollection)
GetParameter(String)	Devolve DbParameter o objeto com o nome especificado. (Herdado de DbParameterCollection)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(Object)	Obtém a localização do especificado Object dentro da coleção.
IndexOf(SqlParameter)	Obtém a localização do especificado SqlParameter dentro da coleção.
IndexOf(String)	Obtém a localização do especificado SqlParameter com o nome especificado.
InitializeLifetimeService()	Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject)
Insert(Int32, Object)	Insere um Object no SqlParameterCollection no índice especificado.
Insert(Int32, SqlParameter)	Insere um SqlParameter objeto no SqlParameterCollection índice especificado.
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject)
Remove(Object)	Remove o especificado SqlParameter da coleção.
Remove(SqlParameter)	Remove o especificado SqlParameter da coleção.
RemoveAt(Int32)	Remove o SqlParameter de no SqlParameterCollection índice especificado.
RemoveAt(String)	Remove o SqlParameter do SqlParameterCollection no nome do parâmetro especificado.
SetParameter(Int32, DbParameter)	Define o DbParameter objeto no índice especificado para um novo valor. (Herdado de DbParameterCollection)
SetParameter(String, DbParameter)	Define o DbParameter objeto com o nome especificado para um novo valor. (Herdado de DbParameterCollection)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)

Implementações de Interface Explícita

Name	Description
IDataParameterCollection.Item[String]	Obtém ou define o parâmetro no índice especificado. (Herdado de DbParameterCollection)
IList.Item[Int32]	Obtém ou define o elemento no índice especificado. (Herdado de DbParameterCollection)

Métodos da Extensão

Name	Description
AsParallel(IEnumerable)	Permite a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable para um IQueryable.
Cast<TResult>(IEnumerable)	Conjura os elementos de an IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base num tipo especificado.

Aplica-se a

Ver também

Comentários

Esta página foi útil?