DataBoundLiteralControl.Text Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает текстовое содержимое объекта DataBoundLiteralControl.
public:
property System::String ^ Text { System::String ^ get(); };
public string Text { get; }
member this.Text : string
Public ReadOnly Property Text As String
Значение свойства
String, представляющий текстовое содержимое DataBoundLiteralControl.
Примеры
В следующем примере кода создается пользовательский элемент управления и он используется из ASPX-файла для отображения текста DataBoundLiteralControl объекта . Пользовательский элемент управления получает DataBoundLiteralControl объект и выводит свойство text в методе Render
.
using System;
using System.Web;
using System.Web.UI;
namespace Samples.AspNet.CS.Controls
{
public class MyControl : Control
{
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void Render(HtmlTextWriter output)
{
// Checks if a DataBoundLiteralControl object is present.
if ( (HasControls()) && (Controls[0] is DataBoundLiteralControl) )
{
// Obtains the DataBoundLiteralControl instance.
DataBoundLiteralControl boundLiteralControl = (DataBoundLiteralControl)Controls[0];
// Retrieves the text in the boundLiteralControl object.
String text = boundLiteralControl.Text;
output.Write("<h4>Your Message: " +text+"</h4>");
}
}
}
}
Imports System.Web
Imports System.Web.UI
Namespace Samples.AspNet.VB.Controls
Public Class MyControlVB
Inherits Control
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub Render(Output As HtmlTextWriter)
' Checks if a DataBoundLiteralControl object is present.
If HasControls() And TypeOf Controls(0) Is DataBoundLiteralControl Then
' Obtains the DataBoundLiteralControl instance.
Dim boundLiteralControl As DataBoundLiteralControl = CType(Controls(0), DataBoundLiteralControl)
' Retrieves the text in the boundLiteralControl object.
Dim text As String = boundLiteralControl.Text
output.Write(("<h4>Your Message: " + text + "</h4>"))
End If
End Sub
End Class
End Namespace 'MyUserControl
Элемент управления можно скомпилировать с помощью компилятора Visual Basic (vbc.exe) или компилятора C# (csc.exe). Полученный файл .dll необходимо поместить в каталог Bin веб-проекта, как показано в следующем примере кода.
vbc /r:System.dll /r:System.Web.dll /t:library /out:myWebAppPath/bin/vb_myDataBoundLiteralControl.dll myDataBoundLiteralControl.vb
csc /t:library /out:myWebAppPath/bin/cs_myDataBoundLiteralControl.dll myDataBoundLiteralControl.cs
В следующем примере кода показано, как пользовательский элемент управления регистрируется и используется в ASPX-файле.
<%@ Page Language="C#" %>
<%@ Register TagPrefix="MyControlSample" Namespace="Samples.AspNet.CS.Controls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>
DataBoundLiteralControl Example
</title>
<script language="C#" runat="server">
void Page_Load(Object Sender, EventArgs e)
{
Page.DataBind();
}
</script>
</head>
<body>
<h3>
DataBoundLiteralControl Example
</h3>
<form method="post" runat="server" id="Form1">
<asp:Label id="Label1" Text="This is a string retrieved from 'DataBoundLiteralControl'" Runat="server" Visible="False"></asp:Label>
<MyControlSample:MyControl id="MyControl" runat="server">
<%# Label1.Text %>
</MyControlSample:MyControl>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Register TagPrefix="MyControlSample" Namespace="Samples.AspNet.VB.Controls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>
DataBoundLiteralControl Example
</title>
<script language="VB" runat="server">
Sub Page_Load(ByVal Sender As Object, ByVal e As EventArgs)
Page.DataBind()
End Sub
</script>
</head>
<body>
<h3>
DataBoundLiteralControl Example
</h3>
<form method="post" runat="server" id="Form1">
<asp:Label id="Label1" Text="This is a string retrieved from 'DataBoundLiteralControl'" Runat="server" Visible="False"></asp:Label>
<MyControlSample:MyControlVB id="MyControl" runat="server">
<%# Label1.Text %>
</MyControlSample:MyControlVB>
</form>
</body>
</html>
Комментарии
Класс DataBoundLiteralControl сохраняет значение своего Text свойства для просмотра состояния.