Freigeben über


HtmlForm.SubmitDisabledControls Eigenschaft

Definition

Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob Steuerelemente auf dem Client deaktiviert werden, um ihre Werte zu übermitteln, sodass sie ihre Werte beibehalten können, nachdem die Seite wieder auf dem Server veröffentlicht wurde.

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

Eigenschaftswert

truewenn Steuerelemente, die auf dem Client deaktiviert sind, gezwungen sind, ihre Werte zu übermitteln; andernfalls . false Der Standardwert ist false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die SubmitDisabledControls Eigenschaft eines Formulars true so festgelegt wird, dass Steuerelemente, die vom Clientskript deaktiviert wurden, ihre Werte beibehalten, nachdem die Seite wieder auf dem Server veröffentlicht wurde. Wenn Sie in diesem Beispiel die SubmitDisabledControls Eigenschaft auf false die Schaltfläche "Zurück posten" festlegen und dann auf die Schaltfläche " Zurück posten " klicken, geht der Text im HTML-Textfeld verloren, und das HTML-Kontrollkästchen ist nicht mehr aktiviert.

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

Hinweise

Verwenden Sie die SubmitDisabledControls Eigenschaft, um anzugeben, ob Steuerelemente auf dem Client deaktiviert werden sollen, um deren Werte zu übermitteln, wenn die Seite zurückgibt. Auf diese Weise können die deaktivierten Steuerelemente ihre Werte beibehalten, nachdem die Seite wieder auf dem Server veröffentlicht wurde. Wenn die Eigenschaft auf <a0/> festgelegt ist, werden Steuerelemente auf dem Formular, das mithilfe des Clientskripts deaktiviert wurde, beim nächsten Zurücksetzen der Seite nicht an den Server übermittelt. Daher gehen alle von den deaktivierten Steuerelementen gespeicherten Werte verloren. Um den deaktivierten Steuerelementen die Beibehaltung ihrer Werte nach dem Zurückstellen der Seite auf den Server zu ermöglichen, legen Sie die SubmitDisabledControls Eigenschaft auf true.

Gilt für: