IDataParameter Antarmuka

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Mewakili parameter ke objek Perintah, dan secara opsional, pemetaannya ke DataSet kolom; dan diimplementasikan oleh penyedia data .NET yang mengakses sumber data.

public interface class IDataParameter

public interface IDataParameter

type IDataParameter = interface

Public Interface IDataParameter

Turunan

System.Data.Common.DbParameter

System.Data.EntityClient.EntityParameter

System.Data.IDbDataParameter

System.Data.Odbc.OdbcParameter

System.Data.OleDb.OleDbParameter

System.Data.OracleClient.OracleParameter

Contoh

Contoh berikut membuat beberapa instans dari kelas turunan, SqlParameter, melalui SqlParameterCollection koleksi dalam SqlDataAdapter. Parameter ini digunakan untuk memilih data dari sumber data dan menempatkan data di DataSet. Contoh ini mengasumsikan bahwa dan DataSetSqlDataAdapter telah dibuat dengan skema, perintah, dan koneksi yang sesuai.

public void AddSqlParameters()
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...

  categoriesAdapter.SelectCommand.Parameters.Add(
    "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
  categoriesAdapter.SelectCommand.Parameters.Add(
    "@SerialNum", SqlDbType.Int).Value = 239;
  categoriesAdapter.Fill(categoriesDataSet);
}

Public Sub AddSqlParameters()
    ' ...
    ' create categoriesDataSet and categoriesAdapter
    ' ...
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters"
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@SerialNum", SqlDbType.Int).Value = 239
    
    categoriesAdapter.Fill(categoriesDataSet)
End Sub

Keterangan

Antarmuka IDataParameter memungkinkan kelas warisan untuk mengimplementasikan kelas Parameter, yang mewakili parameter ke objek Perintah. Untuk informasi selengkapnya tentang kelas Parameter, lihat Mengonfigurasi Parameter dan Jenis Data Parameter.

Aplikasi tidak membuat instans IDataParameter antarmuka secara langsung, tetapi membuat instans kelas yang mewarisi IDataParameter.

Kelas yang mewarisi IDataParameter harus menerapkan anggota yang diwariskan, dan biasanya menentukan anggota tambahan untuk menambahkan fungsionalitas khusus penyedia. Misalnya, IDataParameter antarmuka mendefinisikan DbType properti . Pada gilirannya OleDbParameter , kelas mewarisi properti ini, dan juga menentukan OleDbType properti .

Catatan Bagi Implementer

Untuk mempromosikan konsistensi di antara penyedia data .NET Framework, beri nama kelas pewarisan dalam parameter formulir Prv di mana Prv adalah awalan seragam yang diberikan ke semua kelas dalam namespace layanan penyedia data .NET Framework tertentu. Misalnya, Sql adalah awalan SqlCommand kelas di System.Data.SqlClient namespace layanan.

Saat Mewarisi dari IDataParameter antarmuka, Anda harus mengimplementasikan konstruktor berikut:

Item	Deskripsi
PrvParameter()	Menginisialisasi instans baru dari kelas Parameter.
PrvParameter(nama string, PrvDbType dataType)	Menginisialisasi instans baru kelas Parameter dengan nama parameter dan jenis data.
PrvParameter(nama string, nilai objek)	Menginisialisasi instans baru kelas Parameter dengan nama parameter dan objek yang merupakan nilai Parameter.
PrvParameter(nama string, PrvDbType dataType, ukuran int)	Menginisialisasi instans baru kelas Parameter dengan nama parameter, jenis data, dan lebar.
PrvParameter(nama string, PrvDbType dataType, ukuran int, string srcColumn)	Menginisialisasi instans baru kelas DbParameter dengan nama parameter, jenis data, lebar, dan nama kolom sumber.
PrvParameter(parameterName string, PrvDbType dbType, ukuran int, arah ParameterDirection, Boolean isNullable, Presisi Byte, Skala byte, string srcColumn, DataRowVersion srcVersion, nilai objek)	Menginisialisasi instans OleDbParameter baru kelas dengan nama parameter, jenis data, lebar, nama kolom sumber, arah parameter, presisi numerik, dan properti lainnya.

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 nilai yang menunjukkan apakah parameter menerima nilai null.
ParameterName	Mendapatkan atau mengatur nama IDataParameter.
SourceColumn	Mendapatkan atau mengatur nama kolom sumber yang dipetakan ke DataSet dan digunakan untuk memuat atau mengembalikan Value.
SourceVersion	Mendapatkan atau mengatur DataRowVersion untuk digunakan saat memuat Value.
Value	Mendapatkan atau menetapkan nilai parameter.