DataBoundLiteralControl.Text DataBoundLiteralControl.Text DataBoundLiteralControl.Text DataBoundLiteralControl.Text Property

Definizione

Ottiene il contenuto di testo dell'oggetto DataBoundLiteralControl.Gets the text content of the DataBoundLiteralControl object.

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.A String that represents the text content of the DataBoundLiteralControl.

Esempi

Nell'esempio di codice seguente viene creato un controllo personalizzato che viene utilizzato dall'interno di un file aspx per visualizzare il testo di DataBoundLiteralControl un oggetto.The following code example creates a custom control and uses that control from within an .aspx file to display the text of a DataBoundLiteralControl object. Il controllo personalizzato ottiene un DataBoundLiteralControl oggetto e restituisce la proprietà Text nel relativo Render metodo.The custom control obtains a DataBoundLiteralControl object and outputs the text property in its Render method.


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
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 'Render  

   End Class 'MyControl
End Namespace 'MyUserControl

È possibile compilare il controllo con il compilatore Visual Basic (vbc. exe) o C# il compilatore (CSC. exe).You can compile the control with the Visual Basic Compiler (vbc.exe) or C# Compiler (csc.exe). È necessario inserire il file con estensione dll risultante nella directory bin del progetto Web, come illustrato nell'esempio di codice seguente.You must place the resulting .dll file in the Bin directory of the Web project, as shown in the following code example.

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 il modo in cui il controllo personalizzato viene registrato e utilizzato all'interno di un file aspx.The following code example demonstrates how the custom control is registered and used within an .aspx file.

<%@ 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 Salva in modo permanente il valore Text della proprietà per visualizzare lo stato.The DataBoundLiteralControl class persists the value of its Text property to view state.

Si applica a