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

定義

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

プロパティ値

String のテキストの内容を表す DataBoundLiteralControlA String that represents the text content of the DataBoundLiteralControl.

次のコード例では、カスタムコントロールを作成し、.aspx ファイル内からそのコントロールを使用して、 DataBoundLiteralControlオブジェクトのテキストを表示します。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. カスタムコントロールはオブジェクトをDataBoundLiteralControl取得し、そのRenderメソッドの text プロパティを出力します。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.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) を使用して、コントロールをコンパイルできます。You can compile the control with the Visual Basic Compiler (vbc.exe) or C# Compiler (csc.exe). 次のコード例に示すように、生成された .dll ファイルを Web プロジェクトの Bin ディレクトリに配置する必要があります。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  

次のコード例は、.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>

注釈

クラスDataBoundLiteralControlは、 Textプロパティの値を保持して状態を表示します。The DataBoundLiteralControl class persists the value of its Text property to view state.

適用対象