OracleParameterCollection Classe

Referência

Definição

Namespace:: System.Data.OracleClient

Assembly:: System.Data.OracleClient.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 OracleCommand, além de seus respectivos mapeamentos para colunas em um DataSet. Essa classe não pode ser herdada.

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

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

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

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

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

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

Public NotInheritable Class OracleParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList

Public NotInheritable Class OracleParameterCollection
Inherits DbParameterCollection

Herança: Object

MarshalByRefObject
OracleParameterCollection

Herança: Object

MarshalByRefObject

DbParameterCollection
OracleParameterCollection

Atributos: ListBindableAttribute

Implementações: ICollection IEnumerable IList IDataParameterCollection

Exemplos

O exemplo a seguir cria várias instâncias de OracleParameter por meio do OracleParameterCollection dentro do OracleDataAdapter. Esses parâmetros são usados para selecionar dados no banco de dados e, em seguida, colocar os dados no DataSet. Este exemplo pressupõe que um DataSet e um OracleDataAdapter já foram criados com o esquema, os comandos e a conexão apropriados.

public void AddOracleParameters()
 {
 // ...
 // create dataSet and adapter
 // ...
   adapter.SelectCommand.Parameters.Add("pEName", OracleType.VarChar, 80).Value = "Smith";
   adapter.SelectCommand.Parameters.Add("pEmpNo", OracleType.Int32).Value = 7369;
   adapter.Fill(dataSet);
 }

Public Sub AddOracleParameters()
    ' ...
    ' create dataSet and adapter
    ' ...
adapter.SelectCommand.Parameters.Add("pEName", OracleType.VarChar, 80).Value = "Smith"
adapter.SelectCommand.Parameters.Add("pEmpNo", OracleType.Int32).Value = 7369
adapter.Fill(dataSet)
End Sub

Comentários

Ao usar parâmetros nomeados, o número de parâmetros na coleção deve ser igual ao número de parâmetros nomeados dentro do texto do comando ou o provedor de dados .NET Framework para Oracle gera um erro.

O provedor de dados .NET Framework para Oracle não dá suporte ao espaço reservado de ponto de interrogação (?) para passar parâmetros para uma instrução SQL chamada por um OracleCommand de CommandType.Text. Nesse caso, parâmetros nomeados devem ser usados. Por exemplo:

SELECT * FROM Customers WHERE CustomerID = :pCustomerID

Ao usar parâmetros nomeados em uma instrução SQL chamada por um OracleCommand de CommandType.Text, você deve preceder o nome do parâmetro com dois-pontos (:). No entanto, em um procedimento armazenado ou ao fazer referência a um parâmetro nomeado em outro lugar no código (por exemplo, ao adicionar OracleParameter objetos à Parameters propriedade ), não preceda o parâmetro nomeado com dois-pontos (:). O provedor de dados fornece os dois-pontos automaticamente.

Construtores

OracleParameterCollection()

Inicializa uma nova instância da classe OracleParameterCollection.

Propriedades

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

Métodos

Add(Object)	Adiciona o objeto OracleParameter especificado ao OracleParameterCollection.
Add(OracleParameter)	Adiciona o OracleParameter especificado ao OracleParameterCollection.
Add(String, Object)	Obsoleto. Adiciona um OracleParameter ao OracleParameterCollection dado o nome e o valor do parâmetro.
Add(String, OracleType)	Adiciona um OracleParameter ao OracleParameterCollection, dado o nome do parâmetro o tipo de dados.
Add(String, OracleType, Int32)	Adiciona um OracleParameter ao OracleParameterCollection dado o nome do parâmetro, o tipo de dados e o comprimento da coluna.
Add(String, OracleType, Int32, String)	Adiciona um OracleParameter ao OracleParameterCollection, 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 OracleParameterCollection.
AddRange(OracleParameter[])	Adiciona uma matriz de valores OracleParameter ao final do OracleParameterCollection.
AddWithValue(String, Object)	Adiciona um valor ao final do OracleParameterCollection.
Clear()	Remove todos os objetos OracleParameter do OracleParameterCollection.
Contains(Object)	Determina se o objeto especificado está no OracleParameterCollection.
Contains(OracleParameter)	Determina se o OracleParameter especificado está no OracleParameterCollection.
Contains(String)	Indica se um OracleParameter com o nome especificado está contido na coleção.
CopyTo(Array, Int32)	Copia todos os elementos do OracleParameterCollection atual para o Array unidimensional especificado, começando no índice Array de destino especificado.
CopyTo(OracleParameter[], Int32)	Copia todos os elementos do OracleParameterCollection atual para o OracleParameterCollection 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 OracleParameterCollection.
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(OracleParameter)	Obtém o local do OracleParameter especificado na coleção.
IndexOf(String)	Obtém o local do OracleParameter 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 OracleParameterCollection no índice especificado.
Insert(Int32, OracleParameter)	Insere um objeto OracleParameter no OracleParameterCollection 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 OracleParameter especificado da coleção.
Remove(OracleParameter)	Remove o objeto OracleParameter especificado da coleção.
RemoveAt(Int32)	Remove o objeto OracleParameter no índice especificado da coleção.
RemoveAt(String)	Remove o objeto OracleParameter com o nome especificado da coleção.
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

Partilhar via