OracleParameter Classe

Definição

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Representa um parâmetro para um OracleCommand e, opcionalmente, seu mapeamento para um DataColumn. Essa classe não pode ser herdada.

public ref class OracleParameter sealed : System::Data::Common::DbParameter, ICloneable

[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleParameter+OracleParameterConverter))]
public sealed class OracleParameter : System.Data.Common.DbParameter, ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleParameter+OracleParameterConverter))>]
type OracleParameter = class
    inherit DbParameter
    interface ICloneable
    interface IDbDataParameter
    interface IDataParameter

Public NotInheritable Class OracleParameter
Inherits DbParameter
Implements ICloneable

Herança

Object

MarshalByRefObject

DbParameter

OracleParameter

Atributos

TypeConverterAttribute

Implementações

IDataParameter IDbDataParameter ICloneable

Exemplos

O exemplo a seguir cria várias instâncias de por meio do OracleParameterOracleParameterCollection dentro do OracleDataAdapter. Esses parâmetros são usados para selecionar dados no banco de dados e colocar os dados no DataSet. Este exemplo pressupõe que um DataSet e um OracleDataAdapter já foram criados usando 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

Os nomes de parâmetro não diferenciam maiúsculas de minúsculas.

Ao consultar um banco de dados Oracle usando o Provedor Microsoft OLE DB para Oracle (MSDAORA) e o provedor de dados ODBC.NET Framework, usar a LIKE cláusula para consultar valores em campos de comprimento fixo pode não retornar todas as correspondências esperadas. O motivo é que, quando o Oracle corresponde a valores para campos de comprimento fixo em uma LIKE cláusula, ele corresponde a todo o comprimento da cadeia de caracteres, incluindo quaisquer espaços à direita de preenchimento. Por exemplo, se uma tabela em um banco de dados Oracle contiver um campo chamado "Field1" definido como char(3)e você inserir o valor "a" em uma linha dessa tabela, o código a seguir não retornará a linha.

Dim queryString As String = "SELECT * FROM Table1 WHERE Field1 LIKE ?"  
Dim command As OleDbCommand = New OleDbCommand(queryString, connection)  
command.Parameters.Add("@p1", OleDbType.Char, 3).Value = "a"  
Dim reader As OleDbDataReader = command.ExecuteReader()  

string queryString = "SELECT * FROM Table1 WHERE Field1 LIKE ?";  
OleDbCommand command = new OleDbCommand(queryString, connection);  
command.Parameters.Add("@p1", OleDbType.Char, 3).Value = "a";  
OleDbDataReader reader = command.ExecuteReader();  

Isso ocorre porque a Oracle armazena o valor da coluna como "a" (preenchimento "a", com espaços à direita, para o comprimento fixo do campo de 3), que o Oracle não trata como uma correspondência para o valor do parâmetro de "a" no caso de uma LIKE comparação de campos de comprimento fixo.

Para resolve esse problema, acrescente um caractere curinga percentual ("%") ao valor do parâmetro ("a%") ou use uma comparação de SQL=.

Construtores

OracleParameter()	Inicializa uma nova instância da classe OracleParameter.
OracleParameter(String, Object)	Inicializa uma nova instância da classe OracleParameter que usa o nome do parâmetro e um objeto OracleParameter.
OracleParameter(String, OracleType)	Inicializa uma nova instância da classe OracleParameter que usa o nome do parâmetro e o tipo de dados.
OracleParameter(String, OracleType, Int32)	Inicializa uma nova instância da classe OracleParameter que usa o nome do parâmetro, o tipo de dados e o tamanho.
OracleParameter(String, OracleType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Inicializa uma nova instância da classe OracleParameter que usa o nome do parâmetro, o tipo de dados, o tamanho, o nome da coluna de origem, a direção de parâmetro, a precisão numérica e outras propriedades.
OracleParameter(String, OracleType, Int32, ParameterDirection, String, DataRowVersion, Boolean, Object)	Inicializa uma nova instância da classe OracleParameter que usa o nome do parâmetro, o tipo de dados, o tamanho, a direção, a coluna de origem, a versão de origem e outras propriedades.
OracleParameter(String, OracleType, Int32, String)	Inicializa uma nova instância da classe OracleParameter que usa o nome do parâmetro, o tipo de dados, o tamanho e o nome da coluna de origem.

Propriedades

DbType	Obtém ou define o DbType do parâmetro.
Direction	Obtém ou define um valor que indica se o parâmetro é apenas de entrada, saída, bidirecional ou um parâmetro de valor retornado do procedimento armazenado.
IsNullable	Obtém ou define um valor que indica se o parâmetro aceita valores nulos.
Offset	Obtém ou define o deslocamento para a propriedade Value.
OracleType	Obtém ou define o OracleType do parâmetro.
ParameterName	Obtém ou define o nome de OracleParameter.
Precision	Obsoleto. Obtém ou define o número máximo de dígitos usados para representar a propriedade Value.
Scale	Obsoleto. Obtém ou define o número de casas decimais para as quais o Value é resolvido.
Size	Obtém ou define o tamanho máximo, em bytes, dos dados da coluna.
SourceColumn	Obtém ou define o nome da coluna de origem mapeada para o DataSet e usada para carregar ou retornar o Value.
SourceColumnNullMapping	Obtém ou define um valor que indica se a coluna de origem permite valor nulo. Isso permite que OracleCommandBuilder gere corretamente instruções Update para colunas que permitem valor nulo.
SourceVersion	Obtém ou define o DataRowVersion a ser usado ao carregar Value.
Value	Obtém ou define o valor do parâmetro.

Métodos

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)
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 ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	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)
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)
ResetDbType()	Redefine o tipo associado a este OracleParameter.
ResetOracleType()	Redefine o tipo associado a este OracleParameter.
ToString()	Obtém uma cadeia de caracteres que contém o ParameterName.

Implantações explícitas de interface

ICloneable.Clone()	Para obter uma descrição desse membro, confira Clone().
IDbDataParameter.Precision	Indica a precisão de parâmetros numéricos. (Herdado de DbParameter)
IDbDataParameter.Scale	Para obter uma descrição desse membro, confira Scale. (Herdado de DbParameter)