MenuItem.Value 속성

정의

포스트백 이벤트 처리에 사용되는 데이터 같이 메뉴 항목에 대한 추가 데이터를 저장하는 데 사용되는 표시되지 않는 값을 가져오거나 설정합니다.Gets or sets a non-displayed value used to store any additional data about the menu item, such as data used for handling postback events.

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

속성 값

메뉴 항목에 대한 표시되지 않는 추가 데이터입니다.Supplemental data about the menu item that is not displayed. 기본값은 빈 문자열("")입니다.The default value is an empty string ("").

예제

다음 예제에서는 표시 하는 방법에 설명 합니다 Value 메뉴 항목 및 사용자가 메뉴 항목을 선택 하면 부모에 대 한 합니다.The following example demonstrates how to display the Value for a menu item and its parent when the user selects a menu item.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  
  void NavigationMenu_MenuItemClick(Object sender, MenuEventArgs e)
  {
    // Display the selected menu item.
    if (e.Item.Parent != null)
    {
      Message.Text = "You selected " + e.Item.Value + 
        " from " + e.Item.Parent.Value + ".";
    }
    else
    {
      Message.Text = "You selected " + e.Item.Value + ".";
    }
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Value Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Value Example</h3>
    
      Select an item from the menu:<br/><br/>
 
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="1"
        staticsubmenuindent="10" 
        orientation="Vertical"
        onmenuitemclick="NavigationMenu_MenuItemClick"  
        runat="server">
        
        <dynamicselectedstyle backcolor="yellow"/>
        <staticselectedstyle backcolor="yellow"/>

        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Category"
              value="Category 1"
              tooltip="Category 1">
              <asp:menuitem text="Topic"
                value="Topic 1"
                tooltip="Topic 1"/>
              <asp:menuitem text="Topic"
                value="Topic 2"
                tooltip="Topic 2"/>
              <asp:menuitem text="Topic"
                value="Topic 3"
                tooltip="Topic 3"/>
            </asp:menuitem>
            <asp:menuitem text="Category"
              value="Category 2"
              tooltip="Category 2">
              <asp:menuitem text="Topic"
                value="Topic 1"
                tooltip="Topic 1"/>
              <asp:menuitem text="Topic"
                value="Topic 2"
                tooltip="Topic 2"/>
              <asp:menuitem text="Topic"
                value="Topic 3"
                tooltip="Topic 3"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

      <hr/>
      
      <asp:label id="Message"
        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">
<script runat="server">
  
  Sub NavigationMenu_MenuItemClick(ByVal sender As Object, ByVal e As MenuEventArgs)
  
    ' Display the selected menu item.
    If e.Item.Parent IsNot Nothing Then
    
      Message.Text = "You selected " & e.Item.Value & _
        " from " & e.Item.Parent.Value & "."
    
    Else
    
      Message.Text = "You selected " & e.Item.Value & "."
      
    End If
      
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Value Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Value Example</h3>
    
      Select an item from the menu:<br/><br/>
  
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="1"
        staticsubmenuindent="10" 
        orientation="Vertical"
        onmenuitemclick="NavigationMenu_MenuItemClick"  
        runat="server">
        
        <dynamicselectedstyle backcolor="yellow"/>
        <staticselectedstyle backcolor="yellow"/>

        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Category"
              value="Category 1"
              tooltip="Category 1">
              <asp:menuitem text="Topic"
                value="Topic 1"
                tooltip="Topic 1"/>
              <asp:menuitem text="Topic"
                value="Topic 2"
                tooltip="Topic 2"/>
              <asp:menuitem text="Topic"
                value="Topic 3"
                tooltip="Topic 3"/>
            </asp:menuitem>
            <asp:menuitem text="Category"
              value="Category 2"
              tooltip="Category 2">
              <asp:menuitem text="Topic"
                value="Topic 1"
                tooltip="Topic 1"/>
              <asp:menuitem text="Topic"
                value="Topic 2"
                tooltip="Topic 2"/>
              <asp:menuitem text="Topic"
                value="Topic 3"
                tooltip="Topic 3"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

      <hr/>
      
      <asp:label id="Message"
        runat="server"/>

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

설명

합니다 Value 속성을 보완 하는 데 사용 됩니다는 Text 메뉴 항목과 연결 된 추가 데이터를 저장 하 여 속성입니다.The Value property is used to supplement the Text property by storing any additional data associated with the menu item. 이 값은 컨트롤에 표시 되지 않습니다 및는 일반적으로 포스트백 이벤트를 처리 하는 것에 대 한 데이터를 저장 하는 데 사용 됩니다.This value is not displayed in the control and is commonly used to store data for handling postback events.

참고

경우는 Value 속성을 포함 null, get 의 값을 반환 하는 접근자를 Text 속성입니다.If the Value property contains null, the get accessor returns the value of the Text property. 경우는 Text 속성에 차례로 포함 null, Empty 반환 됩니다.If the Text property, in turn, contains null, Empty is returned.

값을 Value 속성에 지정 된 값 경로 때도 사용 됩니다는 ValuePath 속성이 생성 됩니다.The value of the Value property is also used when the value path specified in the ValuePath property is generated. 값 경로 루트 메뉴 항목을 현재 메뉴 항목 까지의 경로 형성 하는 메뉴 항목 값의 구분 기호로 구분 된 목록입니다.A value path is a delimiter-separated list of menu item values that forms a path from the root menu item to the current menu item. 값 경로에서 메뉴 항목의 위치를 나타내는 데 사용 되는 Menu 제어 합니다.The value path is used to indicate the position of a menu item in a Menu control.

참고

메뉴 항목 동일 메뉴 수준에서 각 있어야에 고유한 값을 합니다 Value 속성, Menu 컨트롤 같은 값이 있는 동일한 수준의 다른 메뉴 항목을 구분할 수 없습니다.Menu items at the same menu level must each have a unique value for the Value property; the Menu control cannot distinguish between different menu items at the same level that have the same value.

이 속성의 값으로 설정 된 경우 디자이너 도구를 사용 하 여 리소스 파일에 자동으로 저장 될 수 있습니다.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.

적용 대상

추가 정보