OleDbParameter Kelas

Definisi

Ruang nama:

System.Data.OleDb

Rakitan:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v8.0.0

Sumber:

OleDbParameter.cs

Mewakili parameter ke OleDbCommand dan secara opsional pemetaannya ke DataSet kolom. Kelas ini tidak dapat diwariskan.

public ref class OleDbParameter sealed : System::Data::Common::DbParameter, ICloneable

[System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbParameter+OleDbParameterConverter))]
public sealed class OleDbParameter : System.Data.Common.DbParameter, ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbParameter+OleDbParameterConverter))>]
type OleDbParameter = class
    inherit DbParameter
    interface ICloneable
    interface IDbDataParameter
    interface IDataParameter

Public NotInheritable Class OleDbParameter
Inherits DbParameter
Implements ICloneable

Warisan

Object

DbParameter

OleDbParameter

Atribut

TypeConverterAttribute

Penerapan

IDataParameter IDbDataParameter ICloneable

Contoh

Contoh berikut membuat beberapa instans OleDbParameter melalui OleDbParameterCollection koleksi dalam OleDbDataAdapter. Parameter ini digunakan untuk memilih data dari sumber data dan menempatkan data di DataSet. Contoh ini mengasumsikan bahwa DataSet dan OleDbDataAdapter telah dibuat dengan menggunakan skema, perintah, dan koneksi yang sesuai.

public DataSet GetDataSetFromAdapter(
    DataSet dataSet, string connectionString, string queryString)
{
    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter =
            new OleDbDataAdapter(queryString, connection);

        // Set the parameters.
        adapter.SelectCommand.Parameters.Add(
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters";
        adapter.SelectCommand.Parameters.Add(
            "@SerialNum", OleDbType.Integer).Value = 239;

        // Open the connection and fill the DataSet.
        try
        {
            connection.Open();
            adapter.Fill(dataSet);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
    return dataSet;
}

Public Function GetDataSetFromAdapter( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter(queryString, connection)

        ' Set the parameters.
        adapter.SelectCommand.Parameters.Add( _
            "@CategoryName", OleDbType.VarChar, 80).Value = "toasters"
        adapter.SelectCommand.Parameters.Add( _
         "@SerialNum", OleDbType.Integer).Value = 239

        ' Open the connection and fill the DataSet.
        Try
            connection.Open()
            adapter.Fill(dataSet)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using

    Return dataSet
End Function

Keterangan

Penyedia Data OLE DB.NET Framework menggunakan parameter posisi yang ditandai dengan tanda tanya (?) alih-alih parameter bernama.

Saat mengkueri database Oracle menggunakan Microsoft OLE DB Provider untuk Oracle (MSDAORA) dan Penyedia Data Kerangka Kerja DB.NET OLE, 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 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

OleDbParameter()	Menginisialisasi instans baru kelas OleDbParameter.
OleDbParameter(String, Object)	Menginisialisasi instans OleDbParameter baru kelas yang menggunakan nama parameter dan nilai baru OleDbParameter.
OleDbParameter(String, OleDbType)	Menginisialisasi instans OleDbParameter baru kelas yang menggunakan nama parameter dan jenis data.
OleDbParameter(String, OleDbType, Int32)	Menginisialisasi instans OleDbParameter baru kelas yang menggunakan nama parameter, jenis data, dan panjang.
OleDbParameter(String, OleDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Menginisialisasi instans OleDbParameter baru kelas yang menggunakan nama parameter, jenis data, panjang, nama kolom sumber, arah parameter, presisi numerik, dan properti lainnya.
OleDbParameter(String, OleDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object)	Menginisialisasi instans OleDbParameter baru kelas yang menggunakan nama parameter, jenis data, panjang, nama kolom sumber, arah parameter, presisi numerik, dan properti lainnya.
OleDbParameter(String, OleDbType, Int32, String)	Menginisialisasi instans OleDbParameter 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 kembali prosedur tersimpan.
IsNullable	Mendapatkan atau menetapkan nilai yang menunjukkan apakah parameter menerima nilai null.
OleDbType	Mendapatkan atau mengatur OleDbType parameter .
ParameterName	Mendapatkan atau mengatur nama OleDbParameter.
Precision	Mendapatkan atau mengatur jumlah maksimum digit yang digunakan untuk mewakili Value properti .
Scale	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 DbCommandBuilder 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

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ResetDbType()	Mengatur ulang jenis yang terkait dengan ini OleDbParameter.
ResetOleDbType()	Mengatur ulang jenis yang terkait dengan ini OleDbParameter.
ToString()	Mendapatkan string yang berisi ParameterName.

Implementasi Antarmuka Eksplisit

ICloneable.Clone()

Untuk deskripsi anggota ini, lihat Clone().

Lihat juga

• Bekerja dengan Perintah