HtmlForm.SubmitDisabledControls Properti
Definisi
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.
Mendapatkan atau menetapkan nilai Boolean yang menunjukkan apakah akan memaksa kontrol yang dinonaktifkan pada klien untuk mengirimkan nilainya, memungkinkan mereka mempertahankan nilainya setelah halaman memposting kembali ke server.
public:
virtual property bool SubmitDisabledControls { bool get(); void set(bool value); };
public virtual bool SubmitDisabledControls { get; set; }
member this.SubmitDisabledControls : bool with get, set
Public Overridable Property SubmitDisabledControls As Boolean
Nilai Properti
true jika kontrol yang dinonaktifkan pada klien dipaksa untuk mengirimkan nilainya; jika tidak, false. Nilai defaultnya adalah false.
Contoh
Contoh kode berikut menunjukkan cara mengatur SubmitDisabledControls properti pada formulir untuk true menyebabkan kontrol dinonaktifkan oleh skrip klien untuk mempertahankan nilainya setelah halaman memposting kembali ke server. Dalam contoh ini, jika Anda mengatur SubmitDisabledControls properti ke false lalu klik tombol Kirim kembali , teks dalam kotak teks HTML hilang dan kotak centang HTML tidak lagi dipilih.
<%@ 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)
{
// The first time the page loads, set the values
// of the HtmlInputText and HtmlInputCheckBox controls.
if (!IsPostBack)
{
InputText1.Value = "Test";
InputCheckBox1.Checked = true;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1"
runat="server">
<title>HtmlForm SubmitDisabledControls Property Example</title>
</head>
<body>
<form id="form1"
submitdisabledcontrols="true"
runat="server">
<h3>HtmlForm SubmitDisabledControls Property Example</h3>
<input id="InputText1"
name="InputText1"
type="text"
runat="server" />
<input id="InputCheckBox1"
name="InputCheckBox1"
type="Checkbox"
runat="server" />
<asp:button id="PostBackButton"
text="Post back"
runat="server" />
</form>
</body>
</html>
<script type="text/javascript">
// Disable the HTML controls on the form.
document.all('InputText1').disabled = true;
document.all('InputCheckBox1').disabled = true;
</script>
<%@ 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">
Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
' The first time the page loads, set the values
' of the HtmlInputText and HtmlInputCheckBox controls.
If Not IsPostBack Then
InputText1.Value = "Test"
InputCheckBox1.Checked = True
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1"
runat="server">
<title>HtmlForm SubmitDisabledControls Property Example</title>
</head>
<body>
<form id="form1"
submitdisabledcontrols="true"
runat="server">
<h3>HtmlForm SubmitDisabledControls Property Example</h3>
<input id="InputText1"
name="InputText1"
type="text"
runat="server" />
<input id="InputCheckBox1"
name="InputCheckBox1"
type="Checkbox"
runat="server" />
<asp:button id="PostBackButton"
text="Post back"
runat="server" />
</form>
</body>
</html>
<script type="text/javascript">
// Disable the HTML controls on the form.
document.all('InputText1').disabled = true;
document.all('InputCheckBox1').disabled = true;
</script>
Keterangan
SubmitDisabledControls Gunakan properti untuk menentukan apakah akan memaksa kontrol yang dinonaktifkan pada klien untuk mengirimkan nilainya saat halaman memposting kembali. Ini memungkinkan kontrol yang dinonaktifkan untuk mempertahankan nilainya setelah halaman memposting kembali ke server.
SubmitDisabledControls Ketika properti diatur ke false, kontrol pada formulir yang telah dinonaktifkan menggunakan skrip klien tidak akan dikirimkan ke server saat berikutnya halaman memposting kembali. Akibatnya, nilai apa pun yang disimpan oleh kontrol yang dinonaktifkan hilang. Untuk mengizinkan kontrol yang dinonaktifkan mempertahankan nilainya setelah halaman memposting kembali ke server, atur properti ke SubmitDisabledControlstrue.