HtmlForm.SubmitDisabledControls Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.HtmlControls
Сборка:
System.Web.dll

Возвращает или задает логическое значение, показывающее, инициируется ли принудительно отправка значений элементов управления, отключенных на клиенте, которая позволяет им сохранить свои значения после передачи страницы обратно на сервер.

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

Значение свойства

Boolean

Значение true, если элементы управления, отключенные на клиенте, принуждаются к отправке своих значений; в противном случае — значение false. Значение по умолчанию — false.

Примеры

В следующем примере кода показано, как задать SubmitDisabledControls свойство формы, чтобы true элементы управления, отключенные клиентским скриптом, сохраняли свои значения после публикации страницы на сервере. В этом примере если задать SubmitDisabledControls для свойства false значение и нажать кнопку "Назад ", текст в текстовом поле HTML теряется, а флажок HTML больше не установлен.

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

Комментарии

SubmitDisabledControls Используйте свойство, чтобы указать, следует ли принудительно включить элементы управления, отключенные на клиенте, для отправки их значений при обратной публикации страницы. Это позволяет отключенным элементам управления сохранять свои значения после публикации страницы обратно на сервер. SubmitDisabledControls Если для свойства задано значениеfalse, элементы управления в форме, отключенной с помощью клиентского скрипта, не будут отправляться на сервер при следующей публикации страницы. В результате все значения, хранящиеся отключенными элементами управления, теряются. Чтобы разрешить отключенным элементам управления сохранять свои значения после публикации страницы на сервере, задайте SubmitDisabledControls для свойства значение true.

Применяется к