OracleParameter Klasa

Definicja

Przestrzeń nazw:

System.Data.OracleClient

Zestaw:

System.Data.OracleClient.dll

Reprezentuje parametr elementu OracleCommand i opcjonalnie jego mapowanie na DataColumn. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

MarshalByRefObject

DbParameter

OracleParameter

Atrybuty

TypeConverterAttribute

Implementuje

IDataParameter IDbDataParameter ICloneable

Przykłady

Poniższy przykład tworzy wiele wystąpień OracleParameter obiektu za pośrednictwem OracleParameterCollection obiektu OracleDataAdapterw obiekcie . Te parametry służą do wybierania danych z bazy danych i umieszczania danych w obiekcie DataSet. W tym przykładzie przyjęto założenie, że obiekt DataSet i OracleDataAdapter został już utworzony przy użyciu odpowiedniego schematu, poleceń i połączenia.

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

Uwagi

W nazwach parametrów nie jest uwzględniana wielkość liter.

Podczas wykonywania zapytań względem bazy danych Oracle przy użyciu Microsoft OLE DB Provider dla Oracle (MSDAORA) i dostawcy danych platformy ODBC.NET, używanie LIKE klauzuli do wykonywania zapytań o wartości w polach o stałej długości może nie zwracać wszystkich oczekiwanych dopasowań. Przyczyną jest to, że gdy Oracle dopasuje wartości dla pól o stałej długości w LIKE klauzuli, pasuje do całej długości ciągu, w tym wszelkich spacji końcowych dopełnienia. Jeśli na przykład tabela w bazie danych Oracle zawiera pole o nazwie "Field1", które jest zdefiniowane jako char(3), a wartość "a" zostanie wprowadzona do wiersza tej tabeli, następujący kod nie zwróci wiersza.

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();  

Dzieje się tak, ponieważ oracle przechowuje wartość kolumny jako "a" (dopełnianie "a", ze spacjami końcowymi, do stałej długości pola 3), które Oracle nie traktuje jako dopasowania wartości parametru "a" w przypadku LIKE porównania pól o stałej długości.

Aby rozwiązać ten problem, dołącz symbol wieloznaczny procent ("%") do wartości parametru ("a%") lub zamiast tego użyj porównania SQL = .

Konstruktory

OracleParameter()	Inicjuje nowe wystąpienie klasy OracleParameter.
OracleParameter(String, Object)	Inicjuje OracleParameter nowe wystąpienie klasy, które używa nazwy parametru i OracleParameter obiektu.
OracleParameter(String, OracleType)	Inicjuje OracleParameter nowe wystąpienie klasy, które używa nazwy parametru i typu danych.
OracleParameter(String, OracleType, Int32)	Inicjuje OracleParameter nowe wystąpienie klasy, które używa nazwy parametru, typu danych i długości.
OracleParameter(String, OracleType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Inicjuje OracleParameter nowe wystąpienie klasy, które używa nazwy parametru, typu danych, długości, nazwy kolumny źródłowej, kierunku parametru, dokładności liczbowej i innych właściwości.
OracleParameter(String, OracleType, Int32, ParameterDirection, String, DataRowVersion, Boolean, Object)	Inicjuje OracleParameter nowe wystąpienie klasy, które używa nazwy parametru, typu danych, rozmiaru, kierunku, kolumny źródłowej, wersji źródłowej i innych właściwości.
OracleParameter(String, OracleType, Int32, String)	Inicjuje OracleParameter nowe wystąpienie klasy, które używa nazwy parametru, typu danych, długości i nazwy kolumny źródłowej.

Właściwości

DbType	Pobiera lub ustawia DbType parametr .
Direction	Pobiera lub ustawia wartość wskazującą, czy parametr jest parametrem tylko wejściowym, wyjściowym, dwukierunkowym lub zwracanym parametrem procedury składowanej.
IsNullable	Pobiera lub ustawia wartość wskazującą, czy parametr akceptuje wartości null.
Offset	Pobiera lub ustawia przesunięcie na Value właściwość .
OracleType	Pobiera lub ustawia OracleType parametr .
ParameterName	Pobiera lub ustawia nazwę .OracleParameter
Precision	Przestarzałe. Pobiera lub ustawia maksymalną liczbę cyfr używanych do reprezentowania Value właściwości.
Scale	Przestarzałe. Pobiera lub ustawia liczbę miejsc dziesiętnych, do których Value jest rozpoznawana.
Size	Pobiera lub ustawia maksymalny rozmiar danych w kolumnie w bajtach.
SourceColumn	Pobiera lub ustawia nazwę kolumny źródłowej zamapowanej na DataSet element i używany do ładowania lub zwracania elementu Value.
SourceColumnNullMapping	Pobiera lub ustawia wartość, która wskazuje, czy kolumna źródłowa jest dopuszczana do wartości null. Dzięki temu można OracleCommandBuilder poprawnie wygenerować instrukcje aktualizacji dla kolumn dopuszczanych do wartości null.
SourceVersion	Pobiera lub ustawia wartość DataRowVersion do użycia podczas ładowania Value.
Value	Pobiera lub ustawia wartość parametru.

Metody

CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
ResetDbType()	Resetuje typ skojarzony z tym OracleParameterelementem .
ResetOracleType()	Resetuje typ skojarzony z tym OracleParameterelementem .
ToString()	Pobiera ciąg zawierający element ParameterName.

Jawne implementacje interfejsu

ICloneable.Clone()	Aby uzyskać opis tego członka, zobacz Clone().
IDbDataParameter.Precision	Wskazuje dokładność parametrów liczbowych. (Odziedziczone po DbParameter)
IDbDataParameter.Scale	Aby uzyskać opis tego członka, zobacz Scale. (Odziedziczone po DbParameter)