DataBoundLiteralControl.Text Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene il contenuto di testo dell'oggetto DataBoundLiteralControl.
public:
property System::String ^ Text { System::String ^ get(); };
public string Text { get; }
member this.Text : string
Public ReadOnly Property Text As String
Valore della proprietà
Oggetto String che rappresenta il contenuto di testo dell'oggetto DataBoundLiteralControl.
Esempio
Nell'esempio di codice seguente viene creato un controllo personalizzato e viene usato tale controllo dall'interno di un file aspx per visualizzare il testo di un DataBoundLiteralControl oggetto. Il controllo personalizzato ottiene un DataBoundLiteralControl oggetto e restituisce la proprietà text nel Render
relativo metodo.
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
È possibile compilare il controllo con il compilatore Visual Basic (vbc.exe) o il compilatore C# (csc.exe). È necessario inserire il file di .dll risultante nella directory Bin del progetto Web, come illustrato nell'esempio di codice seguente.
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
Nell'esempio di codice seguente viene illustrato come il controllo personalizzato viene registrato e usato all'interno di un file 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>
Commenti
La DataBoundLiteralControl classe mantiene il valore della relativa Text proprietà per visualizzare lo stato.