SqlParameter Kelas

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.dll

Mewakili parameter ke SqlCommand dan secara opsional pemetaannya ke DataSet kolom. Kelas ini tidak dapat diwariskan. Untuk informasi selengkapnya tentang parameter, lihat Mengonfigurasi Parameter dan Jenis Data Parameter.

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

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

Warisan

Object

MarshalByRefObject

DbParameter

SqlParameter

Atribut

TypeConverterAttribute

Penerapan

IDataParameter IDbDataParameter ICloneable

Contoh

Contoh berikut membuat beberapa instans SqlParameter melalui SqlParameterCollection koleksi dalam SqlDataAdapter. Parameter ini digunakan untuk memilih data dari sumber data dan memasukkan data ke DataSetdalam . Contoh ini mengasumsikan bahwa dan DataSetSqlDataAdapter telah dibuat dengan menggunakan skema, perintah, dan koneksi yang sesuai. Untuk informasi selengkapnya dan contoh tambahan tentang menggunakan parameter, lihat Mengambil dan Memodifikasi Data di ADO.NET dan Mengonfigurasi Parameter dan Jenis Data Parameter.

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

Nama parameter tidak peka huruf besar/kecil.

Catatan

Tanpa nama, juga disebut ordinal, parameter tidak didukung oleh Penyedia Data .NET Framework untuk SQL Server.

Untuk informasi selengkapnya, bersama dengan kode sampel tambahan yang menunjukkan cara menggunakan parameter, lihat Perintah dan Parameter.

Konstruktor

SqlParameter()	Menginisialisasi instans baru kelas SqlParameter.
SqlParameter(String, Object)	Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter dan nilai baru SqlParameter.
SqlParameter(String, SqlDbType)	Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter dan jenis data.
SqlParameter(String, SqlDbType, Int32)	Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter, SqlDbType, dan ukuran .
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter, jenis parameter, ukuran parameter, ParameterDirection, presisi parameter, skala parameter, kolom sumber, DataRowVersion untuk digunakan, dan nilai parameter.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter, jenis parameter, panjang parameter arah, presisi, skala, nama kolom sumber, salah DataRowVersion satu nilai, Boolean untuk pemetaan kolom sumber, nilai SqlParameter, nama database tempat kumpulan skema untuk instans XML ini berada, skema relasional pemilik tempat koleksi skema untuk instans XML ini berada, dan nama koleksi skema untuk parameter ini.
SqlParameter(String, SqlDbType, Int32, String)	Menginisialisasi instans SqlParameter baru kelas yang menggunakan nama parameter, SqlDbType, ukuran, dan nama kolom sumber.

Properti

CompareInfo	Mendapatkan atau mengatur CompareInfo objek yang menentukan bagaimana perbandingan string harus dilakukan untuk parameter ini.
DbType	Mendapatkan atau mengatur SqlDbType parameter .
Direction	Mendapatkan atau menetapkan nilai yang menunjukkan apakah parameter hanya input, output saja, dua arah, atau parameter nilai pengembalian prosedur tersimpan.
ForceColumnEncryption	Memberlakukan enkripsi parameter saat menggunakan Always Encrypted. Jika SQL Server memberi tahu driver bahwa parameter tidak perlu dienkripsi, kueri yang menggunakan parameter akan gagal. Properti ini memberikan perlindungan tambahan terhadap serangan keamanan yang melibatkan SQL Server yang disusupi yang memberikan metadata enkripsi yang salah kepada klien, yang dapat menyebabkan pengungkapan data.
IsNullable	Mendapatkan atau menetapkan nilai yang menunjukkan apakah parameter menerima nilai null. IsNullable tidak digunakan untuk memvalidasi nilai parameter dan tidak akan mencegah pengiriman atau penerimaan nilai null saat menjalankan perintah.
LocaleId	Mendapatkan atau mengatur pengidentifikasi lokal yang menentukan konvensi dan bahasa untuk wilayah tertentu.
Offset	Mendapatkan atau mengatur offset ke Value properti .
ParameterName	Mendapatkan atau mengatur nama SqlParameter.
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 SqlCommandBuilder untuk menghasilkan pernyataan Pembaruan dengan benar untuk kolom yang dapat diubah ke null.
SourceVersion	Mendapatkan atau mengatur DataRowVersion untuk digunakan saat Anda memuat Value.
SqlDbType	Mendapatkan atau mengatur SqlDbType parameter .
SqlValue	Mendapatkan atau menetapkan nilai parameter sebagai jenis SQL.
TypeName	Mendapatkan atau mengatur nama jenis untuk parameter bernilai tabel.
UdtTypeName	Mendapatkan atau mengatur string yang mewakili jenis yang ditentukan pengguna sebagai parameter.
Value	Mendapatkan atau menetapkan nilai parameter.
XmlSchemaCollectionDatabase	Mendapatkan nama database tempat kumpulan skema untuk instans XML ini berada.
XmlSchemaCollectionName	Mendapatkan nama koleksi skema untuk instans XML ini.
XmlSchemaCollectionOwningSchema	Skema relasional pemilik tempat kumpulan skema untuk instans XML ini berada.

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 SqlParameter.
ResetSqlDbType()	Mengatur ulang jenis yang terkait dengan ini SqlParameter.
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)

Lihat juga

• SqlParameterCollection
• SqlCommand
• Perintah dan Parameter
• Parameter DataAdapter
• SQL Server dan ADO.NET
• Ringkasan ADO.NET