MenuItemBinding.Value Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Получает или задает неотображаемое значение, которое используется для хранения любых дополнительных данных о пункте меню, к которому применяется объект MenuItemBinding, например, данных, которые используются для обработки событий обратной передачи.

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

Значение свойства

String

Дополнительные данные о пункте меню, к которому применяется объект MenuItemBinding; эти данные не отображаются. По умолчанию свойство содержит пустую строку (""), показывающую, что значение свойства не задано.

Примеры

В следующем примере кода показано, как использовать Value свойство для указания нераспроиздавленного значения, связанного с элементом меню. Это значение используется в каждом пункте меню, к которому MenuItemBinding применяется объект. Чтобы этот пример работал правильно, необходимо скопировать приведенные ниже примеры XML-данных в файл с именем 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>

Следующий код является примером данных карты сайта для предыдущего примера.

<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 Если элемент управления привязан к источнику данных, используйте Value свойство, чтобы указать значение для привязки MenuItem к MenuItem.Value свойству объекта. Это значение предоставляется всем пунктам меню, к которым MenuItemBinding применяется объект. Указанное значение не отображается в пункте меню и используется для хранения дополнительных данных об элементе меню, к которому MenuItemBinding применяется объект, например данные, используемые для обработки событий обратной передачи.

Примечание

Вы можете переопределить значение для отдельного пункта меню, задав его Value свойство напрямую.

Вместо того чтобы использовать это свойство для указания одного значения для каждого пункта меню, можно также привязать Value свойство MenuItem объекта к полю источника данных, задав ValueField свойство. При отображении свойство каждого пункта меню, к которому MenuItemBinding применяется объект, Value содержит соответствующее значение из поля.

Примечание

Value ValueField Если оба свойства заданы, ValueField свойство имеет приоритет.

Значение этого свойства при установке можно автоматически сохранить в файл ресурсов с помощью средства конструктора. Дополнительные сведения см. в разделе LocalizableAttribute и глобализации и локализации.

Применяется к

См. также раздел