SqlParameterCollection Kelas

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

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

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

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

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

Warisan

DbParameterCollection

SqlParameterCollection

Atribut

ListBindableAttribute

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.

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

Jika perintah berisi pernyataan ad hoc SQL, 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 dinyatakan 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.
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 dalam ini SqlParameterCollection.
Contains(SqlParameter)	Menentukan apakah yang ditentukan SqlParameter ada di dalam 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.
GetEnumerator()	Mengembalikan enumerator yang melakukan iterasi melalui SqlParameterCollection.
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 SqlParameterCollection dalam pada indeks yang ditentukan.
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.