Menu Класс

Определение

Отображает меню на веб-странице ASP.NET.Displays a menu in an ASP.NET Web page.

public ref class Menu : System::Web::UI::WebControls::HierarchicalDataBoundControl, System::Web::UI::INamingContainer, System::Web::UI::IPostBackEventHandler
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class Menu : System.Web.UI.WebControls.HierarchicalDataBoundControl, System.Web.UI.INamingContainer, System.Web.UI.IPostBackEventHandler
type Menu = class
    inherit HierarchicalDataBoundControl
    interface IPostBackEventHandler
    interface INamingContainer
Public Class Menu
Inherits HierarchicalDataBoundControl
Implements INamingContainer, IPostBackEventHandler
Наследование
Атрибуты
Реализации

Примеры

Для этого раздела доступен проект веб-сайта Visual Studio с исходным кодом: Скачайте.A Visual Studio Web site project with source code is available to accompany this topic: Download.

В следующем примере кода показано, как создать Menu элемент управления со статическими элементами меню с помощью декларативного синтаксиса.The following code example demonstrates how to create a Menu control with static menu items using declarative syntax.


<%@ 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" >

  <!-- For the hover styles of the Menu control to  -->
  <!-- work correctly, you must include this head   -->
  <!-- element.                                     -->
  <head runat="server">
    <title>Menu Declarative Example</title>
</head>

  <body>
    <form id="form1" runat="server">
    
      <h3>Menu Declarative Example</h3>
    
      <!-- Use declarative syntax to create the   -->
      <!-- menu structure. Submenu items are      -->
      <!-- created by nesting them in parent menu -->
      <!-- items.                                 -->
      <asp:menu id="NavigationMenu"
        disappearafter="2000"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        font-names="Arial" 
        target="_blank"  
        runat="server">
        
        <staticmenuitemstyle backcolor="LightSteelBlue"
          forecolor="Black"/>
        <statichoverstyle backcolor="LightSkyBlue"/>
        <dynamicmenuitemstyle backcolor="Black"
          forecolor="Silver"/>
        <dynamichoverstyle backcolor="LightSkyBlue"
          forecolor="Black"/>
      
        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

    </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" >

  <!-- For the hover styles of the Menu control to  -->
  <!-- work correctly, you must include this head   -->
  <!-- element.                                     -->
  <head runat="server">
    <title>Menu Declarative Example</title>
</head>

  <body>
    <form id="form1" runat="server">
    
      <h3>Menu Declarative Example</h3>
    
      <!-- Use declarative syntax to create the   -->
      <!-- menu structure. Submenu items are      -->
      <!-- created by nesting them in parent menu -->
      <!-- items.                                 -->
      <asp:menu id="NavigationMenu"
        disappearafter="2000"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        font-names="Arial" 
        target="_blank"  
        runat="server">
        
        <staticmenuitemstyle backcolor="LightSteelBlue"
          forecolor="Black"/>
        <statichoverstyle backcolor="LightSkyBlue"/>
        <dynamicmenuitemstyle backcolor="Black"
          forecolor="Silver"/>
        <dynamichoverstyle backcolor="LightSkyBlue"
          forecolor="Black"/>
      
        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

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

В следующем примере кода показано, как привязать Menu элемент управления SiteMapDataSource к элементу управления.The following code example demonstrates how to bind the Menu control to a SiteMapDataSource control. Для правильной работы этого примера необходимо скопировать приведенные ниже данные карты сайта в файл с именем Web. sitemap.For this example to work correctly, you must copy the sample site map data below to a file named Web.sitemap.


<%@ 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" >

  <!-- For the hover styles of the Menu control to  -->
  <!-- work correctly, you must include this head   -->
  <!-- element.                                     -->
  <head runat="server">
    <title>Menu DataBinding Example</title>
</head>

  <body>
    <form id="form1" runat="server">
    
      <h3>Menu DataBinding Example</h3>
    
      <!-- Bind the Menu control to a SiteMapDataSource control.  -->
      <asp:menu id="NavigationMenu"
        disappearafter="2000"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        font-names="Arial" 
        target="_blank"
        datasourceid="MenuSource"   
        runat="server">
        
        <staticmenuitemstyle backcolor="LightSteelBlue"
          forecolor="Black"/>
        <statichoverstyle backcolor="LightSkyBlue"/>
        <dynamicmenuitemstyle backcolor="Black"
          forecolor="Silver"/>
        <dynamichoverstyle backcolor="LightSkyBlue"
          forecolor="Black"/>

      </asp:menu>
      
      <asp:SiteMapDataSource id="MenuSource"
        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" >

  <!-- For the hover styles of the Menu control to  -->
  <!-- work correctly, you must include this head   -->
  <!-- element.                                     -->
  <head runat="server">
    <title>Menu DataBinding Example</title>
</head>

  <body>
    <form id="form1" runat="server">
    
      <h3>Menu DataBinding Example</h3>
    
      <!-- Bind the Menu control to a SiteMapDataSource control.  -->
      <asp:menu id="NavigationMenu"
        disappearafter="2000"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        font-names="Arial" 
        target="_blank"
        datasourceid="MenuSource"   
        runat="server">
        
        <staticmenuitemstyle backcolor="LightSteelBlue"
          forecolor="Black"/>
        <statichoverstyle backcolor="LightSkyBlue"/>
        <dynamicmenuitemstyle backcolor="Black"
          forecolor="Silver"/>
        <dynamichoverstyle backcolor="LightSkyBlue"
          forecolor="Black"/>

      </asp:menu>
      
      <asp:SiteMapDataSource id="MenuSource"
        runat="server"/>        

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

Ниже приведен пример данных схемы сайта для предыдущего примера.The following is sample site map data for the previous example.

<siteMap>  
  <siteMapNode url="~\Home.aspx"   
    title="Home"  
    description="Home">  
    <siteMapNode url="~\Music.aspx"  
      title="Music"  
      description="Music">  
      <siteMapNode url="~\Classical.aspx"   
        title="Classical"  
        description="Classical"/>  
      <siteMapNode url="~\Rock.aspx"  
        title="Rock"  
        description="Rock"/>  
      <siteMapNode url="~\Jazz.aspx"  
        title="Jazz"  
        description="Jazz"/>  
    </siteMapNode>  
    <siteMapNode url="~\Movies.aspx"  
      title="Movies"  
      description="Movies">  
      <siteMapNode url="~\Action.aspx"  
        title="Action"  
        description="Action"/>  
      <siteMapNode url="~\Drama.aspx"  
        title="Drama"  
        description="Drama"/>  
      <siteMapNode url="~\Musical.aspx"  
        title="Musical"  
        description="Musical"/>  
    </siteMapNode>  
  </siteMapNode>  
</siteMap>  

Комментарии

В этом разделе.In this topic:

ВступлениеIntroduction

Элемент управления используется для вывода меню на веб-странице ASP.NET и часто используется в сочетании SiteMapDataSource с элементом управления для навигации по веб-сайту. MenuThe Menu control is used to display a menu in an ASP.NET Web page and is often used in combination with a SiteMapDataSource control for navigating a Web site. Menu Элемент управления поддерживает следующие функции:The Menu control supports the following features:

  • Привязка данных, позволяющая привязывать элементы меню элемента управления к иерархическим источникам данных.Data binding that allows the control's menu items to be bound to hierarchal data sources.

  • Навигация по сайту с помощью интеграции SiteMapDataSource с элементом управления.Site navigation through integration with the SiteMapDataSource control.

  • Программный доступ к Menu объектной модели для динамического создания меню, заполнения пунктов меню, установки свойств и т. д.Programmatic access to the Menu object model to dynamically create menus, populate menu items, set properties, and so on.

  • Настраиваемый внешний вид с помощью тем, определяемых пользователем изображений, стилей и определяемых пользователем шаблонов.Customizable appearance through themes, user-defined images, styles, and user-defined templates.

Когда пользователь щелкает элемент меню, Menu элемент управления может перейти на связанную веб-страницу или просто выполнить обратную передачу на сервер.When the user clicks a menu item, the Menu control can either navigate to a linked Web page or simply post back to the server. Если свойство элемента меню задано Menu , элемент управления переходит на связанную страницу. в противном случае она отправляет страницу обратно на сервер для обработки. NavigateUrlIf the NavigateUrl property of a menu item is set, the Menu control navigates to the linked page; otherwise, it posts the page back to the server for processing. По умолчанию связанная страница отображается в том же окне или фрейме, что Menu и элемент управления.By default, a linked page is displayed in the same window or frame as the Menu control. Чтобы отобразить связанное содержимое в другом окне или рамке, используйте Target свойство Menu элемента управления.To display the linked content in a different window or frame, use the Target property of the Menu control.

Примечание

Target Свойство влияет на каждый пункт меню в элементе управления.The Target property affects every menu item in the control. Чтобы задать окно или фрейм для отдельного элемента меню, непосредственно задайте Target свойство MenuItem объекта.To specify a window or frame for an individual menu item, set the Target property of the MenuItem object directly.

Menu Элемент управления отображает два типа меню: статическое меню и динамическое меню.The Menu control displays two types of menus: a static menu and a dynamic menu. Статическое меню всегда отображается в Menu элементе управления.The static menu is always displayed in a Menu control. По умолчанию пункты меню на корневом уровне (уровень 0) отображаются в статическом меню.By default, the menu items at the root level (level 0) are displayed in the static menu. Можно отобразить дополнительные уровни меню (статические подменю) в статическом меню, задав StaticDisplayLevels свойство.You can display additional menu levels (static submenus) within the static menu by setting the StaticDisplayLevels property. Элементы меню (если они есть) с более высоким уровнем, чем значение, заданное StaticDisplayLevels свойством, отображаются в динамическом меню.Menu items (if any) with a higher level than the value specified by the StaticDisplayLevels property are displayed in a dynamic menu. Динамическое меню появляется только в том случае, если пользователь позиционирует указатель мыши на родительский элемент меню, содержащий динамическое подменю.A dynamic menu appears only when the user positions the mouse pointer over the parent menu item that contains a dynamic submenu. Динамические меню автоматически исчезают после определенной длительности.Dynamic menus automatically disappear after a certain duration. Чтобы указать длительность, используйте свойство.DisappearAfterUse the DisappearAfter property to specify the duration.

Примечание

Динамическое меню также исчезает, когда пользователь щелкает за пределами меню.A dynamic menu also disappears when the user clicks outside of the menu.

Можно также ограничить число уровней, отображаемых в динамическом меню, задав MaximumDynamicDisplayLevels свойство.You can also limit the number of levels displayed in a dynamic menu by setting the MaximumDynamicDisplayLevels property. Уровни меню выше указанного значения отбрасываются.Menu levels higher than the specified value are discarded.

Примечание

Элемент управления не предназначен для использования UpdatePanel внутри элемента управления. MenuThe Menu control is not designed to be used inside an UpdatePanel control. Menu Элемент управления можно добавить только на страницу UpdatePanel за пределами элемента управления.You can add the Menu control only to a page outside an UpdatePanel control. UpdatePanelэлементы управления используются для обновления выбранных областей страницы вместо обновления всей страницы с помощью обратной передачи.UpdatePanel controls are used to update selected regions of a page instead of updating the whole page with a postback. Дополнительные сведения см. в разделе Общие сведения об элементе управления UpdatePanel и Общие сведения о частичной отрисовке страниц.For more information, see UpdatePanel Control Overview and Partial-Page Rendering Overview.

Элемент управления состоит из дерева пунктов меню, MenuItem представленных объектами. MenuA Menu control is made up of a tree of menu items represented by MenuItem objects. Пункты меню на верхнем уровне (уровень 0) называются элементами корневого меню.Menu items at the top level (level 0) are called root menu items. Элемент меню, имеющий родительский элемент меню, называется дочерним элементом меню.A menu item that has a parent menu item is called a child menu item. Все корневые элементы меню хранятся в Items коллекции.All root menu items are stored in the Items collection. Дочерние пункты меню хранятся в ChildItems коллекции элементов родительского меню.Child menu items are stored in a parent menu item's ChildItems collection.

Каждый пункт меню имеет Text Value свойства и.Each menu item has a Text and a Value property. Значение Text свойства отображается Menu в элементе управления, а Value свойство используется для хранения дополнительных данных об элементе меню, например данных, передаваемых в событие обратной передачи, связанное с пунктом меню.The value of the Text property is displayed in the Menu control, while the Value property is used to store any additional data about the menu item, such as data passed to the postback event associated with the menu item. При нажатии пункта меню можно переходить на другую веб-страницу, указанную NavigateUrl свойством.When clicked, a menu item can navigate to another Web page indicated by the NavigateUrl property.

Примечание

Если свойство не задано для пункта меню Menu , элемент управления просто отправляет страницу на сервер для обработки при нажатии пункта меню. NavigateUrlIf the NavigateUrl property is not set for a menu item, the Menu control simply submits the page to the server for processing when the menu item is clicked.

При необходимости можно также отобразить изображение в пункте меню, задав ImageUrl свойство.You can also optionally display an image in a menu item by setting the ImageUrl property.

Дополнительные сведения о пунктах меню см. MenuItemв разделе.For more information on menu items, see MenuItem.

Статические данныеStatic Data

Простейшая модель Menu данных элемента управления — это статические пункты меню.The simplest data model of the Menu control is static menu items. Чтобы отобразить элементы статического меню с помощью декларативного синтаксиса, сначала вложенные открывающие и закрывающие <Items> теги между открывающим и закрывающим тегами Menu элемента управления.To display static menu items using declarative syntax, first nest opening and closing <Items> tags between the opening and closing tags of the Menu control. Затем создайте структуру меню, добавив вложенные <asp:MenuItem> элементы между открывающим и закрывающим <Items> тегами.Next, create the menu structure by nesting <asp:MenuItem> elements between the opening and closing <Items> tags. Каждый <asp:MenuItem> элемент представляет пункт меню в элементе управления и сопоставляется MenuItem с объектом.Each <asp:MenuItem> element represents a menu item in the control and maps to a MenuItem object. Свойства каждого пункта меню можно задать, задав атрибуты его <asp:MenuItem> элемента.You can set the properties of each menu item by setting the attributes of its <asp:MenuItem> element. Чтобы создать элементы подменю, вложите <asp:MenuItem> дополнительные элементы между открывающим и <asp:MenuItem> закрывающим тегами пункта родительского меню.To create submenu items, nest additional <asp:MenuItem> elements between the opening and closing <asp:MenuItem> tags of the parent menu item.

Привязка к даннымBinding to Data

Элемент управления может использовать любой элемент управления источником иерархических данных, например XmlDataSource элемент управления или SiteMapDataSource элемент управления. MenuThe Menu control can use any hierarchal data source control, such as an XmlDataSource control or a SiteMapDataSource control. Чтобы выполнить привязку к элементу управления источника иерархических данных DataSourceID , присвойте Menu свойству элемента ID управления значение, равное значению элемента управления источника данных.To bind to a hierarchal data source control, set the DataSourceID property of the Menu control to the ID value of the data source control. Menu Элемент управления автоматически привязывается к указанному элементу управления источником данных.The Menu control automatically binds to the specified data source control. Это предпочтительный метод для привязки к данным.This is the preferred method to bind to data.

При привязке к источнику данных, где каждый элемент данных содержит несколько свойств (например, элемент XML с несколькими атрибутами), элемент меню отображает значение, возвращаемое ToString методом элемента данных по умолчанию.When binding to a data source where each data item contains multiple properties (such as an XML element with several attributes), a menu item displays the value returned by the ToString method of the data item by default. В случае XML-элемента элемент меню отображает имя элемента, которое показывает базовую структуру дерева меню, но не очень полезно в противном случае.In the case of an XML element, the menu item displays the element name, which shows the underlying structure of the menu tree but is not very useful otherwise. Элемент меню можно привязать к определенному свойству элемента данных, используя DataBindings коллекцию для указания привязок пунктов меню.You can bind a menu item to a specific data item property by using the DataBindings collection to specify menu item bindings. DataBindings Коллекция содержитMenuItemBinding объекты, определяющие связь между элементом данных и пунктом меню, к которому он привязан.The DataBindings collection contains MenuItemBinding objects that define the relationship between a data item and the menu item it is binding to. Можно указать критерии для привязки и свойство элемента данных, которые будут отображаться в узле.You can specify the criteria for binding and the data item property to display in the node. Дополнительные сведения о привязках пунктов меню см. в MenuItemBindingразделе.For more information on menu item bindings, see MenuItemBinding.

Нельзя создать пустые узлы в 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. Дополнительные сведения см. в разделе Привязка к базам данных.For more information, see Binding to Databases.

Настройка пользовательского интерфейсаCustomizing the User Interface

Существует множество способов настройки внешнего вида Menu элемента управления.There are many ways to customize the appearance of the Menu control. Во-первых, можно указать, Menu должен ли элемент управления подготавливаться горизонтально или Orientation вертикально, задав свойство.First, you can specify whether the Menu control is rendered horizontally or vertically by setting the Orientation property. Можно также указать другой стиль (например, размер и цвет шрифта) для каждого из типов элементов меню.You can also specify a different style (such as font size and color) for each of the menu item types.

Если для настройки внешнего вида элемента управления используются каскадные таблицы стилей (CSS), используйте либо встроенные стили, либо отдельный CSS-файл, но не оба.If you use cascading style sheets (CSS) to customize the appearance of the control, use either inline styles or a separate CSS file, but not both. Использование обоих встроенных стилей и отдельного CSS-файла может привести к непредвиденным результатам.Using both inline styles and a separate CSS file could cause unexpected results. Дополнительные сведения об использовании таблиц стилей с элементами управления см. в разделе элементы управления веб-сервера и стили CSS.For more information on using style sheets with controls, see Web Server Controls and CSS Styles.

В следующей таблице перечислены доступные стили пунктов меню.The following table lists the available menu item styles.

Свойство стиля пункта менюMenu item style property ОписаниеDescription
DynamicHoverStyle Параметры стиля для элемента динамического меню при помещении на него указателя мыши.The style settings for a dynamic menu item when the mouse pointer is positioned over it.
DynamicMenuItemStyle Параметры стиля для отдельного элемента динамического меню.The style settings for an individual dynamic menu item.
DynamicMenuStyle Параметры стиля для динамического меню.The style settings for a dynamic menu.
DynamicSelectedStyle Параметры стиля для выбранного в данный момент элемента динамического меню.The style settings for the currently selected dynamic menu item.
StaticHoverStyle Параметры стиля для элемента статического меню при помещении на него указателя мыши.The style settings for a static menu item when the mouse pointer is positioned over it.
StaticMenuItemStyle Параметры стиля для отдельного элемента статического меню.The style settings for an individual static menu item.
StaticMenuStyle Параметры стиля для статического меню.The style settings for a static menu.
StaticSelectedStyle Параметры стиля для выбранного в данный момент элемента статического меню.The style settings for the currently selected static menu item.

Вместо настройки отдельных свойств стиля можно указать стили, применяемые к пунктам меню на основе их уровня, используя следующие коллекции стилей.Instead of setting the individual style properties, you can specify styles that are applied to menu items based on their level by using the following style collections.

Коллекции стилей уровнейLevel style collections ОписаниеDescription
LevelMenuItemStyles Коллекция MenuItemStyle объектов, управляющих стилем пунктов меню на уровне каждого уровня.A collection of MenuItemStyle objects that control the style of the menu items on a level basis.
LevelSelectedStyles Коллекция MenuItemStyle объектов, управляющих стилем выбранных пунктов меню на уровне каждого уровня.A collection of MenuItemStyle objects that control the style of selected menu items on a level basis.
LevelSubMenuStyles Коллекция MenuItemStyle объектов, управляющих стилем пунктов подменю на уровне каждого уровня.A collection of MenuItemStyle objects that control the style of the submenu items on a level basis.

Первый стиль в коллекции соответствует стилю пунктов меню на первом уровне глубины в дереве меню.The first style in the collection corresponds to the style of the menu items at the first depth level in the menu tree. Второй стиль в коллекции соответствует стилю пунктов меню на втором уровне глубины в дереве меню и т. д.The second style in the collection corresponds to the style of the menu items at the second depth level in the menu tree, and so on. Чаще всего это используется для создания таблицы меню навигации в стиле содержимого, где пункты меню в определенной глубине должны иметь одинаковый внешний вид независимо от того, есть ли в них подменю.This is most often used to generate table of contents-style navigation menus where menu items at a certain depth should have the same appearance, regardless of whether they have submenus.

Примечание

При использовании любой из коллекций стилей уровней, перечисленных в предыдущей таблице, для определения стиля Menu элемента управления, эти параметры стиля переопределяют свойства стиля отдельных пунктов меню.If you use any of the level style collections listed in the previous table to define the style for the Menu control, these style settings override the individual menu item style properties.

Другим способом изменения внешнего вида элемента управления является настройка изображений, отображаемых в Menu элементе управления.Another way to alter the appearance of the control is to customize the images displayed in the Menu control. Можно указать собственный пользовательский образ для различных частей элемента управления, задав свойства, показанные в следующей таблице.You can specify your own custom image for the different parts of the control by setting the properties shown in the following table.

Свойство ImageImage property ОписаниеDescription
DynamicBottomSeparatorImageUrl Необязательное изображение, отображаемое в нижней части элемента динамического меню для отделения его от других пунктов меню.An optional image displayed at the bottom of a dynamic menu item to separate it from other menu items.
DynamicPopOutImageUrl Необязательное изображение, отображаемое в пункте динамического меню для указания, что у него есть подменю.An optional image displayed in a dynamic menu item to indicate that it has a submenu.
DynamicTopSeparatorImageUrl Необязательное изображение, отображаемое в верхней части элемента динамического меню, чтобы отделить его от других пунктов меню.An optional image displayed at the top of a dynamic menu item to separate it from other menu items.
ScrollDownImageUrl Изображение, отображаемое в нижней части пункта меню и указывающее, что пользователь может прокручивать вниз для просмотра дополнительных пунктов меню.The image displayed at the bottom of a menu item to indicate that the user can scroll down to view additional menu items.
ScrollUpImageUrl Изображение, отображаемое в верхней части пункта меню и указывающее, что пользователь может прокручивать окно вверх для просмотра дополнительных пунктов меню.The image displayed at the top of a menu item to indicate that the user can scroll up to view additional menu items.
StaticBottomSeparatorImageUrl Необязательное изображение, отображаемое в нижней части статического пункта меню, чтобы отделить его от других пунктов меню.An optional image displayed at the bottom of a static menu item to separate it from other menu items.
StaticPopOutImageUrl Необязательное изображение, отображаемое в пункте статического меню для указания того, что у него есть подменю.An optional image displayed in a static menu item to indicate that it has a submenu.
StaticTopSeparatorImageUrl Необязательное изображение, отображаемое в верхней части элемента статического меню, чтобы отделить его от других пунктов меню.An optional image displayed at the top of a static menu item to separate it from other menu items.

Для полного управления пользовательским интерфейсом можно определить собственные пользовательские шаблоны для Menu элемента управления, используя следующие свойства шаблона.For complete control of the user interface (UI), you can define your own custom templates for the Menu control using the following template properties.

Свойство шаблонаTemplate property ОписаниеDescription
DynamicItemTemplate Шаблон, содержащий настраиваемое содержимое для отображения в элементе динамического меню.The template that contains the custom content to render for a dynamic menu item.
StaticItemTemplate Шаблон, содержащий настраиваемое содержимое для отображения в статическом элементе меню.The template that contains the custom content to render for a static menu item.

Можно управлять вертикальным и горизонтальным положением динамического меню относительно родительского пункта меню, задав DynamicVerticalOffset свойства и DynamicHorizontalOffset соответственно.You can control the vertical and horizontal position of a dynamic menu relative to its parent menu item by setting the DynamicVerticalOffset and DynamicHorizontalOffset properties, respectively. Для управления отступом статических элементов вложенного меню в статическом меню используйте StaticSubMenuIndent свойство.To control the indentation of the static submenu items within a static menu, use the StaticSubMenuIndent property.

СобытияEvents

Menu Элемент управления предоставляет несколько событий, по которым можно программировать.The Menu control provides several events that you can program against. Это позволяет запускать пользовательскую подпрограммы при каждом возникновении события.This allows you to run a custom routine whenever an event occurs. В следующей таблице перечислены поддерживаемые события.The following table lists the supported events.

событиеEvent ОписаниеDescription
MenuItemClick Происходит при щелчке пункта меню.Occurs when a menu item is clicked. Это событие обычно используется для синхронизации Menu элемента управления с другим элементом управления на странице.This event is commonly used to synchronize a Menu control with another control on the page.
MenuItemDataBound Происходит при привязке элемента меню к данным.Occurs when a menu item is bound to data. Это событие обычно используется для изменения пункта меню перед его отрисовкой в Menu элементе управления.This event is commonly used to modify a menu item before it is rendered in a Menu control.

Специальные возможностиAccessibility

Сведения о том, как настроить этот элемент управления таким образом, чтобы он создавал разметку, которая соответствует стандартам специальных возможностей, см. в разделе Специальные возможности в Visual Studio, ASP.NET и ASP.NET и специальные возможности.For information about how to configure this control so that it generates markup that conforms to accessibility standards, see Accessibility in Visual Studio and ASP.NET and ASP.NET Controls and Accessibility.

Декларативный синтаксисDeclarative Syntax

<asp:Menu  
    AccessKey="string"  
    BackColor="color name|#dddddd"  
    BorderColor="color name|#dddddd"  
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|  
        Inset|Outset"  
    BorderWidth="size"  
    CssClass="string"  
    DataSource="string"  
    DataSourceID="string"  
    DisappearAfter="integer"  
    DynamicBottomSeparatorImageUrl="uri"  
    DynamicEnableDefaultPopOutImage="True|False"  
    DynamicHorizontalOffset="integer"  
    DynamicItemFormatString="string"  
    DynamicPopOutImageTextFormatString="string"  
    DynamicPopOutImageUrl="uri"  
    DynamicTopSeparatorImageUrl="uri"  
    DynamicVerticalOffset="integer"  
    Enabled="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    Font-Bold="True|False"  
    Font-Italic="True|False"  
    Font-Names="string"  
    Font-Overline="True|False"  
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|  
        Large|X-Large|XX-Large"  
    Font-Strikeout="True|False"  
    Font-Underline="True|False"  
    ForeColor="color name|#dddddd"  
    Height="size"  
    ID="string"  
    ItemWrap="True|False"  
    MaximumDynamicDisplayLevels="integer"  
    OnDataBinding="DataBinding event handler"  
    OnDataBound="DataBound event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnLoad="Load event handler"  
    OnMenuItemClick="MenuItemClick event handler"  
    OnMenuItemDataBound="MenuItemDataBound event handler"  
    OnPreRender="PreRender event handler"  
    OnUnload="Unload event handler"  
    Orientation="Horizontal|Vertical"  
    PathSeparator="string"  
    runat="server"  
    ScrollDownImageUrl="uri"  
    ScrollDownText="string"  
    ScrollUpImageUrl="uri"  
    ScrollUpText="string"  
    SkinID="string"  
    SkipLinkText="string"  
    StaticBottomSeparatorImageUrl="uri"  
    StaticDisplayLevels="integer"  
    StaticEnableDefaultPopOutImage="True|False"  
    StaticItemFormatString="string"  
    StaticPopOutImageTextFormatString="string"  
    StaticPopOutImageUrl="uri"  
    StaticSubMenuIndent="size"  
    StaticTopSeparatorImageUrl="uri"  
    Style="string"  
    TabIndex="integer"  
    Target="string"  
    ToolTip="string"  
    Visible="True|False"  
    Width="size"  
>  
        <DataBindings>  
                <asp:MenuItemBinding  
                    DataMember="string"  
                    Depth="integer"  
                    Enabled="True|False"  
                    EnabledField="string"  
                    FormatString="string"  
                    ImageUrl="uri"  
                    ImageUrlField="string"  
                    NavigateUrl="uri"  
                    NavigateUrlField="string"  
                    PopOutImageUrl="uri"  
                    PopOutImageUrlField="string"  
                    Selectable="True|False"  
                    SelectableField="string"  
                    SeparatorImageUrl="uri"  
                    SeparatorImageUrlField="string"  
                    Target="string"  
                    TargetField="string"  
                    Text="string"  
                    TextField="string"  
                    ToolTip="string"  
                    ToolTipField="string"  
                    Value="string"  
                    ValueField="string"  
                />  
        </DataBindings>  
        <DynamicHoverStyle />  
        <DynamicItemTemplate>  
            <!-- child controls -->  
        </DynamicItemTemplate>  
        <DynamicMenuItemStyle  
            BackColor="color name|#dddddd"  
            BorderColor="color name|#dddddd"  
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|  
                Groove|Ridge|Inset|Outset"  
            BorderWidth="size"  
            CssClass="string"  
            Font-Bold="True|False"  
            Font-Italic="True|False"  
            Font-Names="string"  
            Font-Overline="True|False"  
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|  
                Medium|Large|X-Large|XX-Large"  
            Font-Strikeout="True|False"  
            Font-Underline="True|False"  
            ForeColor="color name|#dddddd"  
            Height="size"  
            HorizontalPadding="size"  
            ItemSpacing="size"  
            OnDisposed="Disposed event handler"  
            VerticalPadding="size"  
            Width="size"  
        />  
        <DynamicMenuStyle  
            BackColor="color name|#dddddd"  
            BorderColor="color name|#dddddd"  
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|  
                Groove|Ridge|Inset|Outset"  
            BorderWidth="size"  
            CssClass="string"  
            Font-Bold="True|False"  
            Font-Italic="True|False"  
            Font-Names="string"  
            Font-Overline="True|False"  
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|  
                Medium|Large|X-Large|XX-Large"  
            Font-Strikeout="True|False"  
            Font-Underline="True|False"  
            ForeColor="color name|#dddddd"  
            Height="size"  
            HorizontalPadding="size"  
            OnDisposed="Disposed event handler"  
            VerticalPadding="size"  
            Width="size"  
        />  
        <DynamicSelectedStyle  
            BackColor="color name|#dddddd"  
            BorderColor="color name|#dddddd"  
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|  
                Groove|Ridge|Inset|Outset"  
            BorderWidth="size"  
            CssClass="string"  
            Font-Bold="True|False"  
            Font-Italic="True|False"  
            Font-Names="string"  
            Font-Overline="True|False"  
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|  
                Medium|Large|X-Large|XX-Large"  
            Font-Strikeout="True|False"  
            Font-Underline="True|False"  
            ForeColor="color name|#dddddd"  
            Height="size"  
            HorizontalPadding="size"  
            ItemSpacing="size"  
            OnDisposed="Disposed event handler"  
            VerticalPadding="size"  
            Width="size"  
        />  
        <Items />  
        <LevelMenuItemStyles>  
                <asp:MenuItemStyle  
                    BackColor="color name|#dddddd"  
                    BorderColor="color name|#dddddd"  
                    BorderStyle="NotSet|None|Dotted|Dashed|Solid|  
                        Double|Groove|Ridge|Inset|Outset"  
                    BorderWidth="size"  
                    CssClass="string"  
                    Font-Bold="True|False"  
                    Font-Italic="True|False"  
                    Font-Names="string"  
                    Font-Overline="True|False"  
                    Font-Size="string|Smaller|Larger|XX-Small|  
                        X-Small|Small|Medium|Large|X-Large|XX-Large"  
                    Font-Strikeout="True|False"  
                    Font-Underline="True|False"  
                    ForeColor="color name|#dddddd"  
                    Height="size"  
                    HorizontalPadding="size"  
                    ItemSpacing="size"  
                    OnDisposed="Disposed event handler"  
                    VerticalPadding="size"  
                    Width="size"  
                />  
        </LevelMenuItemStyles>  
        <LevelSelectedStyles>  
                <asp:MenuItemStyle  
                    BackColor="color name|#dddddd"  
                    BorderColor="color name|#dddddd"  
                    BorderStyle="NotSet|None|Dotted|Dashed|Solid|  
                        Double|Groove|Ridge|Inset|Outset"  
                    BorderWidth="size"  
                    CssClass="string"  
                    Font-Bold="True|False"  
                    Font-Italic="True|False"  
                    Font-Names="string"  
                    Font-Overline="True|False"  
                    Font-Size="string|Smaller|Larger|XX-Small|  
                        X-Small|Small|Medium|Large|X-Large|XX-Large"  
                    Font-Strikeout="True|False"  
                    Font-Underline="True|False"  
                    ForeColor="color name|#dddddd"  
                    Height="size"  
                    HorizontalPadding="size"  
                    ItemSpacing="size"  
                    OnDisposed="Disposed event handler"  
                    VerticalPadding="size"  
                    Width="size"  
                />  
        </LevelSelectedStyles>  
        <LevelSubMenuStyles>  
                <asp:SubMenuStyle  
                    BackColor="color name|#dddddd"  
                    BorderColor="color name|#dddddd"  
                    BorderStyle="NotSet|None|Dotted|Dashed|Solid|  
                        Double|Groove|Ridge|Inset|Outset"  
                    BorderWidth="size"  
                    CssClass="string"  
                    Font-Bold="True|False"  
                    Font-Italic="True|False"  
                    Font-Names="string"  
                    Font-Overline="True|False"  
                    Font-Size="string|Smaller|Larger|XX-Small|  
                        X-Small|Small|Medium|Large|X-Large|XX-Large"  
                    Font-Strikeout="True|False"  
                    Font-Underline="True|False"  
                    ForeColor="color name|#dddddd"  
                    Height="size"  
                    HorizontalPadding="size"  
                    OnDisposed="Disposed event handler"  
                    VerticalPadding="size"  
                    Width="size"  
                />  
        </LevelSubMenuStyles>  
        <StaticHoverStyle />  
        <StaticItemTemplate>  
            <!-- child controls -->  
        </StaticItemTemplate>  
        <StaticMenuItemStyle  
            BackColor="color name|#dddddd"  
            BorderColor="color name|#dddddd"  
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|  
                Groove|Ridge|Inset|Outset"  
            BorderWidth="size"  
            CssClass="string"  
            Font-Bold="True|False"  
            Font-Italic="True|False"  
            Font-Names="string"  
            Font-Overline="True|False"  
            Font-Size="string|Smaller|Larger|XX-Small|  
                X-Small|Small|Medium|Large|X-Large|XX-Large"  
            Font-Strikeout="True|False"  
            Font-Underline="True|False"  
            ForeColor="color name|#dddddd"  
            Height="size"  
            HorizontalPadding="size"  
            ItemSpacing="size"  
            OnDisposed="Disposed event handler"  
            VerticalPadding="size"  
            Width="size"  
        />  
        <StaticMenuStyle  
            BackColor="color name|#dddddd"  
            BorderColor="color name|#dddddd"  
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|  
                Groove|Ridge|Inset|Outset"  
            BorderWidth="size"  
            CssClass="string"  
            Font-Bold="True|False"  
            Font-Italic="True|False"  
            Font-Names="string"  
            Font-Overline="True|False"  
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|  
                Medium|Large|X-Large|XX-Large"  
            Font-Strikeout="True|False"  
            Font-Underline="True|False"  
            ForeColor="color name|#dddddd"  
            Height="size"  
            HorizontalPadding="size"  
            OnDisposed="Disposed event handler"  
            VerticalPadding="size"  
            Width="size"  
        />  
        <StaticSelectedStyle  
            BackColor="color name|#dddddd"  
            BorderColor="color name|#dddddd"  
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|  
                Groove|Ridge|Inset|Outset"  
            BorderWidth="size"  
            CssClass="string"  
            Font-Bold="True|False"  
            Font-Italic="True|False"  
            Font-Names="string"  
            Font-Overline="True|False"  
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|  
                Medium|Large|X-Large|XX-Large"  
            Font-Strikeout="True|False"  
            Font-Underline="True|False"  
            ForeColor="color name|#dddddd"  
            Height="size"  
            HorizontalPadding="size"  
            ItemSpacing="size"  
            OnDisposed="Disposed event handler"  
            VerticalPadding="size"  
            Width="size"  
        />  
</asp:Menu>  

Конструкторы

Menu()

Инициализирует новый экземпляр класса Menu.Initializes a new instance of the Menu class.

Поля

MenuItemClickCommandName

Содержит имя команды.Contains the command name.

Свойства

AccessKey

Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Унаследовано от WebControl)
Adapter

Возвращает конкретный адаптер браузера для элемента управления.Gets the browser-specific adapter for the control.

(Унаследовано от Control)
AppRelativeTemplateSourceDirectory

Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Унаследовано от Control)
Attributes

Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Унаследовано от WebControl)
BackColor

Получает или задает цвет фона серверного веб-элемента управления.Gets or sets the background color of the Web server control.

(Унаследовано от WebControl)
BindingContainer

Возвращает элемент управления, который содержит привязку данных элемента управления.Gets the control that contains this control's data binding.

(Унаследовано от Control)
BorderColor

Возвращает или задает цвет рамки элемента управления Веба.Gets or sets the border color of the Web control.

(Унаследовано от WebControl)
BorderStyle

Получает или задает стиль границы серверного веб-элемента управления.Gets or sets the border style of the Web server control.

(Унаследовано от WebControl)
BorderWidth

Возвращает или задает ширину границы серверного веб-элемента управления.Gets or sets the border width of the Web server control.

(Унаследовано от WebControl)
ChildControlsCreated

Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления.Gets a value that indicates whether the server control's child controls have been created.

(Унаследовано от Control)
ClientID

Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Унаследовано от Control)
ClientIDMode

Возвращает или задает алгоритм, используемый для создания значения свойства ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Унаследовано от Control)
ClientIDSeparator

Возвращает значение символа разделителя, используемого в свойстве ClientID.Gets a character value representing the separator character used in the ClientID property.

(Унаследовано от Control)
Context

Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса.Gets the HttpContext object associated with the server control for the current Web request.

(Унаследовано от Control)
Controls

Получает коллекцию ControlCollection, содержащую дочерние элементы управления элемента управления Menu.Gets a ControlCollection that contains the child controls of the Menu control.

ControlStyle

Возвращает или задает стиль серверного веб-элемента управления.Gets the style of the Web server control. Это свойство используется преимущественно разработчиками элементов управления.This property is used primarily by control developers.

(Унаследовано от WebControl)
ControlStyleCreated

Возвращает значение, определяющее, был ли объект Style создан для свойства ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Этот свойство в основном используется разработчиками элементов управления.This property is primarily used by control developers.

(Унаследовано от WebControl)
CssClass

Возвращает или задает класс каскадных листов стилей (CSS), преобразовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Унаследовано от WebControl)
DataBindings

Получает коллекцию объектов MenuItemBinding, определяющих связь между элементом данных и пунктом меню, к которому он привязан.Gets a collection of MenuItemBinding objects that define the relationship between a data item and the menu item it is binding to.

DataItemContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Унаследовано от Control)
DataKeysContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Унаследовано от Control)
DataSource

Получает или задает объект, из которого элемент управления, присоединенный к данным, извлекает свои данные.Gets or sets the object from which the data-bound control retrieves its list of data items.

(Унаследовано от BaseDataBoundControl)
DataSourceID

Получает или задает ID элемента управления, из которого элемент управления, присоединенный к данным, извлекает свои данные.Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.

(Унаследовано от HierarchicalDataBoundControl)
DesignMode

Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки.Gets a value indicating whether a control is being used on a design surface.

(Унаследовано от Control)
DisappearAfter

Получает или задает длительность отображения динамического меню после перемещения указателя мыши за его пределы.Gets or sets the duration for which a dynamic menu is displayed after the mouse pointer is no longer positioned over the menu.

DynamicBottomSeparatorImageUrl

Получает или задает URL-адрес изображения, которое отображается под пунктом динамического меню и отделяет его от остальных пунктов меню.Gets or sets the URL to an image to display at the bottom of each dynamic menu item to separate it from other menu items.

DynamicEnableDefaultPopOutImage

Получает или задает значение, указывающее, будет ли отображаться встроенное изображение, свидетельствующее о том, что в пункте динамического меню есть вложенное меню.Gets or sets a value indicating whether the built-in image that indicates that a dynamic menu item has a submenu is displayed.

DynamicHorizontalOffset

Получает или задает число пикселей смещения динамического меню по горизонтали относительно родительского пункта меню.Gets or sets the number of pixels to shift a dynamic menu horizontally relative to its parent menu item.

DynamicHoverStyle

Получает ссылку на объект Style, позволяющий задать внешний вид пункта динамического меню при наведении на него указателя мыши.Gets a reference to the Style object that allows you to set the appearance of a dynamic menu item when the mouse pointer is positioned over it.

DynamicItemFormatString

Получает или задает дополнительный текст, отображаемый вместе со всеми динамическими пунктами меню.Gets or sets additional text shown with all menu items that are dynamically displayed.

DynamicItemTemplate

Получает или задает шаблон, содержащий настраиваемое содержимое, преобразовываемое для отображения в динамическом меню.Gets or sets the template that contains the custom content to render for a dynamic menu.

DynamicMenuItemStyle

Получает ссылку на объект MenuItemStyle, позволяющий задать внешний вид пунктов динамического меню.Gets a reference to the MenuItemStyle object that allows you to set the appearance of the menu items within a dynamic menu.

DynamicMenuStyle

Получает ссылку на объект MenuItemStyle, позволяющий задать внешний вид динамического меню.Gets a reference to the MenuItemStyle object that allows you to set the appearance of a dynamic menu.

DynamicPopOutImageTextFormatString

Получает или задает альтернативный текст для изображения, свидетельствующий о том, что в пункте динамического меню есть вложенное меню.Gets or sets the alternate text for the image used to indicate that a dynamic menu item has a submenu.

DynamicPopOutImageUrl

Получает или задает URL-адрес пользовательского изображения, отображаемого в пункте динамического меню при наличии в нем вложенного меню.Gets or sets the URL to a custom image that is displayed in a dynamic menu item when the dynamic menu item has a submenu.

DynamicSelectedStyle

Получает ссылку на объект MenuItemStyle, позволяющий задать внешний вид выбранного пользователем пункта динамического меню.Gets a reference to the MenuItemStyle object that allows you to set the appearance of the dynamic menu item selected by the user.

DynamicTopSeparatorImageUrl

Получает или задает URL-адрес изображения, которое отображается над пунктом динамического меню и отделяет его от остальных пунктов меню.Gets or sets the URL to an image to display at the top of each dynamic menu item to separate it from other menu items.

DynamicVerticalOffset

Получает или задает число пикселей смещения динамического меню по вертикали относительно родительского пункта меню.Gets or sets the number of pixels to shift a dynamic menu vertically relative to its parent menu item.

Enabled

Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления.Gets or sets a value indicating whether the Web server control is enabled.

(Унаследовано от WebControl)
EnableTheming

Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления.Gets or sets a value indicating whether themes apply to this control.

(Унаследовано от WebControl)
EnableViewState

Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Унаследовано от Control)
Events

Возвращает список делегатов обработчиков событий элемента управления.Gets a list of event handler delegates for the control. Это свойство доступно только для чтения.This property is read-only.

(Унаследовано от Control)
Font

Возвращает свойства шрифта, связанные с серверным веб-элементом управления.Gets the font properties associated with the Web server control.

(Унаследовано от WebControl)
ForeColor

Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Унаследовано от WebControl)
HasAttributes

Получает значение, определяющие наличие атрибутов у элемента управления.Gets a value indicating whether the control has attributes set.

(Унаследовано от WebControl)
HasChildViewState

Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Унаследовано от Control)
Height

Получает или задает высоту серверного веб-элемента управления.Gets or sets the height of the Web server control.

(Унаследовано от WebControl)
ID

Возвращает или задает программный идентификатор, назначенный серверному элементу управления.Gets or sets the programmatic identifier assigned to the server control.

(Унаследовано от Control)
IdSeparator

Возвращает символ, используемый для разделения идентификаторов элементов управления.Gets the character used to separate control identifiers.

(Унаследовано от Control)
IncludeStyleBlock

Получает или задает значение, указывающее, должна ли платформа ASP.NET отображать блок определений спецификации каскадных таблиц стилей (CSS) для стилей, используемых в меню.Gets or sets a value that indicates whether ASP.NET should render a block of cascading style sheet (CSS) definitions for the styles that are used in the menu.

Initialized

Получает значение, указывающее, был ли проинициализирован элемент управления, присоединенный к данным.Gets a value indicating whether the data-bound control has been initialized.

(Унаследовано от BaseDataBoundControl)
IsBoundUsingDataSourceID

Получает значение, указывающее, установлено ли свойство DataSourceID.Gets a value indicating whether the DataSourceID property is set.

(Унаследовано от BaseDataBoundControl)
IsChildControlStateCleared

Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления.Gets a value indicating whether controls contained within this control have control state.

(Унаследовано от Control)
IsDataBindingAutomatic

Получает значение, указывающее, является ли привязка данных автоматической.Gets a value that indicates whether data binding is automatic.

(Унаследовано от BaseDataBoundControl)
IsEnabled

Возвращает значение, определяющее, включен ли элемент управления.Gets a value indicating whether the control is enabled.

(Унаследовано от WebControl)
IsTrackingViewState

Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления.Gets a value that indicates whether the server control is saving changes to its view state.

(Унаследовано от Control)
IsUsingModelBinders

При реализации в производном классе получает значение, указывающее, использует ли элемент управления связыватели модели.When implemented in a derived class, gets a value that indicates whether the control is using model binders.

(Унаследовано от BaseDataBoundControl)
IsViewStateEnabled

Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления.Gets a value indicating whether view state is enabled for this control.

(Унаследовано от Control)
Items

Получает объект MenuItemCollection, содержащий все пункты меню элемента управления Menu.Gets a MenuItemCollection object that contains all menu items in the Menu control.

ItemWrap

Получает или задает значение, указывающее, нужно ли переносить текст пункта меню.Gets or sets a value indicating whether the text for menu items should wrap.

LevelMenuItemStyles

Получает объект MenuItemStyleCollection, содержащий параметры стиля, применяемые к пунктам меню в соответствии с их уровнем в элементе управления Menu.Gets a MenuItemStyleCollection object that contains the style settings that are applied to menu items based on their level in a Menu control.

LevelSelectedStyles

Получает объект MenuItemStyleCollection, содержащий параметры стиля, применяемые к выбранному пункту меню в соответствии с его уровнем в элементе управления Menu.Gets a MenuItemStyleCollection object that contains the style settings that are applied to the selected menu item based on its level in a Menu control.

LevelSubMenuStyles

Получает объект MenuItemStyleCollection, содержащий параметры стиля, применяемые к пунктам вложенного меню в статическом меню в соответствии с их уровнем в элементе управления Menu.Gets a MenuItemStyleCollection object that contains the style settings that are applied to the submenu items in the static menu based on their level in a Menu control.

LoadViewStateByID

Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Унаследовано от Control)
MaximumDynamicDisplayLevels

Получает или задает количество уровней меню обрабатываемых для просмотра в динамическом меню.Gets or sets the number of menu levels to render for a dynamic menu.

NamingContainer

Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Унаследовано от Control)
Orientation

Получает или задает направление, в котором обрабатывается элемент управления Menu для отображения.Gets or sets the direction in which to render the Menu control.

Page

Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления.Gets a reference to the Page instance that contains the server control.

(Унаследовано от Control)
Parent

Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы.Gets a reference to the server control's parent control in the page control hierarchy.

(Унаследовано от Control)
PathSeparator

Получает или задает символ, используемый в качестве разделителя пути к пункту меню в элементе управления Menu.Gets or sets the character used to delimit the path of a menu item in a Menu control.

RenderingCompatibility

Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Унаследовано от Control)
RenderingMode

Получает или задает значение, определяющее, преобразует ли для просмотра элемент управления Menu элементы HTML table и встроенные стили или элементы listitem и стили CSS.Gets or sets a value that specifies whether the Menu control renders HTML table elements and inline styles, or listitem elements and cascading style sheet (CSS) styles.

RequiresDataBinding

Получает или задает значение, указывающее, должен ли вызываться метод DataBind().Gets or sets a value indicating whether the DataBind() method should be called.

(Унаследовано от BaseDataBoundControl)
ScrollDownImageUrl

Получает или задает URL-адрес изображения, отображаемого в динамическом меню и указывающего на то, что пользователь может воспользоваться прокруткой вниз для просмотра дополнительных пунктов меню.Gets or sets the URL to an image displayed in a dynamic menu to indicate that the user can scroll down for additional menu items.

ScrollDownText

Получает или задает альтернативный текст для изображения, указанного в свойстве ScrollDownImageUrl.Gets or sets the alternate text for the image specified in the ScrollDownImageUrl property.

ScrollUpImageUrl

Получает или задает URL-адрес изображения, отображаемого в динамическом меню и указывающего на то, что пользователь может воспользоваться прокруткой вверх для просмотра дополнительных пунктов меню.Gets or sets the URL to an image displayed in a dynamic menu to indicate that the user can scroll up for additional menu items.

ScrollUpText

Получает или задает альтернативный текст для изображения, указанного в свойстве ScrollUpImageUrl.Gets or sets the alternate text for the image specified in the ScrollUpImageUrl property.

SelectedItem

Получает выбранный пункт меню.Gets the selected menu item.

SelectedValue

Получает значение выбранного пункта меню.Gets the value of the selected menu item.

Site

Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора.Gets information about the container that hosts the current control when rendered on a design surface.

(Унаследовано от Control)
SkinID

Возвращает или задает обложку, применяемую к элементу управления.Gets or sets the skin to apply to the control.

(Унаследовано от WebControl)
SkipLinkText

Получает или задает альтернативный текст скрытого изображения, считываемого программами чтения с экрана, для предоставления возможности пропуска списка ссылок.Gets or sets the alternate text for a hidden image read by screen readers to provide the ability to skip the list of links.

StaticBottomSeparatorImageUrl

Получает или задает URL-адрес изображения, которое отображается в качестве разделителя под каждым пунктом статического меню.Gets or sets the URL to an image displayed as the separator at the bottom of each static menu item.

StaticDisplayLevels

Получает или задает количество уровней меню, отображаемых в статическом меню.Gets or sets the number of menu levels to display in a static menu.

StaticEnableDefaultPopOutImage

Получает или задает значение, указывающее, будет ли отображаться встроенное изображение, свидетельствующее о том, что в пункте статического меню есть вложенное меню.Gets or sets a value indicating whether the built-in image is displayed to indicate that a static menu item has a submenu.

StaticHoverStyle

Получает ссылку на объект Style, позволяющий задать внешний вид пункта статического меню при наведении на него указателя мыши.Gets a reference to the Style object that allows you to set the appearance of a static menu item when the mouse pointer is positioned over it.

StaticItemFormatString

Получает или задает дополнительный текст, отображаемый вместе со всеми статическими пунктами меню.Gets or sets additional text shown with all menu items that are statically displayed.

StaticItemTemplate

Получает или задает шаблон, содержащий настраиваемое содержимое, преобразовываемое для просмотра в статическом меню.Gets or sets the template that contains the custom content to render for a static menu.

StaticMenuItemStyle

Получает ссылку на объект MenuItemStyle, позволяющий задать внешний вид пунктов статического меню.Gets a reference to the MenuItemStyle object that allows you to set the appearance of the menu items in a static menu.

StaticMenuStyle

Получает ссылку на объект MenuItemStyle, позволяющий задать внешний вид статического меню.Gets a reference to the MenuItemStyle object that allows you to set the appearance of a static menu.

StaticPopOutImageTextFormatString

Получает или задает альтернативный текст для исчезающего изображения, свидетельствующий о том, что в пункте статического меню есть вложенное меню.Gets or sets the alternate text for the pop-out image used to indicate that a static menu item has a submenu.

StaticPopOutImageUrl

Получает или задает URL-адрес изображения, указывающего на наличие вложенного меню в пункте статического меню.Gets or sets the URL to an image displayed to indicate that a static menu item has a submenu.

StaticSelectedStyle

Получает ссылку на объект MenuItemStyle, позволяющий задать внешний вид выбранного пользователем пункта статического меню.Gets a reference to the MenuItemStyle object that allows you to set the appearance of the menu item selected by the user in a static menu.

StaticSubMenuIndent

Получает или задает размер отступа вложенных меню в пикселях в статическом меню.Gets or sets the amount of space, in pixels, to indent submenus within a static menu.

StaticTopSeparatorImageUrl

Получает или задает URL-адрес изображения, которое отображается в качестве разделителя над каждым пунктом статического меню.Gets or sets the URL to an image displayed as the separator at the top of each static menu item.

Style

Возвращает коллекцию атрибутов текста, которые будут отображены в виде атрибута стиля на внешнем теге серверного веб-элемента управления.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Унаследовано от WebControl)
SupportsDisabledAttribute

Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута disabled отрисовываемого элемента HTML значение disabled, если для свойства элемента управления IsEnabled задано значение false.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Унаследовано от BaseDataBoundControl)
TabIndex

Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления.Gets or sets the tab index of the Web server control.

(Унаследовано от WebControl)
TagKey

Получает значение HtmlTextWriterTag, соответствующее элементу управления Menu.Gets the HtmlTextWriterTag value that corresponds to a Menu control. Это свойство используется преимущественно разработчиками элементов управления.This property is used primarily by control developers.

TagName

Возвращает имя тега элемента управления.Gets the name of the control tag. Это свойство используется преимущественно разработчиками элементов управления.This property is used primarily by control developers.

(Унаследовано от WebControl)
Target

Получает или задает целевое окно или фрейм, для отображения содержимого веб-страницы, связанной с пунктом меню.Gets or sets the target window or frame in which to display the Web page content associated with a menu item.

TemplateControl

Возвращает или задает ссылку на шаблон, содержащий этот элемент управления.Gets or sets a reference to the template that contains this control.

(Унаследовано от Control)
TemplateSourceDirectory

Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Унаследовано от Control)
ToolTip

Возвращает или задает текст, который отображается при наведении указателя мыши на серверный веб-элемент управления.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Унаследовано от WebControl)
UniqueID

Возвращает уникальный идентификатор серверного элемента управления в иерархии.Gets the unique, hierarchically qualified identifier for the server control.

(Унаследовано от Control)
ValidateRequestMode

Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Унаследовано от Control)
ViewState

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Унаследовано от Control)
ViewStateIgnoresCase

Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру.Gets a value that indicates whether the StateBag object is case-insensitive.

(Унаследовано от Control)
ViewStateMode

Возвращает или задает режим состояния представления данного элемента управления.Gets or sets the view-state mode of this control.

(Унаследовано от Control)
Visible

Получает или задает значение, указывающее, отрисовывается ли серверный элемент управления как пользовательский интерфейс на странице.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Унаследовано от Control)
Width

Получает или задает ширину серверного веб-элемента управления.Gets or sets the width of the Web server control.

(Унаследовано от WebControl)

Методы

AddAttributesToRender(HtmlTextWriter)

Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном объекте HtmlTextWriter.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter object.

AddedControl(Control, Int32)

Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control.Called after a child control is added to the Controls collection of the Control object.

(Унаследовано от Control)
AddParsedSubObject(Object)

Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Унаследовано от Control)
ApplyStyle(Style)

Копирует любой непустой элемент указанного стиля в элемент управления Веба, перезаписывая уже существующие элементы стиля.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Этот метод, в основном, используется разработчиками элементов управления.This method is primarily used by control developers.

(Унаследовано от WebControl)
ApplyStyleSheetSkin(Page)

Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления.Applies the style properties defined in the page style sheet to the control.

(Унаследовано от Control)
BeginRenderTracing(TextWriter, Object)

Запускает трассировку во время разработки данных отрисовки.Begins design-time tracing of rendering data.

(Унаследовано от Control)
BuildProfileTree(String, Boolean)

Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Унаследовано от Control)
ClearCachedClientID()

Задает для кэшированного свойства ClientID значение null.Sets the cached ClientID value to null.

(Унаследовано от Control)
ClearChildControlState()

Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления.Deletes the control-state information for the server control's child controls.

(Унаследовано от Control)
ClearChildState()

Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления.Deletes the view-state and control-state information for all the server control's child controls.

(Унаследовано от Control)
ClearChildViewState()

Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления.Deletes the view-state information for all the server control's child controls.

(Унаследовано от Control)
ClearEffectiveClientIDMode()

Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Унаследовано от Control)
ConfirmInitState()

Устанавливает исходное состояние элемента управления, присоединенного к данным.Sets the initialized state of the data-bound control.

(Унаследовано от BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Копирует не инкапсулированные объектом Style свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
CreateChildControls()

Создает дочерние элементы управления элемента управления Menu.Creates the child controls of a Menu control.

CreateControlCollection()

Создает новый объект ControlCollection для хранения дочерних элементов управления (литеральных и серверных) серверного элемента управления.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Унаследовано от Control)
CreateControlStyle()

Создает объект стиля, который используется внутри класса WebControl для реализации всех относящихся к стилю свойств.Creates the style object that is used internally by the WebControl class to implement all style related properties. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
DataBind()

Привязывает источник данных к элементу управления Menu.Binds the data source to the Menu control. Наследовать этот метод нельзя.This method cannot be inherited.

DataBind(Boolean)

Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Унаследовано от Control)
DataBindChildren()

Привязывает источник данных к дочерним элементам управления серверного элемента управления.Binds a data source to the server control's child controls.

(Унаследовано от Control)
Dispose()

Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти.Enables a server control to perform final clean up before it is released from memory.

(Унаследовано от Control)
EndRenderTracing(TextWriter, Object)

Завершает трассировку во время разработки данных отрисовки.Ends design-time tracing of rendering data.

(Унаследовано от Control)
EnsureChildControls()

Определяет наличие у серверного элемента управления дочерних элементов управления.Determines whether the server control contains child controls. Если дочерних элементов управления нет, они будут созданы.If it does not, it creates child controls.

(Унаследовано от Control)
EnsureDataBound()

Перед вызовом метода DataBind() проверяет, нужна ли привязка данных для элемента управления меню и задан ли допустимый элемент управления источниками данных.Verifies that the menu control requires data binding and that a valid data source control is specified before calling the DataBind() method.

EnsureID()

Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора.Creates an identifier for controls that do not have an identifier assigned.

(Унаследовано от Control)
Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
FindControl(String)

Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.Searches the current naming container for a server control with the specified id parameter.

(Унаследовано от Control)
FindControl(String, Int32)

Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Эту версию метода FindControl не следует переопределять.You should not override this version of the FindControl method.

(Унаследовано от Control)
FindItem(String)

Извлекает пункт меню по указанному пути к значению.Retrieves the menu item at the specified value path.

Focus()

Задает фокус ввода на элемент управления.Sets input focus to a control.

(Унаследовано от Control)
GetData(String)

Извлекает объект HierarchicalDataSourceView, используемый элементом управления с привязкой к данным для выполнения операций с данными.Retrieves a HierarchicalDataSourceView object that the data-bound control uses to perform data operations.

(Унаследовано от HierarchicalDataBoundControl)
GetDataSource()

Извлекает объект IHierarchicalDataSource, с которым связан элемент управления с привязкой к данным, если он существует.Retrieves the IHierarchicalDataSource that the data-bound control is associated with, if any.

(Унаследовано от HierarchicalDataBoundControl)
GetDesignModeState()

Возвращает состояние элемента управления Menu во время разработки.Retrieves the design-time state of the Menu control.

GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetRouteUrl(Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута.Gets the URL that corresponds to a set of route parameters.

(Унаследовано от Control)
GetRouteUrl(RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута.Gets the URL that corresponds to a set of route parameters.

(Унаследовано от Control)
GetRouteUrl(String, Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута.Gets the URL that corresponds to a set of route parameters and a route name.

(Унаследовано от Control)
GetRouteUrl(String, RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута.Gets the URL that corresponds to a set of route parameters and a route name.

(Унаследовано от Control)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetUniqueIDRelativeTo(Control)

Возвращает часть с префиксом свойства UniqueID указанного элемента управления.Returns the prefixed portion of the UniqueID property of the specified control.

(Унаследовано от Control)
HasControls()

Определяет наличие у серверного элемента управления дочерних элементов управления.Determines if the server control contains any child controls.

(Унаследовано от Control)
HasEvents()

Возвращает значение, указывающее, регистрируются ли события для элемента управления или каких-либо дочерних элементов управления.Returns a value indicating whether events are registered for the control or any child controls.

(Унаследовано от Control)
IsLiteralContent()

Определяет наличие у серверного элемента управления только текстового содержимого.Determines if the server control holds only literal content.

(Унаследовано от Control)
LoadControlState(Object)

Загружает в элемент управления Menu состояние свойств, которые необходимо сохранить.Loads the state of the properties in the Menu control that need to be persisted.

LoadViewState(Object)

Загружает предварительно сохраненное состояние представления элемента управления Menu.Loads the previously saved view state of the Menu control.

MapPathSecure(String)

Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный).Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Унаследовано от Control)
MarkAsDataBound()

Задает в данных о состоянии представления состояние элемента управления, соответствующее успешной привязке к данным.Sets the state of the control in view state as successfully bound to data.

(Унаследовано от HierarchicalDataBoundControl)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MergeStyle(Style)

Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
OnBubbleEvent(Object, EventArgs)

Определяет, передается ли событие элемента управления Menu вверх по иерархии серверных элементов управления пользовательского интерфейса страницы.Determines whether the event for the Menu control is passed up the page's user interface (UI) server control hierarchy.

OnDataBinding(EventArgs)

Вызывает событие DataBinding.Raises the DataBinding event.

OnDataBound(EventArgs)

Создает событие DataBound.Raises the DataBound event.

(Унаследовано от BaseDataBoundControl)
OnDataPropertyChanged()

Вызывается при изменении одного из свойств определения базового источника данных, чтобы повторно привязать элемент управления с привязкой к данным к его данным.Called when one of the base data source identification properties is changed, to re-bind the data-bound control to its data.

(Унаследовано от HierarchicalDataBoundControl)
OnDataSourceChanged(Object, EventArgs)

Вызывается, когда экземпляр IHierarchicalDataSource, с которым работает элемент управления с привязкой к данным, вызывает событие DataSourceChanged.Called when the IHierarchicalDataSource instance that the data-bound control works with raises the DataSourceChanged event.

(Унаследовано от HierarchicalDataBoundControl)
OnInit(EventArgs)

Создает событие Init.Raises the Init event.

OnLoad(EventArgs)

Обрабатывает событие Load.Handles the Load event.

(Унаследовано от HierarchicalDataBoundControl)
OnMenuItemClick(MenuEventArgs)

Вызывает событие MenuItemClick.Raises the MenuItemClick event.

OnMenuItemDataBound(MenuEventArgs)

Создает событие MenuItemDataBound.Raises the MenuItemDataBound event.

OnPagePreLoad(Object, EventArgs)

Устанавливает исходное состояние элемента управления, привязанного к данным, перед его загрузкой.Sets the initialized state of the data-bound control before the control is loaded.

(Унаследовано от HierarchicalDataBoundControl)
OnPreRender(EventArgs)

Вызывает событие PreRender.Raises the PreRender event.

OnUnload(EventArgs)

Создает событие Unload.Raises the Unload event.

(Унаследовано от Control)
OpenFile(String)

Возвращает Stream, используемое для чтения файла.Gets a Stream used to read a file.

(Унаследовано от Control)
PerformDataBinding()

Привязывает элементы из источника данных к пунктам меню в элементе управления Menu.Binds the items from the data source to the menu items in the Menu control.

PerformSelect()

Извлекает данные из связанного источника данных.Retrieves data from the associated data source.

(Унаследовано от HierarchicalDataBoundControl)
RaiseBubbleEvent(Object, EventArgs)

Присваивает родительскому элементу управления все источники события и сведения о них.Assigns any sources of the event and its information to the control's parent.

(Унаследовано от Control)
RaisePostBackEvent(String)

Обрабатывает вызванное событие при передаче страницы на сервер.Processes an event raised when a form is posted to the server.

RemovedControl(Control)

Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control.Called after a child control is removed from the Controls collection of the Control object.

(Унаследовано от Control)
Render(HtmlTextWriter)

Выполняет преобразование для просмотра элемента управления меню в браузере клиентского компьютера.Renders the menu control on the client browser.

RenderBeginTag(HtmlTextWriter)

Добавляет атрибуты тега и записывает разметку для открывающего тега элемента управления в поток вывода, передаваемый в браузер или устройство.Adds tag attributes and writes the markup for the opening tag of the control to the output stream emitted to the browser or device.

RenderChildren(HtmlTextWriter)

Отправляет содержимое дочернего серверного элемента управления указанному объекту HtmlTextWriter, который записывает содержимое для преобразования на стороне клиента.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Унаследовано от Control)
RenderContents(HtmlTextWriter)

Этот элемент переопределяет метод RenderContents(HtmlTextWriter).This member overrides RenderContents(HtmlTextWriter).

RenderControl(HtmlTextWriter)

Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Унаследовано от Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Унаследовано от Control)
RenderEndTag(HtmlTextWriter)

Выполняет окончательную разметку и записывает закрывающий HTML-тег элемента управления в поток вывода, передаваемый в браузер или устройство.Performs final markup and writes the HTML closing tag of the control to the output stream emitted to the browser or device.

ResolveAdapter()

Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления.Gets the control adapter responsible for rendering the specified control.

(Унаследовано от Control)
ResolveClientUrl(String)

Возвращает URL-адрес, который может использоваться браузером.Gets a URL that can be used by the browser.

(Унаследовано от Control)
ResolveUrl(String)

Преобразует URL-адрес в адрес, доступный для клиента.Converts a URL into one that is usable on the requesting client.

(Унаследовано от Control)
SaveControlState()

Сохраняет состояние свойств в элементе управления Menu, который необходимо сохранить.Saves the state of the properties in the Menu control that need to be persisted.

SaveViewState()

Сохраняет состояние элемента управления Menu.Saves the state of the Menu control.

SetDesignModeState(IDictionary)

Задает данные времени разработки для элемента управления Menu.Sets design-time data for the Menu control.

SetItemDataBound(MenuItem, Boolean)

Присваивает свойству DataBound указанного объекта MenuItem заданное значение.Sets the DataBound property of the specified MenuItem object with the specified value.

SetItemDataItem(MenuItem, Object)

Присваивает свойству DataItem указанного объекта MenuItem заданное значение.Sets the DataItem property of the specified MenuItem object with the specified value.

SetItemDataPath(MenuItem, String)

Присваивает свойству DataPath указанного объекта MenuItem заданное значение.Sets the DataPath property of the specified MenuItem object with the specified value.

SetRenderMethodDelegate(RenderMethod)

Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления.Assigns an event handler delegate to render the server control and its content into its parent control.

(Унаследовано от Control)
SetTraceData(Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Унаследовано от Control)
SetTraceData(Object, Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Унаследовано от Control)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
TrackViewState()

Отслеживает изменения состояния представления элемента управления Menu для сохранения в объекте элемента управления StateBag.Tracks view-state changes to the Menu control so they can be stored in the control's StateBag object. Этот объект доступен с помощью свойства ViewState.This object is accessible through the ViewState property.

ValidateDataSource(Object)

Проверяет, может ли элемент управления с привязкой к данным, привязываемый к объекту, работать с этим объектом.Verifies that the object a data-bound control binds to is one it can work with.

(Унаследовано от HierarchicalDataBoundControl)

События

DataBinding

Происходит при привязке серверного элемента управления к источнику данных.Occurs when the server control binds to a data source.

(Унаследовано от Control)
DataBound

Происходит после привязки серверного элемента управления к источнику данных.Occurs after the server control binds to a data source.

(Унаследовано от BaseDataBoundControl)
Disposed

Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Унаследовано от Control)
Init

Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Унаследовано от Control)
Load

Происходит при загрузке серверного элемента управления в объект Page.Occurs when the server control is loaded into the Page object.

(Унаследовано от Control)
MenuItemClick

Происходит при выборе пункта меню в элементе управления Menu.Occurs when a menu item in a Menu control is clicked.

MenuItemDataBound

Происходит, если пункт меню в элементе управления Menu привязан к данным.Occurs when a menu item in a Menu control is bound to data.

PreRender

Происходит после загрузки объекта Control, но перед отрисовкой.Occurs after the Control object is loaded but prior to rendering.

(Унаследовано от Control)
Unload

Происходит при выгрузке серверного элемента управления из памяти.Occurs when the server control is unloaded from memory.

(Унаследовано от Control)

Явные реализации интерфейса

IAttributeAccessor.GetAttribute(String)

Возвращает атрибуту веб-элемента управления указанное имя.Gets an attribute of the Web control with the specified name.

(Унаследовано от WebControl)
IAttributeAccessor.SetAttribute(String, String)

Задает атрибуту веб-элемента управления указанное имя и значение.Sets an attribute of the Web control to the specified name and value.

(Унаследовано от WebControl)
IControlBuilderAccessor.ControlBuilder

Описание этого члена см. в разделе ControlBuilder.For a description of this member, see ControlBuilder.

(Унаследовано от Control)
IControlDesignerAccessor.GetDesignModeState()

Описание этого члена см. в разделе GetDesignModeState().For a description of this member, see GetDesignModeState().

(Унаследовано от Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Описание этого члена см. в разделе SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Унаследовано от Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Описание этого члена см. в разделе SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Унаследовано от Control)
IControlDesignerAccessor.UserData

Описание этого члена см. в разделе UserData.For a description of this member, see UserData.

(Унаследовано от Control)
IDataBindingsAccessor.DataBindings

Описание этого члена см. в разделе DataBindings.For a description of this member, see DataBindings.

(Унаследовано от Control)
IDataBindingsAccessor.HasDataBindings

Описание этого члена см. в разделе HasDataBindings.For a description of this member, see HasDataBindings.

(Унаследовано от Control)
IExpressionsAccessor.Expressions

Описание этого члена см. в разделе Expressions.For a description of this member, see Expressions.

(Унаследовано от Control)
IExpressionsAccessor.HasExpressions

Описание этого члена см. в разделе HasExpressions.For a description of this member, see HasExpressions.

(Унаследовано от Control)
IParserAccessor.AddParsedSubObject(Object)

Описание этого члена см. в разделе AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Унаследовано от Control)
IPostBackEventHandler.RaisePostBackEvent(String)

Обрабатывает вызванное событие при передаче страницы на сервер.Processes an event raised when a form is posted to the server.

Методы расширения

EnablePersistedSelection(BaseDataBoundControl)

Включает возможность сохранения в элементах управления данными, поддерживающих выделение и разбиение по страницам.Enables selection to be persisted in data controls that support selection and paging.

FindDataSourceControl(Control)

Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Возвращает объект метатаблицы для контейнерного элемента управления данными.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

Получает коллекцию значений по умолчанию для заданного элемента управления данными.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Получает метаданные таблицы для заданного элемента управления данными.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Задает метаданные таблицы для заданного элемента управления данными.Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Определяет, доступны ли метаданные таблицы.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

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

Дополнительно