Control.IsLiteralContent メソッド

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

Protected Function IsLiteralContent() As Boolean
[C#]
protected bool IsLiteralContent();
[C++]
protected: bool IsLiteralContent();
[JScript]
protected function IsLiteralContent() : Boolean;

戻り値

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

解説

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

使用例

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

 
' 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#, C++, JScript] C#、C++、および JScript のサンプルはありません。Visual Basic のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

参照

Control クラス | Control メンバ | System.Web.UI 名前空間 | HasControls | LiteralControl