Bagikan melalui


SqlParameter Kelas

Definisi

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
public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter
public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable
public sealed class SqlParameter : System.Data.Common.DbParameter
[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))]
public sealed class SqlParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter
[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
type SqlParameter = class
    inherit DbParameter
[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))>]
type SqlParameter = class
    inherit MarshalByRefObject
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable
[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable
type SqlParameter = class
    inherit DbParameter
    interface ICloneable
Public NotInheritable Class SqlParameter
Inherits DbParameter
Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter
Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable
Warisan
SqlParameter
Warisan
Warisan
SqlParameter
Atribut
Penerapan

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.

SourceVersion

Mendapatkan atau mengatur DataRowVersion untuk digunakan saat Anda memuat Value.

(Diperoleh dari DbParameter)
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()
Kedaluwarsa.

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

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

IDataParameter.SourceVersion

Mendapatkan atau mengatur DataRowVersion untuk digunakan saat memuat Value.

(Diperoleh dari DbParameter)
IDbDataParameter.Precision

Menunjukkan presisi parameter numerik.

(Diperoleh dari DbParameter)
IDbDataParameter.Scale

Untuk deskripsi anggota ini, lihat Scale.

(Diperoleh dari DbParameter)

Berlaku untuk

Lihat juga