HtmlForm.SubmitDisabledControls Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Obtient ou définit une valeur Boolean qui indique s'il faut forcer les contrôles désactivés côté client à envoyer leurs valeurs, permettant ainsi de conserver leurs valeurs après la publication de la page sur le serveur.

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

Valeur de propriété

Boolean

true si les contrôles désactivés sur le client sont forcés à envoyer leurs valeurs ; sinon, false. La valeur par défaut est false.

Exemples

L’exemple de code suivant montre comment définir la SubmitDisabledControls propriété d’un formulaire sur pour true provoquer la désactivation des contrôles par le script client afin de conserver leurs valeurs une fois que la page est retournée sur le serveur. Dans cet exemple, si vous définissez la SubmitDisabledControls propriété sur false , puis cliquez sur le bouton Publier , le texte de la zone de texte HTML est perdu et la case à cocher HTML n’est plus activée.

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

Remarques

Utilisez la SubmitDisabledControls propriété pour spécifier s’il faut forcer les contrôles désactivés sur le client à envoyer leurs valeurs lorsque la page publie en arrière. Cela permet aux contrôles désactivés de conserver leurs valeurs après la publication de la page sur le serveur. Lorsque la propriété a la SubmitDisabledControls valeur false, les contrôles du formulaire qui ont été désactivés à l’aide du script client ne seront pas soumis au serveur lors de la prochaine publication de la page. Par conséquent, toutes les valeurs stockées par les contrôles désactivés sont perdues. Pour permettre aux contrôles désactivés de conserver leurs valeurs après la publication de la page sur le serveur, définissez la SubmitDisabledControls propriété sur true.

S’applique à