OracleParameter Classe

Definição

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 : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter
public ref class OracleParameter sealed : System::Data::Common::DbParameter, ICloneable
[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleParameter+OracleParameterConverter))]
public sealed class OracleParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter
[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 MarshalByRefObject
    interface IDbDataParameter
    interface IDataParameter
    interface 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 MarshalByRefObject
Implements ICloneable, IDbDataParameter
Public NotInheritable Class OracleParameter
Inherits DbParameter
Implements ICloneable
Herança
OracleParameter
Herança
Atributos
Implementações

Exemplos

O exemplo a seguir cria várias instâncias por meio do OracleParameterOracleParameterCollectionOracleDataAdapter. Esses parâmetros são usados para selecionar dados do 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 ODBC.NET Framework Provedor de Dados, usar a cláusula LIKE 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 de campo fixo de 3), que o Oracle não trata como uma correspondência para o valor de parâmetro de "a" no caso de uma LIKE comparação de campos de comprimento fixo.

Para resolver esse problema, acrescente uma porcentagem ("%") caractere curinga ao valor do parâmetro ("a%") ou use uma comparação sql = em vez disso.

Construtores

Nome Description
OracleParameter()

Inicializa uma nova instância da classe OracleParameter.

OracleParameter(String, Object)

Inicializa uma nova instância da OracleParameter classe que usa o nome do parâmetro e um OracleParameter objeto.

OracleParameter(String, OracleType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

Inicializa uma nova instância da classe que usa o nome do parâmetro, o tipo de dados, o comprimento, o nome da coluna de origem, a direção do parâmetro, a OracleParameter precisão numérica e outras propriedades.

OracleParameter(String, OracleType, Int32, ParameterDirection, String, DataRowVersion, Boolean, Object)

Inicializa uma nova instância da classe 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 OracleParameter e outras propriedades.

OracleParameter(String, OracleType, Int32, String)

Inicializa uma nova instância da classe que usa o nome do parâmetro, o tipo de dados, o comprimento e o nome da OracleParameter coluna de origem.

OracleParameter(String, OracleType, Int32)

Inicializa uma nova instância da OracleParameter classe que usa o nome do parâmetro, o tipo de dados e o comprimento.

OracleParameter(String, OracleType)

Inicializa uma nova instância da OracleParameter classe que usa o nome do parâmetro e o tipo de dados.

Propriedades

Nome Description
DbType

Obtém ou define o DbType parâmetro.

Direction

Obtém ou define um valor que indica se o parâmetro é somente entrada, somente saída, bidirecional ou um parâmetro de valor retornado de 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 Value propriedade.

OracleType

Obtém ou define o OracleType parâmetro.

ParameterName

Obtém ou define o nome do OracleParameter.

Precision
Obsoleto.

Obtém ou define o número máximo de dígitos usados para representar a Value propriedade.

Scale
Obsoleto.

Obtém ou define o número de casas decimais para as quais Value é resolvido.

Size

Obtém ou define o tamanho máximo, em bytes, dos dados dentro da coluna.

SourceColumn

Obtém ou define o nome da coluna de origem mapeada para a DataSet e usada para carregar ou retornar o Value.

SourceColumnNullMapping

Obtém ou define um valor que indica se a coluna de origem é anulável. Isso permite OracleCommandBuilder gerar corretamente instruções update para colunas anuláveis.

SourceVersion

Obtém ou define o DataRowVersion uso a ser usado quando você carrega Value.

Value

Obtém ou define o valor do parâmetro.

Métodos

Nome Description
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 hash predefinida.

(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)
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 dessa instância.

(Herdado de MarshalByRefObject)
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)
ResetDbType()

Redefine o tipo associado a isso OracleParameter.

ResetOracleType()

Redefine o tipo associado a isso OracleParameter.

ToString()

Obtém uma cadeia de caracteres que contém o ParameterName.

Implantações explícitas de interface

Nome Description
ICloneable.Clone()

Para obter uma descrição deste membro, consulte Clone().

IDbDataParameter.Precision

Indica a precisão dos parâmetros numéricos.

(Herdado de DbParameter)
IDbDataParameter.Scale

Para obter uma descrição deste membro, consulte Scale.

(Herdado de DbParameter)

Aplica-se a