OracleParameter Kelas

Definisi

Ruang nama:

System.Data.OracleClient

Rakitan:

System.Data.OracleClient.dll

Mewakili parameter ke OracleCommand dan secara opsional pemetaannya ke DataColumn. Kelas ini tidak dapat diwariskan.

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

Warisan

Object

MarshalByRefObject

DbParameter

OracleParameter

Atribut

TypeConverterAttribute

Penerapan

IDataParameter IDbDataParameter ICloneable

Contoh

Contoh berikut membuat beberapa instans OracleParameter melalui OracleParameterCollection dalam OracleDataAdapter. Parameter ini digunakan untuk memilih data dari database dan menempatkan data di DataSet. Contoh ini mengasumsikan bahwa DataSet dan OracleDataAdapter telah dibuat dengan menggunakan skema, perintah, dan koneksi yang sesuai.

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

Keterangan

Nama parameter tidak peka huruf besar/kecil.

Saat mengkueri database Oracle menggunakan Microsoft OLE DB Provider untuk Oracle (MSDAORA) dan Penyedia Data kerangka kerja ODBC.NET, menggunakan LIKE klausul untuk mengkueri nilai dalam bidang panjang tetap mungkin tidak mengembalikan semua kecocokan yang diharapkan. Alasannya adalah bahwa ketika Oracle mencocokkan nilai untuk bidang panjang tetap dalam LIKE klausul, oracle cocok dengan seluruh panjang string, termasuk spasi berikutnya padding. Misalnya, jika tabel dalam database Oracle berisi bidang bernama "Field1" yang didefinisikan sebagai char(3), dan Anda memasukkan nilai "a" ke dalam baris tabel tersebut, kode berikut tidak akan mengembalikan baris.

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

Ini karena Oracle menyimpan nilai kolom sebagai "a " (padding "a", dengan spasi berikutnya, dengan panjang bidang tetap 3), yang tidak diperlakukan Oracle sebagai kecocokan untuk nilai parameter "a" dalam kasus perbandingan LIKE bidang panjang tetap.

Untuk mengatasi masalah ini, tambahkan persentase ("%") karakter kartubebas ke nilai parameter ("a%"), atau gunakan perbandingan SQL = sebagai gantinya.

Konstruktor

OracleParameter()	Menginisialisasi instans baru kelas OracleParameter.
OracleParameter(String, Object)	Menginisialisasi instans OracleParameter baru kelas yang menggunakan nama parameter dan OracleParameter objek .
OracleParameter(String, OracleType)	Menginisialisasi instans OracleParameter baru kelas yang menggunakan nama parameter dan jenis data.
OracleParameter(String, OracleType, Int32)	Menginisialisasi instans OracleParameter baru kelas yang menggunakan nama parameter, jenis data, dan panjang.
OracleParameter(String, OracleType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Menginisialisasi instans OracleParameter baru kelas yang menggunakan nama parameter, jenis data, panjang, nama kolom sumber, arah parameter, presisi numerik, dan properti lainnya.
OracleParameter(String, OracleType, Int32, ParameterDirection, String, DataRowVersion, Boolean, Object)	Menginisialisasi instans OracleParameter baru kelas yang menggunakan nama parameter, jenis data, ukuran, arah, kolom sumber, versi sumber, dan properti lainnya.
OracleParameter(String, OracleType, Int32, String)	Menginisialisasi instans OracleParameter baru kelas yang menggunakan nama parameter, jenis data, panjang, dan nama kolom sumber.

Properti

DbType	Mendapatkan atau mengatur DbType parameter .
Direction	Mendapatkan atau menetapkan nilai yang menunjukkan apakah parameter hanya input, output saja, dua arah, atau parameter nilai pengembalian prosedur tersimpan.
IsNullable	Mendapatkan atau menetapkan nilai yang menunjukkan apakah parameter menerima nilai null.
Offset	Mendapatkan atau mengatur offset ke Value properti .
OracleType	Mendapatkan atau mengatur OracleType parameter .
ParameterName	Mendapatkan atau mengatur nama OracleParameter.
Precision	Kedaluwarsa. Mendapatkan atau mengatur jumlah maksimum digit yang digunakan untuk mewakili Value properti .
Scale	Kedaluwarsa. Mendapatkan atau mengatur jumlah tempat desimal yang Value diselesaikan.
Size	Mendapatkan atau mengatur ukuran maksimum, dalam byte, dari data dalam kolom.
SourceColumn	Mendapatkan atau mengatur nama kolom sumber yang dipetakan ke DataSet dan digunakan untuk memuat atau mengembalikan Value.
SourceColumnNullMapping	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kolom sumber dapat diubah ke null. Ini memungkinkan OracleCommandBuilder untuk menghasilkan pernyataan Pembaruan dengan benar untuk kolom yang dapat diubah ke null.
SourceVersion	Mendapatkan atau mengatur DataRowVersion untuk digunakan saat Anda memuat Value.
Value	Mendapatkan atau menetapkan nilai parameter.

Metode

CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
ResetDbType()	Mengatur ulang jenis yang terkait dengan ini OracleParameter.
ResetOracleType()	Mengatur ulang jenis yang terkait dengan ini OracleParameter.
ToString()	Mendapatkan string yang berisi ParameterName.

Implementasi Antarmuka Eksplisit

ICloneable.Clone()	Untuk deskripsi anggota ini, lihat Clone().
IDbDataParameter.Precision	Menunjukkan presisi parameter numerik. (Diperoleh dari DbParameter)
IDbDataParameter.Scale	Untuk deskripsi anggota ini, lihat Scale. (Diperoleh dari DbParameter)