HtmlForm.SubmitDisabledControls プロパティ

.NET Framework クラス ライブラリ リファレンス

HtmlForm.SubmitDisabledControls プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

クライアント側で無効なコントロールにその値を強制的に送信させるかどうかを示すブール値を取得または設定します。これにより、ページがサーバーにポストバックされた後にコントロールがその値を保持できます。

名前空間: System.Web.UI.HtmlControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 SubmitDisabledControls As Boolean

Visual Basic (使用法)

Dim instance As HtmlForm
Dim value As Boolean

value = instance.SubmitDisabledControls

instance.SubmitDisabledControls = value

C#

public virtual bool SubmitDisabledControls
 { get; set; }

C++

public:
virtual property bool SubmitDisabledControls {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_SubmitDisabledControls ()

/** @property */
public void set_SubmitDisabledControls (boolean
 value)

JScript

public function get SubmitDisabledControls
 () : boolean

public function set SubmitDisabledControls
 (value : boolean)

プロパティ値
クライアント側で無効になっているコントロールにその値を強制的に送信させる場合は true。それ以外の場合は false。既定値は false です。

解説

SubmitDisabledControls プロパティを使用して、ページがポストバックされたときに、クライアント側で無効になっているコントロールにその値を強制的に送信させるかどうかを指定します。これにより、ページがサーバーにポストバックされた後、無効になっているコントロールがその値を保持できるようになります。SubmitDisabledControls プロパティを false に設定すると、次にページがポストバックされるときに、クライアント スクリプトを使用して無効にしたフォーム上のコントロールがサーバーに送信されなくなります。結果として、無効なコントロールに格納されたすべての値が失われます。ページがサーバーにポストバックされた後、無効になっているコントロールがその値を保持できるようにするには、SubmitDisabledControls プロパティを true に設定します。

使用例

フォーム上の SubmitDisabledControls プロパティを true に設定して、ページがサーバーにポストバックされた後に、クライアント スクリプトによって無効になったコントロールがその値を保持できるようにする方法を次のコード例に示します。この例では、SubmitDisabledControls プロパティを false に設定して、[Post back] ボタンをクリックした場合に、HTML テキスト ボックス内のテキストが失われ、HTML チェック ボックスがオフになります。

Visual Basic

<%@ page language="VB"%>

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

<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 Language="javascript">

    // Disable the HTML controls on the form.
    document.all('InputText1').disabled = true;
    document.all('InputCheckBox1').disabled = true;

</script>

C#

<%@ page language="C#"%>

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

<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 Language="javascript">

    // Disable the HTML controls on the form.
    document.all('InputText1').disabled = true;
    document.all('InputCheckBox1').disabled = true;

</script>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HtmlForm クラス
HtmlForm メンバ
System.Web.UI.HtmlControls 名前空間
その他の技術情報
HTML サーバー コントロール