Control.IsLiteralContent 方法

定义

确定服务器控件是否只包含文字内容。Determines if the server control holds only literal content.

protected:
 bool IsLiteralContent();
protected bool IsLiteralContent ();
member this.IsLiteralContent : unit -> bool
Protected Function IsLiteralContent () As Boolean

返回

如果服务器控件只包含文本内容,则为 true;否则为 falsetrue if the server control contains solely literal content; otherwise false.

示例

下面的示例检查包含服务器控件的页是否已回发。The following example checks whether the page that contains the server controls has posted back. 如果有,它将调用 IsLiteralContent 方法来确定控件是只包含文本内容,还是包含其他服务器控件的父控件。If it has, it calls the IsLiteralContent method to determine whether the control contains just literal content, or is a parent control to other server controls. 如果它仅包含文本内容,则表示该内容的 LiteralControlUniqueID 属性将写入响应中。If it contains solely literal content, the UniqueID property of the LiteralControl that represents that content is written to the response.

// 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.");
                }
        }
}
' 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

注解

此方法返回 true时,服务器控件的集合将包含单个文本控件。When this method returns true, the server control's collection holds a single literal control.

适用于

另请参阅