SqlParameterCollection Kelas

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.8.6

Mewakili kumpulan parameter yang terkait dengan SqlCommand dan pemetaan masing-masing ke kolom dalam DataSet. Kelas ini tidak dapat diwariskan.

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection

public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection

type SqlParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

Warisan

Object

DbParameterCollection

SqlParameterCollection

Contoh

Contoh berikut membuat beberapa instans melalui SqlParameterSqlParameterCollection koleksi. Parameter digunakan untuk memilih data dalam sumber data dan mengisi DataSet. Kode 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

Jika perintah berisi pernyataan SQL ad hoc, dibandingkan dengan nama prosedur tersimpan, jumlah parameter dalam koleksi harus sama dengan jumlah tempat penampung parameter dalam teks perintah, atau SQL Server menimbulkan kesalahan. Dengan prosedur tersimpan, semua parameter yang dideklarasikan dalam prosedur tersimpan tanpa nilai default harus disediakan. Parameter yang dideklarasikan dengan nilai default bersifat opsional. Ini memungkinkan Anda menentukan nilai selain default.

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

Properti

Count	Mengembalikan Bilangan Bulat yang berisi jumlah elemen dalam SqlParameterCollection. Baca-saja.
IsFixedSize	Mendapatkan nilai yang menunjukkan apakah SqlParameterCollection memiliki ukuran tetap.
IsReadOnly	Mendapatkan nilai yang menunjukkan apakah SqlParameterCollection bersifat baca-saja.
IsSynchronized	Menentukan apakah koleksi disinkronkan. (Diperoleh dari DbParameterCollection)
Item[Int32]	Mendapatkan pada SqlParameter indeks yang ditentukan.
Item[String]	SqlParameter Mendapatkan dengan nama yang ditentukan.
SyncRoot	Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke SqlParameterCollection.

Metode

Add(Object)	Menambahkan objek yang ditentukan SqlParameter ke SqlParameterCollection.
Add(SqlParameter)	Menambahkan objek yang ditentukan SqlParameter ke SqlParameterCollection.
Add(String, SqlDbType)	SqlParameter Menambahkan ke SqlParameterCollection nama parameter dan jenis data yang diberikan.
Add(String, SqlDbType, Int32)	SqlParameter Menambahkan ke SqlParameterCollection, dengan nama SqlDbType parameter dan ukuran yang ditentukan.
Add(String, SqlDbType, Int32, String)	SqlParameter Menambahkan ke SqlParameterCollection dengan nama parameter, jenis data, dan panjang kolom.
AddRange(Array)	Menambahkan array nilai ke akhir SqlParameterCollection.
AddRange(SqlParameter[])	Menambahkan array SqlParameter nilai ke akhir SqlParameterCollection.
AddWithValue(String, Object)	Menambahkan nilai ke akhir SqlParameterCollection.
Clear()	Menghapus semua SqlParameter objek dari SqlParameterCollection.
Contains(Object)	Menentukan apakah yang ditentukan Object ada di ini SqlParameterCollection.
Contains(SqlParameter)	Menentukan apakah yang ditentukan SqlParameter ada di ini SqlParameterCollection.
Contains(String)	Menentukan apakah nama parameter yang ditentukan ada di ini SqlParameterCollection.
CopyTo(Array, Int32)	Menyalin semua elemen saat ini SqlParameterCollection ke satu dimensi Array yang ditentukan mulai dari indeks tujuan Array yang ditentukan.
CopyTo(SqlParameter[], Int32)	Menyalin semua elemen saat ini SqlParameterCollection ke yang ditentukan SqlParameterCollection mulai dari indeks tujuan yang ditentukan.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetEnumerator()	Mengembalikan enumerator yang berulang melalui SqlParameterCollection.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetParameter(Int32)	Mengembalikan DbParameter objek pada indeks yang ditentukan dalam koleksi. (Diperoleh dari DbParameterCollection)
GetParameter(String)	Mengembalikan DbParameter objek dengan nama yang ditentukan. (Diperoleh dari DbParameterCollection)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
IndexOf(Object)	Mendapatkan lokasi yang ditentukan Object dalam koleksi.
IndexOf(SqlParameter)	Mendapatkan lokasi yang ditentukan SqlParameter dalam koleksi.
IndexOf(String)	Mendapatkan lokasi yang ditentukan SqlParameter dengan nama yang ditentukan.
Insert(Int32, Object)	Object Menyisipkan ke dalam pada SqlParameterCollection indeks yang ditentukan.
Insert(Int32, SqlParameter)	SqlParameter Menyisipkan objek ke dalam pada SqlParameterCollection indeks yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
Remove(Object)	Menghapus yang ditentukan SqlParameter dari koleksi.
Remove(SqlParameter)	Menghapus yang ditentukan SqlParameter dari koleksi.
RemoveAt(Int32)	SqlParameter Menghapus dari pada SqlParameterCollection indeks yang ditentukan.
RemoveAt(String)	SqlParameter Menghapus dari pada SqlParameterCollection nama parameter yang ditentukan.
SetParameter(Int32, DbParameter)	DbParameter Mengatur objek pada indeks yang ditentukan ke nilai baru. (Diperoleh dari DbParameterCollection)
SetParameter(String, DbParameter)	DbParameter Mengatur objek dengan nama yang ditentukan ke nilai baru. (Diperoleh dari DbParameterCollection)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Metode Ekstensi

Lihat juga

• Perintah dan Parameter (ADO.NET)
• Parameter DataAdapter (ADO.NET)
• Menggunakan Penyedia Data .NET Framework untuk SQL Server
• Ringkasan ADO.NET