FormParameter Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.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.

Mengikat nilai bidang permintaan Form HTTP ke objek parameter.

public ref class FormParameter : System::Web::UI::WebControls::Parameter

public class FormParameter : System.Web.UI.WebControls.Parameter

type FormParameter = class
    inherit Parameter

Public Class FormParameter
Inherits Parameter

Warisan: Object

Parameter
FormParameter

Contoh

Contoh kode berikut menunjukkan cara menyisipkan data ke dalam database menggunakan SqlDataSource kontrol dan halaman web ASP.NET sederhana. Data saat ini dalam tabel data ditampilkan dalam DropDownList kontrol. Anda bisa menambahkan rekaman baru dengan memasukkan nilai dalam TextBox kontrol dan mengklik tombol. Saat tombol diklik, nilai yang ditentukan disisipkan ke dalam database, dan disegarkan DropDownList .

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">
private void InsertShipper (object source, EventArgs e) {
  SqlDataSource1.Insert();
}
</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:dropdownlist
        id="DropDownList1"
        runat="server"
        datasourceid="SqlDataSource1"
        datatextfield="CompanyName"
        datavaluefield="ShipperID" />

<!-- Security Note: The SqlDataSource uses a FormParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the FormParameter, handle the Inserting event. -->

      <asp:sqldatasource
        id="SqlDataSource1"
        runat="server"
        connectionstring="<%$ ConnectionStrings:MyNorthwind %>"
        selectcommand="SELECT CompanyName,ShipperID FROM Shippers"
        insertcommand="INSERT INTO Shippers (CompanyName,Phone) VALUES (@CoName,@Phone)">
          <insertparameters>
            <asp:formparameter name="CoName" formfield="CompanyNameBox" />
            <asp:formparameter name="Phone"  formfield="PhoneBox" />
          </insertparameters>
      </asp:sqldatasource>

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

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator1"
        runat="server"
        ControlToValidate="CompanyNameBox"
        Display="Static"
        ErrorMessage="Please enter a company name." />

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

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator2"
        runat="server"
        ControlToValidate="PhoneBox"
        Display="Static"
        ErrorMessage="Please enter a phone number." />

      <br /><asp:button
           id="Button1"
           runat="server"
           text="Insert New Shipper"
           onclick="InsertShipper" />

    </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 InsertShipper (ByVal Source As Object, ByVal e As EventArgs)
  SqlDataSource1.Insert()
End Sub ' InsertShipper
</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:dropdownlist
        id="DropDownList1"
        runat="server"
        datasourceid="SqlDataSource1"
        datatextfield="CompanyName"
        datavaluefield="ShipperID" />

<!-- Security Note: The SqlDataSource uses a FormParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the FormParameter, handle the Inserting event. -->

      <asp:sqldatasource
        id="SqlDataSource1"
        runat="server"
        connectionstring="<%$ ConnectionStrings:MyNorthwind %>"
        selectcommand="SELECT CompanyName,ShipperID FROM Shippers"
        insertcommand="INSERT INTO Shippers (CompanyName,Phone) VALUES (@CoName,@Phone)">
          <insertparameters>
            <asp:formparameter name="CoName" formfield="CompanyNameBox" />
            <asp:formparameter name="Phone"  formfield="PhoneBox" />
          </insertparameters>
      </asp:sqldatasource>

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

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator1"
        runat="server"
        ControlToValidate="CompanyNameBox"
        Display="Static"
        ErrorMessage="Please enter a company name." />

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

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator2"
        runat="server"
        ControlToValidate="PhoneBox"
        Display="Static"
        ErrorMessage="Please enter a phone number." />

      <br /><asp:button
           id="Button1"
           runat="server"
           text="Insert New Shipper"
           onclick="InsertShipper" />

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

Keterangan

Anda dapat menggunakan FormParameter kelas untuk mengikat nilai variabel formulir dalam Form koleksi ke parameter yang digunakan dalam kueri atau perintah berparameter. Kontrol yang mengikat data ke parameter mungkin melemparkan pengecualian jika FormParameter ditentukan tetapi tidak ada variabel formulir yang sesuai yang diteruskan. Mereka mungkin juga tidak menampilkan data jika variabel formulir diteruskan tanpa nilai yang sesuai. Atur DefaultValue untuk menghindari situasi ini jika sesuai.

Kelas FormParameter menyediakan FormField properti , yang mengidentifikasi nama variabel formulir yang akan diikat, selain yang diwarisi dari Parameter kelas .

Penting

FormParameter tidak memvalidasi nilai yang diteruskan oleh elemen formulir dengan cara apa pun; ia menggunakan nilai mentah. Dalam kebanyakan kasus, Anda dapat memvalidasi nilai FormParameter sebelum digunakan oleh kontrol sumber data dengan menangani peristiwa, seperti Selecting, , UpdatingInserting, atau Deleting peristiwa yang diekspos oleh kontrol sumber data yang Anda gunakan. Jika nilai parameter tidak lulus tes validasi, Anda dapat membatalkan operasi data dengan mengatur Cancel properti kelas terkait CancelEventArgs ke true.

Konstruktor

FormParameter()	Menginisialisasi instans kelas baru yang tidak disebutkan FormParameter namanya.
FormParameter(FormParameter)	Menginisialisasi instans FormParameter baru kelas dengan nilai instans yang ditentukan oleh `original` parameter .
FormParameter(String, DbType, String)	Menginisialisasi instans FormParameter baru kelas, menggunakan string yang ditentukan untuk mengidentifikasi bidang variabel formulir mana yang akan diikat.
FormParameter(String, String)	Menginisialisasi instans baru bernama kelas FormParameter , menggunakan string yang ditentukan untuk mengidentifikasi bidang variabel formulir mana yang akan diikat.
FormParameter(String, TypeCode, String)	Menginisialisasi instans FormParameter kelas bernama baru yang dinamai dan ditik dengan kuat, menggunakan string yang ditentukan untuk mengidentifikasi variabel formulir mana yang akan diikat.

Properti

ConvertEmptyStringToNull	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai yang Parameter terikat objek harus dikonversi ke `null` jika itu adalah Empty. (Diperoleh dari Parameter)
DbType	Mendapatkan atau mengatur jenis database parameter. (Diperoleh dari Parameter)
DefaultValue	Menentukan nilai default untuk parameter , jika nilai parameter terikat untuk tidak diinisialisasi saat metode dipanggil Evaluate(HttpContext, Control) . (Diperoleh dari Parameter)
Direction	Menunjukkan apakah Parameter objek digunakan untuk mengikat nilai ke kontrol, atau kontrol dapat digunakan untuk mengubah nilai. (Diperoleh dari Parameter)
FormField	Mendapatkan atau mengatur nama variabel formulir yang mengikat parameter.
IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah Parameter objek menyimpan perubahan pada status tampilannya. (Diperoleh dari Parameter)
Name	Mendapatkan atau mengatur nama parameter. (Diperoleh dari Parameter)
Size	Mendapatkan atau mengatur ukuran parameter. (Diperoleh dari Parameter)
Type	Mendapatkan atau mengatur jenis parameter. (Diperoleh dari Parameter)
ValidateInput	Mendapatkan atau menetapkan nilai yang menunjukkan apakah input klien dalam parameter divalidasi.
ViewState	Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status Parameter tampilan objek di beberapa permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Metode

Clone()	Mengembalikan duplikat instans saat ini FormParameter .
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Evaluate(HttpContext, Control)	Memperbarui dan mengembalikan nilai FormParameter objek.
GetDatabaseType()	Mendapatkan nilai yang setara dengan jenis CLR instans DbType saat ini Parameter . (Diperoleh dari Parameter)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
LoadViewState(Object)	Memulihkan status tampilan yang disimpan sebelumnya dari tampilan sumber data. (Diperoleh dari Parameter)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
OnParameterChanged()	OnParametersChanged(EventArgs) Memanggil metode ParameterCollection koleksi yang berisi Parameter objek . (Diperoleh dari Parameter)
SaveViewState()	Menyimpan perubahan ke Parameter status tampilan objek sejak halaman diposting kembali ke server. (Diperoleh dari Parameter)
SetDirty()	Parameter Menandai objek sehingga statusnya akan direkam dalam status tampilan. (Diperoleh dari Parameter)
ToString()	Mengonversi nilai instans ini ke representasi string yang setara. (Diperoleh dari Parameter)
TrackViewState()	Parameter Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di objek kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Implementasi Antarmuka Eksplisit

ICloneable.Clone()	Mengembalikan duplikat instans saat ini Parameter . (Diperoleh dari Parameter)
IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah Parameter objek menyimpan perubahan pada status tampilannya. (Diperoleh dari Parameter)
IStateManager.LoadViewState(Object)	Memulihkan status tampilan yang disimpan sebelumnya dari tampilan sumber data. (Diperoleh dari Parameter)
IStateManager.SaveViewState()	Menyimpan perubahan ke Parameter status tampilan objek sejak halaman diposting kembali ke server. (Diperoleh dari Parameter)
IStateManager.TrackViewState()	Parameter Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di objek kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Berlaku untuk

Bagikan melalui

FormParameter Kelas

Definisi

Contoh

Keterangan

Konstruktor

Properti

Metode

Implementasi Antarmuka Eksplisit

Berlaku untuk

Lihat juga

Sumber Daya Tambahan: