SqlParameter Kelas

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

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

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

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

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

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

Warisan

DbParameter

SqlParameter

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 dalam parameter ADO.NET dan Mengonfigurasi.

using Microsoft.Data.SqlClient;
using System.Xml;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet categoriesDataSet;
    protected DataGrid dataGrid1;
    protected SqlDataAdapter categoriesAdapter;


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

    }
}

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 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 DataSet ke dan digunakan untuk memuat atau mengembalikan Value
SourceColumnNullMapping	Mengatur atau mendapatkan 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

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

Lihat juga

• SqlParameterCollection
• SqlCommand