OracleParameterCollection Classe
Definição
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 relevantes para um OracleCommand bem como as respetivas correspondências para colunas em um DataSet. Esta 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
- Herança
- Atributos
- Implementações
Exemplos
O exemplo seguinte cria múltiplas instâncias de OracleParameter através do OracleParameterCollection interior do OracleDataAdapter. Estes parâmetros são usados para selecionar dados dentro da base de dados e depois colocar os dados no DataSet. Este exemplo assume que a DataSet e an OracleDataAdapter já foram criados com o esquema, comandos e ligaçã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
Observações
Ao usar parâmetros nomeados, o número de parâmetros na coleção deve ser igual ao número de parâmetros nomeados no texto do comando, ou o .NET Framework Data Provider para Oracle gera um erro.
O Data Provider .NET Framework para Oracle não suporta o marcador de interrogação (?) para passar parâmetros a uma instrução SQL chamada por um OracleCommand de CommandType.Text. Neste caso, devem ser usados parâmetros nomeados. Por exemplo:
SELECT * FROM Customers WHERE CustomerID = :pCustomerID
Ao usar parâmetros nomeados numa instrução SQL chamada por um OracleCommand de CommandType.Text, deve preceder o nome do parâmetro com dois pontos (:). No entanto, num procedimento armazenado, ou ao referir-se a um parâmetro nomeado noutro local do seu código (por exemplo, ao adicionar OracleParameter objetos à Parameters propriedade), não preceda o parâmetro nomeado com dois pontos (:). O fornecedor de dados fornece automaticamente o dois-pontos.
Construtores
| Name | Description |
|---|---|
| OracleParameterCollection() |
Inicializa uma nova instância da OracleParameterCollection classe. |
Propriedades
| Name | Description |
|---|---|
| Count |
Devolve um inteiro contendo 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 é apenas de leitura. |
| IsSynchronized |
Obtém um valor que indica se o OracleParameterCollection está sincronizado. |
| Item[Int32] |
Obtém ou define o OracleParameter no índice especificado. |
| Item[String] |
Recebe 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
| Name | 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 ao OracleParameterCollection nome e valor do parâmetro atribuído. |
| Add(String, OracleType, Int32, String) |
Adiciona um OracleParameter ao OracleParameterCollection nome do parâmetro, tipo de dado, comprimento da coluna e nome da coluna de origem. |
| Add(String, OracleType, Int32) |
Adiciona an OracleParameter ao OracleParameterCollection nome do parâmetro, tipo de dado e comprimento da coluna. |
| Add(String, OracleType) |
Adiciona an OracleParameter ao OracleParameterCollection nome do parâmetro e do tipo de dado. |
| AddRange(Array) |
Adiciona um array de valores ao final do OracleParameterCollection. |
| AddRange(OracleParameter[]) |
Adiciona um array 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 pertence ao OracleParameterCollection. |
| Contains(String) |
Indica se um OracleParameter com o nome especificado está incluído na coleção. |
| CopyTo(Array, Int32) |
Copia todos os elementos da corrente OracleParameterCollection para a unidimensional Array especificada, começando no índice de destino Array especificado. |
| CopyTo(OracleParameter[], Int32) |
Copia todos os elementos da corrente OracleParameterCollection para o índice de destino especificado OracleParameterCollection . |
| 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 OracleParameterCollection. |
| 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(OracleParameter) |
Obtém a localização do especificado OracleParameter dentro da coleção. |
| IndexOf(String) |
Obtém a localização do especificado OracleParameter 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 a Object no OracleParameterCollection índice especificado. |
| Insert(Int32, OracleParameter) |
Insere um OracleParameter objeto no OracleParameterCollection í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 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 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. |