HtmlForm.SubmitDisabledControls Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.HtmlControls
Ensamblado:
System.Web.dll

Obtiene o establece un valor booleano que indica si se debe forzar el envío de los valores de los controles deshabilitados en el cliente, permitiéndoles conservar sus valores una vez que la página devuelve los datos al servidor.

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

Valor de propiedad

Boolean

Es true si se fuerza el envío de los valores de los controles deshabilitados en el cliente; en caso contrario, es false. El valor predeterminado es false.

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer la SubmitDisabledControls propiedad en un formulario para true que los controles se deshabiliten por script de cliente para mantener sus valores después de que la página vuelva a escribir en el servidor. En este ejemplo, si establece la SubmitDisabledControls propiedad en y, a false continuación, hace clic en el botón Publicar atrás , el texto del cuadro de texto HTML se pierde y la casilla HTML ya no está seleccionada.

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

Comentarios

Utilice la SubmitDisabledControls propiedad para especificar si se deben forzar los controles deshabilitados en el cliente para enviar sus valores cuando la página vuelve a enviarlos. Esto permite que los controles deshabilitados conserven sus valores después de que la página vuelva a escribir en el servidor. Cuando la SubmitDisabledControls propiedad se establece falseen , los controles del formulario que se han deshabilitado mediante el script de cliente no se enviarán al servidor la próxima vez que vuelva a enviar la página. Como resultado, se pierden los valores almacenados por los controles deshabilitados. Para permitir que los controles deshabilitados conserven sus valores después de que la página vuelva a escribir en el servidor, establezca la SubmitDisabledControls propiedad trueen .

Se aplica a