OdbcParameter Kelas

Definisi

Ruang nama:

System.Data.Odbc

Rakitan:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v8.0.0

Sumber:

OdbcParameter.cs

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

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

public sealed class OdbcParameter : System.Data.Common.DbParameter, ICloneable

type OdbcParameter = class
    inherit DbParameter
    interface ICloneable
    interface IDataParameter
    interface IDbDataParameter

Public NotInheritable Class OdbcParameter
Inherits DbParameter
Implements ICloneable

Warisan

Object

DbParameter

OdbcParameter

Penerapan

IDataParameter IDbDataParameter ICloneable

Contoh

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

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

        // Set the parameters.
        adapter.SelectCommand.Parameters.Add(
            "@CategoryName", OdbcType.VarChar, 80).Value = "toasters";
        adapter.SelectCommand.Parameters.Add(
            "@SerialNum", OdbcType.Int).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 OdbcConnection(connectionString)
        Dim adapter As New OdbcDataAdapter(queryString, connection)

        ' Set the parameters.
        adapter.SelectCommand.Parameters.Add( _
            "@CategoryName", OdbcType.VarChar, 80).Value = "toasters"
        adapter.SelectCommand.Parameters.Add( _
         "@SerialNum", OdbcType.Int).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

Nama parameter tidak peka huruf besar/kecil.

Saat mengkueri database Oracle menggunakan Microsoft OLE DB Provider untuk Oracle (MSDAORA) dan Penyedia Data .NET Framework ODBC, menggunakan LIKE klausul untuk mengkueri nilai dalam bidang panjang tetap mungkin tidak mengembalikan semua kecocokan yang diharapkan. Alasannya adalah bahwa ketika Oracle cocok dengan nilai untuk bidang panjang tetap dalam LIKE klausul, oracle cocok dengan seluruh panjang string, termasuk spasi berikutnya. 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, ke 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

OdbcParameter()	Menginisialisasi instans baru kelas OdbcParameter.
OdbcParameter(String, Object)	Menginisialisasi instans OdbcParameter baru kelas yang menggunakan nama parameter dan OdbcParameter objek.
OdbcParameter(String, OdbcType)	Menginisialisasi instans OdbcParameter baru kelas yang menggunakan nama parameter dan jenis data.
OdbcParameter(String, OdbcType, Int32)	Menginisialisasi instans OdbcParameter baru kelas yang menggunakan nama parameter, jenis data, dan panjang.
OdbcParameter(String, OdbcType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Menginisialisasi instans OdbcParameter baru kelas yang menggunakan nama parameter, jenis data, panjang, nama kolom sumber, arah parameter, presisi numerik, dan properti lainnya.
OdbcParameter(String, OdbcType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object)	Menginisialisasi instans OdbcParameter baru kelas yang menggunakan nama parameter, jenis data, panjang, nama kolom sumber, arah parameter, presisi numerik, dan properti lainnya.
OdbcParameter(String, OdbcType, Int32, String)	Menginisialisasi instans OdbcParameter 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, hanya output, dua arah, atau parameter nilai pengembalian prosedur tersimpan.
IsNullable	Mendapatkan atau menetapkan nilai yang menunjukkan apakah parameter menerima nilai null.
OdbcType	Mendapatkan atau mengatur OdbcType parameter .
Offset	Mewakili parameter ke OdbcCommand dan secara opsional, pemetaannya ke DataColumn. Kelas ini tidak dapat diwariskan.
ParameterName	Mendapatkan atau mengatur nama OdbcParameter.
Precision	Mendapatkan atau mengatur jumlah digit yang digunakan untuk mewakili Value properti .
Scale	Mendapatkan atau mengatur jumlah tempat desimal yang Value diselesaikan.
Size	Mendapatkan atau mengatur ukuran maksimum data dalam kolom.
SourceColumn	Mendapatkan atau mengatur nama kolom sumber yang dipetakan DataSet ke dan digunakan untuk memuat atau mengembalikan Value.
SourceColumnNullMapping	Mendapatkan atau mengatur nilai yang menunjukkan apakah kolom sumber dapat diubah ke null. Ini memungkinkan DbCommandBuilder pembuatan 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 instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ResetDbType()	Mereset jenis yang terkait dengan ini OdbcParameter.
ResetOdbcType()	Mereset jenis yang terkait dengan ini OdbcParameter.
ToString()	Mendapatkan string yang berisi ParameterName.

Implementasi Antarmuka Eksplisit

ICloneable.Clone()

Untuk deskripsi anggota ini, lihat Clone().

Lihat juga

• Bekerja dengan Perintah