MenuItemBinding.Text 속성

정의

MenuItemBinding 개체가 적용된 메뉴 항목에 표시될 텍스트를 가져오거나 설정합니다.Gets or sets the text displayed for the menu item to which the MenuItemBinding object is applied.

public:
 property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
public string Text { get; set; }
member this.Text : string with get, set
Public Property Text As String

속성 값

MenuItemBinding이 적용된 메뉴 항목에 표시되는 텍스트입니다.The text displayed for the menu item to which the MenuItemBinding is applied. 기본값은 빈 문자열("")로, 이 속성이 설정되어 있지 않음을 나타냅니다.The default is an empty string (""), which indicates that this property is not set.

예제

다음 코드 예제를 사용 하는 방법에 설명 합니다 Text 메뉴 항목에 표시할 텍스트를 지정 하는 속성입니다.The following code example demonstrates how to use the Text property to specify the text to display in a menu item. 이 텍스트는 각 메뉴 항목에 표시 되는 MenuItemBinding 개체 적용 됩니다.This text is displayed in each menu item to which the MenuItemBinding object is applied. 제대로 작동 하려면이 예제에서는 Menu.xml 라는 파일에 아래 샘플 XML 데이터를 복사 해야 합니다.For this example to work correctly, you must copy the sample XML data below to a file named Menu.xml.


<%@ page language="C#" %>

<!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 runat="server">
    <title>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <databindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            text="Static Title"
            value="Static Description"
            imageurl="~\Images\StaticImage.jpg"
            tooltip="Static ToolTip"/>
          
        </databindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

    </form>
  </body>
</html>


<%@ page language="VB" %>

<!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 runat="server">
    <title>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <databindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            text="Static Title"
            value="Static Description"
            imageurl="~\Images\StaticImage.jpg"
            tooltip="Static ToolTip"/>
          
        </databindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

    </form>
  </body>
</html>

다음 코드는 이전 예제에 대 한 사이트 맵 데이터 샘플입니다.The following code is sample site map data for the previous example.

<MapHomeNode ImageUrl="~\Images\Home.gif"

Title="Home"

Description="Root Page"

ToolTip="Home Page">

<MapNode ImageUrl="~\Images\Music.gif"

Title="Music"

Description="Music Category"

ToolTip="Music Page">

<MapNode ImageUrl="~\Images\Classical.gif"

Title="Classical"

Description="Classical Section"

ToolTip="Classical Page"/>

<MapNode ImageUrl="~\Images\Rock.gif"

Title="Rock"

Description="Rock Section"

ToolTip="Rock Page"/>

<MapNode ImageUrl="~\Images\Jazz.gif"

Title="Jazz"

Description="Jazz Section"

ToolTip="Jazz Page"/>

</MapNode>

<MapNode ImageUrl="~\Images\Movies.gif"

Title="Movies"

Description="Movies Category"

ToolTip="Movies Page">

<MapNode ImageUrl="~\Images\Action.gif"

Title="Action"

Description="Action Section"

ToolTip="Action Page"/>

<MapNode ImageUrl="~\Images\Drama.gif"

Title="Drama"

Description="Drama Section"

ToolTip="Drama Page"/>

<MapNode ImageUrl="~\Images\Musical.gif"

Title="Musical"

Description="Musical Section"

ToolTip="Musical Page"/>

</MapNode>

</MapHomeNode>

설명

때를 Menu 데이터 원본에 바인딩된 컨트롤을 사용 합니다 Text 바인딩할 텍스트를 지정 하는 속성을 MenuItem.Text 의 속성을 MenuItem 개체.When the Menu control is bound to a data source, use the Text property to specify the text to bind to the MenuItem.Text property of a MenuItem object. 이 텍스트 메뉴 항목에 표시 되 고 모든 메뉴 항목을 사용 하 여 공유 되는 MenuItemBinding 개체 적용 됩니다.This text is displayed in a menu item and is shared with all menu items to which the MenuItemBinding object is applied.

참고

개별 메뉴 항목에 대 한 텍스트를 설정 하 여 재정의할 수 있습니다 해당 Text 속성을 직접.You can override the text for an individual menu item by setting its Text property directly.

각 메뉴 항목에 동일한 텍스트를 표시 하려면이 속성을 사용 하는 대신 바인딩할 수도 있습니다는 Text 의 속성을 MenuItem 개체를 설정 하 여 데이터 원본의 필드를 TextField 속성입니다.Instead of using this property to display the same text in each menu item, you can also bind the Text property of a MenuItem object to a field of a data source by setting the TextField property. 렌더링 될 때를 Text 하려는 각 메뉴 항목의 속성을 MenuItemBinding 개체가 적용 된 필드에서 해당 값을 포함 합니다.When rendered, the Text property of each menu item to which the MenuItemBinding object is applied contains the corresponding value from the field.

참고

경우는 TextTextField 속성이 모두 설정의 TextField 속성이 우선 합니다.If the Text and TextField properties are both set, the TextField property takes precedence.

빈 노드를 만들 수 없습니다는 Menu 설정 하 여 컨트롤을 Text 또는 TextField 속성을 빈 문자열 ("").You cannot create empty nodes in a Menu control by setting the Text or TextField properties to the empty string (""). 이러한 속성을 빈 문자열로 설정 속성을 설정 하지 않으면 하는 것과 동일한 효과가 있습니다.Setting these properties to the empty string has the same effect as not setting the properties. 이런 경우는 Menu 컨트롤을 사용 하 여 기본 바인딩을 만듭니다는 DataSource 속성입니다.In that case, the Menu control creates a default binding using the DataSource property. 자세한 내용은 ASP.NET 데이터 액세스 콘텐츠 맵합니다.For more information, see ASP.NET Data Access Content Map.

이 속성의 값으로 설정 된 경우 디자이너 도구를 사용 하 여 리소스 파일에 자동으로 저장 될 수 있습니다.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. 자세한 내용은 LocalizableAttribute 하 고 전역화 및 지역화합니다.For more information, see LocalizableAttribute and Globalization and Localization.

적용 대상

추가 정보