Share via

ParameterCollection Kelas

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mewakili kumpulan objek turunan Parameter dan Parameteryang digunakan oleh kontrol sumber data dalam skenario pengikatan data tingkat lanjut.

public ref class ParameterCollection : System::Web::UI::StateManagedCollection
public class ParameterCollection : System.Web.UI.StateManagedCollection
type ParameterCollection = class
    inherit StateManagedCollection
Public Class ParameterCollection
Inherits StateManagedCollection
Warisan
Object
StateManagedCollection
ParameterCollection

Contoh

Contoh kode berikut menunjukkan cara menggunakan AccessDataSource kontrol dan FormParameter untuk menampilkan informasi dari database Microsoft Access dalam GridView kontrol. Objek FormParameter ditambahkan ke SelectParameters koleksi menggunakan Add metode .

Penting

Contoh ini memiliki kotak teks yang menerima input pengguna, yang merupakan potensi ancaman keamanan. Secara default, ASP.NET halaman Web memvalidasi bahwa input pengguna tidak menyertakan elemen skrip atau HTML. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

void Page_Load(Object sender, EventArgs e){

  // You can add a FormParameter to the AccessDataSource control's
  // SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear();

  // Security Note: The AccessDataSource uses a FormParameter,
  // Security Note: which does not perform validation of input from the client.
  // Security Note: To validate the value of the FormParameter,
  // Security Note: handle the Selecting event.

  FormParameter formParam = new FormParameter("lastname","LastNameBox");
  formParam.Type=TypeCode.String;
  AccessDataSource1.SelectParameters.Add(formParam);
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

      <br />
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </form>
  </body>
</html>

<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

Private Sub Page_Load(sender As Object, e As EventArgs)

  ' You can add a FormParameter to the AccessDataSource control's
  ' SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear()

  ' Security Note: The AccessDataSource uses a FormParameter,
  ' Security Note: which does not perform validation of input from the client.
  ' Security Note: To validate the value of the FormParameter,
  ' Security Note: handle the Selecting event.

  Dim formParam As New FormParameter("lastname","LastNameBox")
  formParam.Type=TypeCode.String
  AccessDataSource1.SelectParameters.Add(formParam)
End Sub ' Page_Load

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

      <br />
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </form>
  </body>
</html>

Keterangan

Kelas ParameterCollection mewakili kumpulan Parameter objek yang digunakan dalam skenario pengikatan data tingkat lanjut dengan kontrol sumber data. Objek Parameter digunakan untuk mengikat nilai yang terkandung oleh variabel lokal Page , cookie HTTP, variabel sesi, dan nilai kontrol lainnya ke kontrol sumber data saat mengambil, memperbarui, menghapus, dan menyisipkan data.

ParameterCollection Gunakan kelas untuk mengelola sekumpulan Parameter objek secara terprogram. Anda dapat menambahkan, menyisipkan, dan menghapus Parameter objek menggunakan metode kelas yang ParameterCollection sesuai. Untuk mengambil Parameter objek secara terprogram dari koleksi, gunakan salah satu metode berikut:

  • Gunakan pengindeks untuk mendapatkan satu Parameter objek dari koleksi, berdasarkan nama atau menggunakan notasi array.

  • GetEnumerator Gunakan metode untuk membuat System.Collections.IEnumeratorobjek yang diimplementasikan, yang kemudian dapat digunakan untuk mendapatkan item dari koleksi.

Properti Count menentukan jumlah total item dalam koleksi, dan digunakan untuk menentukan batas atas koleksi. Anda dapat menambahkan dan menghapus item dari koleksi dengan menggunakan Addmetode , , InsertRemove, dan RemoveAt .

Tergantung pada implementasi dan semantik kontrol sumber data tertentu, urutan di mana parameter disimpan dalam ParameterCollection koleksi mungkin penting. Misalnya, saat menggunakan SqlDataSource kontrol sebagai sumber data ODBC, urutan Parameter objek dalam ParameterCollection koleksi harus sama dengan urutan parameter dalam kueri SQL berparameter yang Anda gunakan. Namun, saat menggunakan SqlDataSource kontrol dengan Microsoft SQL Server, urutan Parameter objek tidak penting.

Penting

Saat Anda menggunakan kontrol sumber data, nilai dimasukkan ke dalam parameter perintah tanpa validasi, yang merupakan potensi ancaman keamanan. Gunakan peristiwa dalam kontrol sumber data untuk memvalidasi nilai parameter sebelum perintah dijalankan. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.

Tabel berikut mencantumkan kelas parameter yang berbeda dan bagaimana mereka digunakan.

Kelas Parameter Deskripsi
Parameter Kelas parameter dasar. Gunakan untuk mengikat ke variabel lokal atau string statis apa pun menggunakan DefaultValue properti .
ControlParameter Parameter yang dapat digunakan untuk mengikat properti kontrol atau nilai pengembalian metode.
CookieParameter Parameter yang dapat digunakan untuk mengikat nilai cookie.
FormParameter Parameter yang dapat digunakan untuk mengikat atribut halaman Formulir Web saat ini.
QueryStringParameter Parameter yang dapat digunakan untuk mengikat ke nilai yang diteruskan ke halaman Formulir Web pada string kueri.
SessionParameter Parameter yang dapat digunakan untuk mengikat nilai variabel sesi.
ProfileParameter Parameter yang dapat digunakan untuk mengikat nilai properti Profil ASP.NET.

Konstruktor

ParameterCollection()

Menginisialisasi kelas untuk digunakan oleh instans kelas yang diwariskan. Konstruktor ini hanya dapat dipanggil oleh kelas yang diwariskan.

Properti

Count

Mendapatkan jumlah elemen yang terkandung dalam StateManagedCollection koleksi.

(Diperoleh dari StateManagedCollection)
Item[Int32]

Mendapatkan atau mengatur Parameter objek pada indeks yang ditentukan dalam koleksi.
Item[String]

Mendapatkan atau mengatur Parameter objek dengan nama yang ditentukan dalam koleksi.

Metode

Add(Parameter)

Menambahkan objek yang ditentukan Parameter ke akhir koleksi.
Add(String, DbType, String)

Parameter Membuat objek dengan nama, jenis database, dan nilai default yang ditentukan, dan menambahkannya ke akhir koleksi.
Add(String, String)

Parameter Membuat objek dengan nama dan nilai default yang ditentukan, dan menambahkannya ke akhir koleksi.
Add(String, TypeCode, String)

Parameter Membuat objek dengan nama yang ditentukan, TypeCode, dan nilai default, dan menambahkannya ke akhir koleksi.
Clear()

Menghapus semua item dari StateManagedCollection koleksi.

(Diperoleh dari StateManagedCollection)
Contains(Parameter)

Menentukan apakah ParameterCollection koleksi berisi nilai tertentu.
CopyTo(Array, Int32)

Menyalin elemen StateManagedCollection koleksi ke array, dimulai pada indeks array tertentu.

(Diperoleh dari StateManagedCollection)
CopyTo(Parameter[], Int32)

Menyalin indeks tertentu dari array parameter ke koleksi parameter.
CreateKnownType(Int32)

Membuat instans objek default Parameter .
Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetEnumerator()

Mengembalikan iterator yang melakukan iterasi melalui StateManagedCollection koleksi.

(Diperoleh dari StateManagedCollection)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetKnownTypes()

Mendapatkan array jenis Parameter yang dapat dimuat koleksi ParameterCollection .
GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
GetValues(HttpContext, Control)

Mendapatkan kumpulan Parameter nama objek yang diurutkan dan nilai terkait yang saat ini dimuat oleh koleksi.
IndexOf(Parameter)

Menentukan indeks objek tertentu Parameter dalam ParameterCollection koleksi.
Insert(Int32, Parameter)

Menyisipkan objek yang ditentukan Parameter ke ParameterCollection dalam koleksi pada indeks yang ditentukan.
MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
OnClear()

Saat ditimpa di kelas turunan, melakukan pekerjaan tambahan sebelum Clear() metode menghapus semua item dari koleksi.

(Diperoleh dari StateManagedCollection)
OnClearComplete()

Melakukan proses kustom tambahan setelah menghapus konten koleksi.
OnInsert(Int32, Object)

Terjadi sebelum metode dipanggil Insert(Int32, Parameter) .
OnInsertComplete(Int32, Object)

Terjadi setelah Insert(Int32, Parameter) metode selesai.
OnParametersChanged(EventArgs)

Memunculkan kejadian ParametersChanged.
OnRemove(Int32, Object)

Saat ditimpa di kelas turunan, melakukan pekerjaan tambahan sebelum IList.Remove(Object) metode atau IList.RemoveAt(Int32) menghapus item yang ditentukan dari koleksi.

(Diperoleh dari StateManagedCollection)
OnRemoveComplete(Int32, Object)

Terjadi setelah Remove(Parameter) metode selesai.
OnValidate(Object)

Melakukan proses kustom tambahan saat memvalidasi nilai.
Remove(Parameter)

Menghapus objek yang ditentukan Parameter dari ParameterCollection koleksi.
RemoveAt(Int32)

Parameter Menghapus objek pada indeks yang ditentukan dari ParameterCollection koleksi.
SetDirty()

Memaksa seluruh StateManagedCollection koleksi untuk diserialisasikan ke dalam status tampilan.

(Diperoleh dari StateManagedCollection)
SetDirtyObject(Object)

Menandai objek yang ditentukan Parameter sebagai telah berubah sejak pemuatan terakhir atau menyimpan dari status tampilan.
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)
UpdateValues(HttpContext, Control)

Melakukan iterasi melalui Parameter objek yang dimuat oleh koleksi, dan memanggil Evaluate metode pada masing-masing objek.

Acara

ParametersChanged

Terjadi ketika satu atau beberapa Parameter objek yang dimuat oleh kumpulan berubah status.

Implementasi Antarmuka Eksplisit

ICollection.Count

Mendapatkan jumlah elemen yang terkandung dalam StateManagedCollection koleksi.

(Diperoleh dari StateManagedCollection)
ICollection.IsSynchronized

Mendapatkan nilai yang menunjukkan apakah koleksi disinkronkan StateManagedCollection (utas aman). Metode ini mengembalikan false dalam semua kasus.

(Diperoleh dari StateManagedCollection)
ICollection.SyncRoot

Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke StateManagedCollection koleksi. Metode ini mengembalikan null dalam semua kasus.

(Diperoleh dari StateManagedCollection)
IEnumerable.GetEnumerator()

Mengembalikan iterator yang melakukan iterasi melalui StateManagedCollection koleksi.

(Diperoleh dari StateManagedCollection)
IList.Add(Object)

Menambahkan item ke StateManagedCollection koleksi.

(Diperoleh dari StateManagedCollection)
IList.Clear()

Menghapus semua item dari StateManagedCollection koleksi.

(Diperoleh dari StateManagedCollection)
IList.Contains(Object)

Menentukan apakah StateManagedCollection koleksi berisi nilai tertentu.

(Diperoleh dari StateManagedCollection)
IList.IndexOf(Object)

Menentukan indeks item tertentu dalam StateManagedCollection koleksi.

(Diperoleh dari StateManagedCollection)
IList.Insert(Int32, Object)

Menyisipkan item ke StateManagedCollection dalam koleksi pada indeks yang ditentukan.

(Diperoleh dari StateManagedCollection)
IList.IsFixedSize

Mendapatkan nilai yang menunjukkan apakah StateManagedCollection koleksi memiliki ukuran tetap. Metode ini mengembalikan false dalam semua kasus.

(Diperoleh dari StateManagedCollection)
IList.IsReadOnly

Mendapatkan nilai yang menunjukkan apakah StateManagedCollection koleksi bersifat baca-saja.

(Diperoleh dari StateManagedCollection)
IList.Item[Int32]

IStateManager Mendapatkan elemen pada indeks yang ditentukan.

(Diperoleh dari StateManagedCollection)
IList.Remove(Object)

Menghapus kemunculan pertama objek yang ditentukan dari StateManagedCollection koleksi.

(Diperoleh dari StateManagedCollection)
IList.RemoveAt(Int32)

IStateManager Menghapus elemen pada indeks yang ditentukan.

(Diperoleh dari StateManagedCollection)
IStateManager.IsTrackingViewState

Mendapatkan nilai yang menunjukkan apakah StateManagedCollection koleksi menyimpan perubahan pada status tampilannya.

(Diperoleh dari StateManagedCollection)
IStateManager.LoadViewState(Object)

Memulihkan status tampilan koleksi yang StateManagedCollection disimpan sebelumnya dan item yang IStateManager dikandungnya.

(Diperoleh dari StateManagedCollection)
IStateManager.SaveViewState()

Menyimpan perubahan pada StateManagedCollection koleksi dan setiap IStateManager objek yang dikandungnya sejak halaman diposting kembali ke server.

(Diperoleh dari StateManagedCollection)
IStateManager.TrackViewState()

StateManagedCollection Menyebabkan koleksi dan setiap objek yang dikandungnya IStateManager untuk melacak perubahan pada status tampilannya sehingga dapat dipertahankan di seluruh permintaan untuk halaman yang sama.

(Diperoleh dari StateManagedCollection)

Metode Ekstensi

Cast<TResult>(IEnumerable)

Mentransmisikan elemen dari ke IEnumerable jenis yang ditentukan.
OfType<TResult>(IEnumerable)

Memfilter elemen berdasarkan IEnumerable jenis yang ditentukan.
AsParallel(IEnumerable)

Mengaktifkan paralelisasi kueri.
AsQueryable(IEnumerable)

Mengonversi menjadi IEnumerableIQueryable.

Berlaku untuk

Lihat juga