OdbcParameterCollection Classe

Referência

Definição

Namespace:: System.Data.Odbc

Assembly:: System.Data.Odbc.dll

Assembly:: System.Data.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

public ref class OdbcParameterCollection sealed : System::Data::Common::DbParameterCollection

public ref class OdbcParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection

public sealed class OdbcParameterCollection : System.Data.Common.DbParameterCollection

[System.ComponentModel.ListBindable(false)]
public sealed class OdbcParameterCollection : MarshalByRefObject, System.Collections.IList, System.Data.IDataParameterCollection

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

type OdbcParameterCollection = class
    inherit DbParameterCollection

[<System.ComponentModel.ListBindable(false)>]
type OdbcParameterCollection = class
    inherit MarshalByRefObject
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable

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

Public NotInheritable Class OdbcParameterCollection
Inherits DbParameterCollection

Public NotInheritable Class OdbcParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList

Herança: Object

DbParameterCollection
OdbcParameterCollection

Herança: Object

MarshalByRefObject

DbParameterCollection
OdbcParameterCollection

Herança: Object

MarshalByRefObject
OdbcParameterCollection

Atributos: ListBindableAttribute

Implementações: ICollection IEnumerable IList IDataParameterCollection

Exemplos

O exemplo a seguir pressupõe que a fonte de dados tenha uma tabela chamada MoneyTable e um procedimento armazenado chamado MoneyProcedure, que são definidos da seguinte maneira:

CREATE TABLE MoneyTable (col1 int, col2 smallmoney, col3 decimal);  

CREATE PROC MoneyProcedure (@p1 int, @p2 smallmoney, @p3 decimal)   
AS   
INSERT INTO MyTable VALUES (@p1, @p2, @p3);

O exemplo cria parâmetros e chama o procedimento armazenado MoneyProcedure .

public void CreateMyProc(OdbcConnection connection)
{
    OdbcCommand command = connection.CreateCommand();
    command.CommandText = "{ call MyProc(?,?,?) }";

    OdbcParameter param = new OdbcParameter();
    param.DbType = DbType.Int32;
    param.Value = 1;
    command.Parameters.Add(param);

    param = new OdbcParameter();
    param.DbType = DbType.Decimal;
    param.Value = 1;
    command.Parameters.Add(param);

    param = new OdbcParameter();
    param.DbType = DbType.Decimal;
    param.Value = 1;
    command.Parameters.Add(param);

    command.ExecuteNonQuery();
 }

Public Sub CreateMyProc(ByVal connection As OdbcConnection)

  Dim command As OdbcCommand = connection.CreateCommand()
  Command.CommandText = "{ call MyProc(?,?,?) }"

  Dim param As New OdbcParameter()
  param.DbType = DbType.Int32
  param.Value = 1
  command.Parameters.Add(param)

  param = New OdbcParameter()
  param.DbType = DbType.Decimal
  param.Value = 1
  command.Parameters.Add(param)

  param = New OdbcParameter()
  param.DbType = DbType.Decimal
  param.Value = 1
  command.Parameters.Add(param)

  command.ExecuteNonQuery()

End Sub

Comentários

O número de parâmetros na coleção deve ser igual ao número de espaços reservados de parâmetro dentro do texto de comando ou então o .NET Framework Provedor de Dados para ODBC gera um erro.

Propriedades

Count	Retorna um inteiro que contém o número de argumentos no OdbcParameterCollection. Somente leitura.
IsFixedSize	Obtém um valor que indica se o OdbcParameterCollection tem um tamanho fixo. Somente leitura.
IsReadOnly	Obtém um valor que indica se o OdbcParameterCollection é somente leitura.
IsSynchronized	Obtém um valor que indica se o OdbcParameterCollection é sincronizado. Somente leitura.
Item[Int32]	Obtém ou define o OdbcParameter no índice especificado.
Item[String]	Obtém ou define o OdbcParameter com o nome especificado.
SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso ao OdbcParameterCollection. Somente leitura.

Métodos

Add(Object)	Adiciona o objeto OdbcParameter especificado ao OdbcParameterCollection.
Add(OdbcParameter)	Adiciona o OdbcParameter especificado ao OdbcParameterCollection.
Add(String, Object)	Obsoleto. Obsoleto. Obsoleto. Adiciona um OdbcParameter ao OdbcParameterCollection dado o nome e o valor do parâmetro.
Add(String, OdbcType)	Adiciona um OdbcParameter ao OdbcParameterCollection, dado o nome do parâmetro o tipo de dados.
Add(String, OdbcType, Int32)	Adiciona um OdbcParameter ao OdbcParameterCollection dado o nome do parâmetro, o tipo de dados e o comprimento da coluna.
Add(String, OdbcType, Int32, String)	Adiciona um OdbcParameter ao OdbcParameterCollection, considerando o nome de parâmetro, tipo de dados, tamanho da coluna e nome da coluna de origem.
AddRange(Array)	Adiciona uma matriz de valores ao final do OdbcParameterCollection.
AddRange(OdbcParameter[])	Adiciona uma matriz de valores OdbcParameter ao final do OdbcParameterCollection.
AddWithValue(String, Object)	Adiciona um valor ao final do OdbcParameterCollection.
Clear()	Remove todos os objetos OdbcParameter de OdbcParameterCollection.
Contains(Object)	Determina se o Object especificado está neste OdbcParameterCollection.
Contains(OdbcParameter)	Determina se o OdbcParameter especificado está neste OdbcParameterCollection.
Contains(String)	Obtém um valor que indica se um objeto OdbcParameter com o nome de parâmetro especificado existe na coleção.
CopyTo(Array, Int32)	Copia todos os elementos do OdbcParameterCollection atual para o Array unidimensional especificado, começando no índice Array de destino especificado.
CopyTo(OdbcParameter[], Int32)	Copia todos os elementos do OdbcParameterCollection atual para o OdbcParameterCollection especificado, começando no índice de destino especificado.
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. (Herdado de MarshalByRefObject)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Retorna um enumerador que itera por meio de OdbcParameterCollection.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetParameter(Int32)	Retorna o objeto DbParameter no índice especificado na coleção. (Herdado de DbParameterCollection)
GetParameter(String)	Retorna o objeto DbParameter com o nome especificado. (Herdado de DbParameterCollection)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(Object)	Obtém o local do Object especificado na coleção.
IndexOf(OdbcParameter)	Obtém o local do OdbcParameter especificado na coleção.
IndexOf(String)	Obtém o local do OdbcParameter especificado com o nome especificado.
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
Insert(Int32, Object)	Insere um Object no OdbcParameterCollection no índice especificado.
Insert(Int32, OdbcParameter)	Insere um objeto OdbcParameter no OdbcParameterCollection no índice especificado.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
Remove(Object)	Remove o objeto Object do OdbcParameterCollection.
Remove(OdbcParameter)	Remove o OdbcParameter do OdbcParameterCollection.
RemoveAt(Int32)	Remove o OdbcParameter do OdbcParameterCollection no índice especificado.
RemoveAt(String)	Remove o OdbcParameter do OdbcParameterCollection com o nome de parâmetro especificado.
SetParameter(Int32, DbParameter)	Define o objeto DbParameter no índice especificado para um novo valor. (Herdado de DbParameterCollection)
SetParameter(String, DbParameter)	Define o objeto DbParameter com o nome especificado para um novo valor. (Herdado de DbParameterCollection)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

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 de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Aplica-se a