OracleParameterCollection Classe

Definição

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Representa uma coleção de parâmetros relevantes para um OracleCommand , bem como seus respectivos mapeamentos para colunas em um DataSet. Essa classe não pode ser herdada.

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

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

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

Public NotInheritable Class OracleParameterCollection
Inherits DbParameterCollection

Herança

Object

MarshalByRefObject

DbParameterCollection

OracleParameterCollection

Atributos

ListBindableAttribute

Exemplos

O exemplo a seguir cria várias instâncias por meio do OracleParameterOracleParameterCollectionOracleDataAdapter. 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 de comando ou o Provedor de Dados do .NET Framework para Oracle gera um erro.

O Provedor de Dados do .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, os 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 se referir a um parâmetro nomeado em outro lugar em seu 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

Nome	Description
OracleParameterCollection()	Inicializa uma nova instância da classe OracleParameterCollection.

Propriedades

Nome	Description
Count	Retorna um Inteiro que contém o número de elementos no 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 valor é somente leitura.
IsSynchronized	Obtém um valor que indica se o OracleParameterCollection valor está sincronizado.
Item[Int32]	Obtém ou define o OracleParameter índice especificado.
Item[String]	Obtém ou define o OracleParameter nome com o nome especificado.
SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso ao OracleParameterCollection.

Métodos

Nome	Description
Add(Object)	Adiciona o objeto especificado OracleParameter ao OracleParameterCollection.
Add(OracleParameter)	Adiciona o especificado OracleParameter ao OracleParameterCollection.
Add(String, Object)	Obsoleto. Adiciona um OracleParameter valor e o OracleParameterCollection nome do parâmetro fornecidos.
Add(String, OracleType, Int32, String)	Adiciona um OracleParameter ao nome do parâmetro, ao tipo de dados, ao comprimento da coluna e ao OracleParameterCollection nome da coluna de origem fornecidos.
Add(String, OracleType, Int32)	Adiciona um OracleParameter ao nome do parâmetro, ao tipo de dados e ao OracleParameterCollection comprimento da coluna fornecidos.
Add(String, OracleType)	Adiciona um OracleParameter ao nome do parâmetro e ao OracleParameterCollection tipo de dados fornecidos.
AddRange(Array)	Adiciona uma matriz de valores ao final do OracleParameterCollection.
AddRange(OracleParameter[])	Adiciona uma matriz de OracleParameter valores ao final do OracleParameterCollection.
AddWithValue(String, Object)	Adiciona um valor ao final do OracleParameterCollection.
Clear()	Remove todos os OracleParameter objetos do OracleParameterCollection.
Contains(Object)	Determina se o objeto especificado está no OracleParameterCollection.
Contains(OracleParameter)	Determina se o especificado OracleParameter 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 da corrente OracleParameterCollection para a inicialização unidimensional Array especificada no índice de destino Array especificado.
CopyTo(OracleParameter[], Int32)	Copia todos os elementos da corrente OracleParameterCollection para o especificado OracleParameterCollection 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 do OracleParameterCollection.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
GetParameter(Int32)	Retorna o DbParameter objeto no índice especificado na coleção. (Herdado de DbParameterCollection)
GetParameter(String)	Retorna 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 o local do especificado Object na coleção.
IndexOf(OracleParameter)	Obtém o local do especificado OracleParameter na coleção.
IndexOf(String)	Obtém o local do especificado OracleParameter com o nome especificado.
InitializeLifetimeService()	Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida dessa instância. (Herdado de MarshalByRefObject)
Insert(Int32, Object)	Insere um Object no OracleParameterCollection índice especificado.
Insert(Int32, OracleParameter)	Insere um OracleParameter objeto OracleParameterCollection no índice especificado.
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject)
Remove(Object)	Remove o objeto especificado OracleParameter da coleção.
Remove(OracleParameter)	Remove o objeto especificado OracleParameter da coleção.
RemoveAt(Int32)	Remove o OracleParameter objeto no índice especificado da coleção.
RemoveAt(String)	Remove o OracleParameter objeto com o nome especificado da coleção.
SetParameter(Int32, DbParameter)	Define o DbParameter objeto no índice especificado como um novo valor. (Herdado de DbParameterCollection)
SetParameter(String, DbParameter)	Define o DbParameter objeto com o nome especificado como 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

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

Nome	Description
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.
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.