SqlParameterCollection Kelas

Definisi

Ruang nama:: System.Data.SqlClient

Rakitan:: System.Data.SqlClient.dll

Rakitan:: System.Data.dll

Sumber:: System.Data.SqlClient.notsupported.cs

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.

Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.

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

public ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection

public sealed class SqlParameterCollection : 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

type SqlParameterCollection = class
    inherit 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 DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList

Warisan: Object

DbParameterCollection
SqlParameterCollection

Warisan: Object

MarshalByRefObject

DbParameterCollection
SqlParameterCollection

Warisan: Object

MarshalByRefObject
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. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
IsFixedSize	Mendapatkan nilai yang menunjukkan apakah SqlParameterCollection memiliki ukuran tetap. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
IsReadOnly	Mendapatkan nilai yang menunjukkan apakah SqlParameterCollection bersifat baca-saja. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
IsSynchronized	Mendapatkan nilai yang menunjukkan apakah disinkronkan SqlParameterCollection . Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Item[Int32]	Mendapatkan pada SqlParameter indeks yang ditentukan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Item[String]	SqlParameter Mendapatkan dengan nama yang ditentukan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
SyncRoot	Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke SqlParameterCollection. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.

Metode

Nama	Deskripsi
Add(Object)	Menambahkan objek yang ditentukan SqlParameter ke SqlParameterCollection. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Add(SqlParameter)	Menambahkan objek yang ditentukan SqlParameter ke SqlParameterCollection. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Add(String, Object)	Kedaluwarsa. Menambahkan objek yang ditentukan SqlParameter ke SqlParameterCollection. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Add(String, SqlDbType, Int32, String)	SqlParameter Menambahkan ke SqlParameterCollection dengan nama parameter, jenis data, dan panjang kolom. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Add(String, SqlDbType, Int32)	SqlParameter Menambahkan ke SqlParameterCollection, dengan nama parameter yang ditentukan, SqlDbType dan ukuran. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Add(String, SqlDbType)	SqlParameter Menambahkan ke SqlParameterCollection nama parameter dan jenis data yang diberikan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
AddRange(Array)	Menambahkan array nilai ke akhir SqlParameterCollection. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
AddRange(SqlParameter[])	Menambahkan array SqlParameter nilai ke akhir SqlParameterCollection. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
AddWithValue(String, Object)	Menambahkan nilai ke akhir SqlParameterCollection. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Clear()	Menghapus semua SqlParameter objek dari SqlParameterCollection. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Contains(Object)	Menentukan apakah yang ditentukan Object ada di ini SqlParameterCollection. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Contains(SqlParameter)	Menentukan apakah yang ditentukan SqlParameter ada di ini SqlParameterCollection. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Contains(String)	Menentukan apakah nama parameter yang ditentukan ada di ini SqlParameterCollection. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
CopyTo(Array, Int32)	Menyalin semua elemen saat ini SqlParameterCollection ke satu dimensi Array yang ditentukan mulai dari indeks tujuan Array yang ditentukan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
CopyTo(SqlParameter[], Int32)	Menyalin semua elemen saat ini SqlParameterCollection ke yang ditentukan SqlParameterCollection mulai dari indeks tujuan yang ditentukan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
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. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
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)
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. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
IndexOf(SqlParameter)	Mendapatkan lokasi yang ditentukan SqlParameter dalam koleksi. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
IndexOf(String)	Mendapatkan lokasi yang ditentukan SqlParameter dengan nama yang ditentukan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
InitializeLifetimeService()	Kedaluwarsa. 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. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Insert(Int32, SqlParameter)	SqlParameter Menyisipkan objek ke SqlParameterCollection dalam pada indeks yang ditentukan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek MarshalByRefObject saat ini. (Diperoleh dari MarshalByRefObject)
Remove(Object)	Menghapus yang ditentukan SqlParameter dari koleksi. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Remove(SqlParameter)	Menghapus yang ditentukan SqlParameter dari koleksi. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
RemoveAt(Int32)	SqlParameter Menghapus dari SqlParameterCollection pada indeks yang ditentukan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
RemoveAt(String)	SqlParameter Menghapus dari SqlParameterCollection pada nama parameter yang ditentukan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
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
ICollection.IsSynchronized	Mendapatkan nilai yang menunjukkan apakah akses ke ICollection disinkronkan (utas aman). (Diperoleh dari DbParameterCollection)
IDataParameterCollection.Item[String]	Mendapatkan atau mengatur parameter pada indeks yang ditentukan. (Diperoleh dari DbParameterCollection)
IList.IsFixedSize	Mendapatkan nilai yang menunjukkan apakah IList memiliki ukuran tetap. (Diperoleh dari DbParameterCollection)
IList.IsReadOnly	Mendapatkan nilai yang menunjukkan apakah IList bersifat baca-saja. (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?