HtmlForm.SubmitDisabledControls Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.HtmlControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia wartość logiczną wskazującą, czy wymusić wyłączenie kontrolek na kliencie w celu przesłania ich wartości, co pozwala zachować ich wartości po opublikowaniu strony z powrotem na serwerze.

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

Wartość właściwości

Boolean

true jeśli kontrolki wyłączone na kliencie są zmuszane do przesyłania ich wartości; w przeciwnym razie , false. Wartość domyślna to false.

Przykłady

Poniższy przykład kodu pokazuje, jak ustawić SubmitDisabledControls właściwość w formularzu, aby true spowodować wyłączenie kontrolek przez skrypt klienta w celu zachowania ich wartości po wpisach strony z powrotem do serwera. W tym przykładzie jeśli ustawisz SubmitDisabledControls właściwość na false , a następnie kliknij przycisk Opublikuj wstecz , tekst w polu tekstowym HTML zostanie utracony, a pole wyboru HTML nie jest już zaznaczone.

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

Uwagi

SubmitDisabledControls Użyj właściwości , aby określić, czy wymusić wyłączenie kontrolek na kliencie w celu przesłania ich wartości po powrocie do strony. Dzięki temu wyłączone kontrolki zachowują swoje wartości po opublikowaniu strony z powrotem na serwerze. SubmitDisabledControls Gdy właściwość jest ustawiona na falsewartość , kontrolki w formularzu, które zostały wyłączone przy użyciu skryptu klienta, nie zostaną przesłane do serwera przy następnym wpisie strony. W związku z tym wszystkie wartości przechowywane przez wyłączone kontrolki zostaną utracone. Aby zezwolić wyłączonym kontrolkom na zachowanie ich wartości po opublikowaniu strony z powrotem na serwerze, ustaw SubmitDisabledControls właściwość na true.

Dotyczy

Udostępnij przez