SqlParameterCollection Kelas

Definisi

Ruang nama:: System.Data.SqlClient

Rakitan:: System.Data.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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 : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection

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

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : MarshalByRefObject, System.Collections.IList, System.Data.IDataParameterCollection

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit MarshalByRefObject
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

Warisan: Object

MarshalByRefObject
SqlParameterCollection

Warisan: Object

MarshalByRefObject

DbParameterCollection
SqlParameterCollection

Atribut: ListBindableAttribute

Penerapan: ICollection IEnumerable IList IDataParameterCollection

Contoh

Contoh berikut membuat beberapa instans melalui SqlParameter SqlParameterCollection koleksi. Parameter digunakan untuk memilih data dalam sumber data dan mengisi DataSet. Kode ini mengasumsikan bahwa dan DataSet SqlDataAdapter 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

Nama	Deskripsi
Count	Mengembalikan Bilangan Bulat yang berisi jumlah elemen dalam SqlParameterCollection. Read-only.
IsFixedSize	Mendapatkan nilai yang menunjukkan apakah SqlParameterCollection memiliki ukuran tetap.
IsReadOnly	Mendapatkan nilai yang menunjukkan apakah SqlParameterCollection bersifat baca-saja.
IsSynchronized	Mendapatkan nilai yang menunjukkan apakah disinkronkan SqlParameterCollection .
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

Nama	Deskripsi
Add(Object)	Menambahkan objek yang ditentukan SqlParameter ke SqlParameterCollection.
Add(SqlParameter)	Menambahkan objek yang ditentukan SqlParameter ke SqlParameterCollection.
Add(String, Object)	Kedaluwarsa. Menambahkan objek yang ditentukan SqlParameter ke SqlParameterCollection.
Add(String, SqlDbType, Int32, String)	SqlParameter Menambahkan ke SqlParameterCollection dengan nama parameter, jenis data, dan panjang kolom.
Add(String, SqlDbType, Int32)	SqlParameter Menambahkan ke SqlParameterCollection, dengan nama parameter yang ditentukan, SqlDbType dan ukuran.
Add(String, SqlDbType)	SqlParameter Menambahkan ke SqlParameterCollection nama parameter dan jenis data yang diberikan.
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.
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)
GetEnumerator()	Mengembalikan enumerator yang berulang melalui SqlParameterCollection.
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)
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 Type instans 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.
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
Insert(Int32, Object)	Object Menyisipkan ke dalam SqlParameterCollection pada indeks yang ditentukan.
Insert(Int32, SqlParameter)	SqlParameter Menyisipkan objek ke SqlParameterCollection dalam pada indeks yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
Remove(Object)	Menghapus yang ditentukan SqlParameter dari koleksi.
Remove(SqlParameter)	Menghapus yang ditentukan SqlParameter dari koleksi.
RemoveAt(Int32)	SqlParameter Menghapus dari SqlParameterCollection pada indeks yang ditentukan.
RemoveAt(String)	SqlParameter Menghapus dari SqlParameterCollection pada 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)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IDataParameterCollection.Item[String]	Mendapatkan atau mengatur parameter pada indeks yang ditentukan. (Diperoleh dari DbParameterCollection)
IList.Item[Int32]	Mendapatkan atau mengatur elemen pada indeks yang ditentukan. (Diperoleh dari DbParameterCollection)

Metode Ekstensi

Nama	Deskripsi
AsParallel(IEnumerable)	Mengaktifkan paralelisasi kueri.
AsQueryable(IEnumerable)	Mengonversi IEnumerable menjadi IQueryable.
Cast<TResult>(IEnumerable)	Melemparkan elemen IEnumerable ke jenis yang ditentukan.
OfType<TResult>(IEnumerable)	Memfilter elemen IEnumerable berdasarkan jenis tertentu.

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?