HtmlForm.SubmitDisabledControls Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen booleschen Wert ab, der angibt, ob auf dem Client deaktivierte Steuerelemente ihre Werte übermitteln müssen, oder legt diese fest. Damit können diese Steuerelemente ihren Wert nach dem Zurücksenden der Seite an den Server beibehalten.

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

Boolean

true, wenn auf dem Client deaktivierte Steuerelemente ihre Werte übermitteln müssen, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die SubmitDisabledControls -Eigenschaft in einem Formular auf true festgelegt wird, damit die vom Clientskript deaktivierten Steuerelemente ihre Werte beibehalten, nachdem die Seite zurück an den Server sendet. Wenn Sie in diesem Beispiel die SubmitDisabledControls Eigenschaft auf false festlegen und dann auf die Schaltfläche Zurück posten klicken, geht der Text im HTML-Textfeld verloren, und das Kontrollkästchen HTML 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 auf dem Client deaktivierte Steuerelemente erzwungen werden sollen, um ihre Werte zu übermitteln, wenn die Seite zurückgibt. Dadurch können die deaktivierten Steuerelemente ihre Werte beibehalten, nachdem die Seite an den Server zurückgibt. Wenn die SubmitDisabledControls -Eigenschaft auf falsefestgelegt ist, werden Steuerelemente auf dem Formular, die mithilfe des Clientskripts deaktiviert wurden, beim nächsten Posten der Seite nicht an den Server übermittelt. Dadurch gehen alle von den deaktivierten Steuerelementen gespeicherten Werte verloren. Damit die deaktivierten Steuerelemente ihre Werte beibehalten können, nachdem die Seite an den Server zurückgibt, legen Sie die SubmitDisabledControls -Eigenschaft auf fest true.

Gilt für:

Freigeben über