HtmlForm.SubmitDisabledControls Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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 false
en , 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 true
en .