HtmlForm.SubmitDisabledControls Eigenschap

Definitie

Naamruimte:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Hiermee wordt een Booleaanse waarde opgehaald of ingesteld die aangeeft of besturingselementen die zijn uitgeschakeld op de client moeten afdwingen hun waarden te verzenden, zodat ze hun waarden kunnen behouden nadat de paginaposts weer naar de server zijn verzonden.

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

Waarde van eigenschap

Boolean

true als besturingselementen die op de client zijn uitgeschakeld, gedwongen zijn hun waarden in te dienen; anders, false. De standaardwaarde is false.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de SubmitDisabledControls eigenschap op een formulier instelt om true ervoor te zorgen dat besturingselementen die door het clientscript zijn uitgeschakeld, hun waarden behouden nadat de paginaposts weer naar de server zijn geplaatst. Als u in dit voorbeeld de SubmitDisabledControls eigenschap false instelt en vervolgens op de knop Terug posten klikt, gaat de tekst in het HTML-tekstvak verloren en is het HTML-selectievakje niet meer ingeschakeld.

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

Opmerkingen

Gebruik de SubmitDisabledControls eigenschap om op te geven of besturingselementen op de client moeten worden uitgeschakeld om hun waarden in te dienen wanneer de pagina wordt teruggezet. Hierdoor kunnen de uitgeschakelde besturingselementen hun waarden behouden nadat de paginaberichten weer naar de server zijn geplaatst. Wanneer de SubmitDisabledControls eigenschap is ingesteld falseop, worden besturingselementen op het formulier die zijn uitgeschakeld met behulp van clientscript, niet naar de server verzonden wanneer de pagina de volgende keer terugkomt. Als gevolg hiervan gaan alle waarden die zijn opgeslagen door de uitgeschakelde besturingselementen verloren. Als u wilt toestaan dat de uitgeschakelde besturingselementen hun waarden behouden nadat de paginaberichten weer naar de server zijn geplaatst, stelt u de SubmitDisabledControls eigenschap in op true.

Van toepassing op