OracleParameter 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 um parâmetro para um OracleCommand e opcionalmente o seu mapeamento para um DataColumn. Esta 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 seguinte cria múltiplas instâncias de OracleParameter através do OracleParameterCollection interior do OracleDataAdapter. Estes parâmetros são usados para selecionar dados da base de dados e colocar os dados no DataSet. Este exemplo assume que a DataSet e an OracleDataAdapter já foram criados usando 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
Os nomes dos parâmetros não são sensíveis a maiúsculas minúsculas.
Ao consultar uma base de dados Oracle usando o Microsoft OLE DB Provider for Oracle (MSDAORA) e o ODBC.NET Framework Data Provider, usar a cláusula LIKE para consultar valores em campos de comprimento fixo pode não devolver todas as correspondências esperadas. A razão é que, quando o Oracle corresponde aos valores dos campos de comprimento fixo numa LIKE cláusula, corresponde a todo o comprimento da cadeia, incluindo quaisquer espaços de preenchimento que terminem. Por exemplo, se uma tabela numa base de dados Oracle contiver um campo chamado "Field1" definido como char(3), e inserir o valor "a" numa linha dessa tabela, o código seguinte não devolverá 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();
Isto deve-se ao facto de a Oracle armazenar o valor da coluna como "a" (preenchendo "a", com espaços finais, para o comprimento fixo do campo 3), que a Oracle não trata como correspondência para o valor do parâmetro "a" no caso de uma LIKE comparação de campos de comprimento fixo.
Para resolver este problema, adicione um carácter coringa percentual ("%") ao valor do parâmetro ("a%"), ou use uma comparação SQL = em vez disso.
Construtores
| Name | Description |
|---|---|
| OracleParameter() |
Inicializa uma nova instância da OracleParameter classe. |
| 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 OracleParameter classe que utiliza o nome do parâmetro, tipo de dados, comprimento, nome da coluna de origem, direção do parâmetro, precisão numérica e outras propriedades. |
| OracleParameter(String, OracleType, Int32, ParameterDirection, String, DataRowVersion, Boolean, Object) |
Inicializa uma nova instância da OracleParameter classe que utiliza o nome do parâmetro, tipo de dado, tamanho, direção, coluna de origem, versão de origem e outras propriedades. |
| OracleParameter(String, OracleType, Int32, String) |
Inicializa uma nova instância da OracleParameter classe que utiliza o nome do parâmetro, tipo de dado, comprimento e nome da coluna de origem. |
| OracleParameter(String, OracleType, Int32) |
Inicializa uma nova instância da OracleParameter classe que utiliza o nome do parâmetro, tipo de dado e comprimento. |
| OracleParameter(String, OracleType) |
Inicializa uma nova instância da OracleParameter classe que utiliza o nome do parâmetro e o tipo de dado. |
Propriedades
| Name | Description |
|---|---|
| DbType |
Obtém ou define o DbType do parâmetro. |
| Direction |
Recebe ou define um valor que indica se o parâmetro é apenas de entrada, apenas saída, bidirecional ou um parâmetro de retorno 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 offset para a Value propriedade. |
| OracleType |
Obtém ou define o OracleType do 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 o DataSet e usada para carregar ou devolver o Value. |
| SourceColumnNullMapping |
Recebe ou define um valor que indica se a coluna de origem é anulável. Isto permite OracleCommandBuilder gerar corretamente instruções Update para colunas anuláveis. |
| SourceVersion |
Obtém ou define o DataRowVersion para usar quando carregas Value. |
| Value |
Obtém ou define o valor do parâmetro. |
Métodos
| Name | Description |
|---|---|
| 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) |
| 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) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| InitializeLifetimeService() |
Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| 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) |
| ResetDbType() |
Reinicia o tipo associado a este OracleParameter. |
| ResetOracleType() |
Reinicia o tipo associado a este OracleParameter. |
| ToString() |
Obtém-se uma cadeia que contém o ParameterName. |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| ICloneable.Clone() |
Para uma descrição deste elemento, veja Clone(). |
| IDbDataParameter.Precision |
Indica a precisão dos parâmetros numéricos. (Herdado de DbParameter) |
| IDbDataParameter.Scale |
Para uma descrição deste elemento, veja Scale. (Herdado de DbParameter) |