OracleParameter Classe
Definição
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 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
- 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) |