Bagikan melalui


FormParameter Kelas

Definisi

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
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

Lihat juga