Control.IsLiteralContent メソッド

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

Control.IsLiteralContent メソッド

このメソッドは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

サーバー コントロールがリテラルな内容だけを保持しているかどうかを決定します。

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

Visual Basic (宣言)

Protected Function IsLiteralContent As
 Boolean

Visual Basic (使用法)

Dim returnValue As Boolean

returnValue = Me.IsLiteralContent

C#

protected bool IsLiteralContent ()

C++

protected:
bool IsLiteralContent ()

J#

protected boolean IsLiteralContent ()

JScript

protected function IsLiteralContent () : boolean

戻り値
サーバー コントロールがリテラルな内容だけを含む場合は true。それ以外の場合は false。

解説

このメソッドから true が返されると、サーバー コントロールのコレクションは単一のリテラル コントロールを保持します。

使用例

サーバー コントロールを含むページがポストバックされたかどうかをチェックするコード例を次に示します。ポストバックされている場合、このコードは IsLiteralContent メソッドを呼び出して、コントロールがリテラル コンテンツだけを含んでいるか、それとも他のサーバー コントロールの親コントロールになっているかをチェックします。リテラル コンテンツだけを含んでいる場合は、そのコンテンツを表す LiteralControl の UniqueID プロパティが応答に書き込まれます。

Visual Basic

' Override the OnLoad method to check if the 
' page that uses this control has posted back.
' If so, check whether this controls contains
' only literal content, and if it does,
' it gets the UniqueID property and writes it
' to the page. Otherwise, it writes a message
' that the control contains more than literal content.
Overrides Protected Sub
 OnLoad(ByVal e As EventArgs)

   If Page.IsPostBack = True Then
      Dim s As String

      If Me.IsLiteralContent() = True
 Then
         s = Controls(0).UniqueID
         Context.Response.Write(s)
      Else
         Context.Response.Write( _
         "The control contains more than literal content.")
      End If
   End If
End Sub

C#

// Override the OnLoad method to check if the 
// page that uses this control has posted back.
// If so, check whether this controls contains
// only literal content, and if it does,
// it gets the UniqueID property and writes it
// to the page. Otherwise, it writes a message
// that the control contains more than literal content.
protected override void OnLoad(EventArgs e)
{
        if (Page.IsPostBack)
        {
                String s;

                if (this.IsLiteralContent())
                {
                        s = Controls[0].UniqueID;
                        Context.Response.Write(s);
                }
                else
                {
                        Context.Response.Write(
                                "The control contains more than literal content.");
                }
        }
}

プラットフォーム

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、1.1、1.0

参照

関連項目
Control クラス
Control メンバ
System.Web.UI 名前空間
HasControls
LiteralControl