SiteMapPath.InitializeItem(SiteMapNodeItem) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Заполняет SiteMapNodeItem, являющийся элементом управления веб-сервера, представляющим SiteMapNode с набором дочерних элементов управления, основывающихся на функции узла и указанных шаблонах и стилях.
protected:
virtual void InitializeItem(System::Web::UI::WebControls::SiteMapNodeItem ^ item);
protected virtual void InitializeItem (System.Web.UI.WebControls.SiteMapNodeItem item);
abstract member InitializeItem : System.Web.UI.WebControls.SiteMapNodeItem -> unit
override this.InitializeItem : System.Web.UI.WebControls.SiteMapNodeItem -> unit
Protected Overridable Sub InitializeItem (item As SiteMapNodeItem)
Параметры
- item
- SiteMapNodeItem
Объект SiteMapNodeItem для инициализации.
Примеры
В следующем примере кода показано, как переопределить InitializeItem метод для добавления функциональных возможностей в элемент управления, производный от SiteMapPath. Этот пример кода является частью более крупного примера, предоставленного SiteMapPath для класса.
// Override the InitializeItem method to add a PathSeparator
// and DropDownList to the current node.
protected override void InitializeItem(SiteMapNodeItem item) {
// The only node that must be handled is the CurrentNode.
if (item.ItemType == SiteMapNodeItemType.Current)
{
HyperLink hLink = new HyperLink();
// No Theming for the HyperLink.
hLink.EnableTheming = false;
// Enable the link of the SiteMapPath is enabled.
hLink.Enabled = this.Enabled;
// Set the properties of the HyperLink to
// match those of the corresponding SiteMapNode.
hLink.NavigateUrl = item.SiteMapNode.Url;
hLink.Text = item.SiteMapNode.Title;
if (ShowToolTips) {
hLink.ToolTip = item.SiteMapNode.Description;
}
// Apply styles or templates to the HyperLink here.
// ...
// ...
// Add the item to the Controls collection.
item.Controls.Add(hLink);
AddDropDownListAfterCurrentNode(item);
}
else {
base.InitializeItem(item);
}
}
' Override the InitializeItem method to add a PathSeparator
' and DropDownList to the current node.
Protected Overrides Sub InitializeItem(item As SiteMapNodeItem)
' The only node that must be handled is the CurrentNode.
If item.ItemType = SiteMapNodeItemType.Current Then
Dim hLink As New HyperLink()
' No Theming for the HyperLink.
hLink.EnableTheming = False
' Enable the link of the SiteMapPath is enabled.
hLink.Enabled = Me.Enabled
' Set the properties of the HyperLink to
' match those of the corresponding SiteMapNode.
hLink.NavigateUrl = item.SiteMapNode.Url
hLink.Text = item.SiteMapNode.Title
If ShowToolTips Then
hLink.ToolTip = item.SiteMapNode.Description
End If
' Apply styles or templates to the HyperLink here.
' ...
' ...
' Add the item to the Controls collection.
item.Controls.Add(hLink)
AddDropDownListAfterCurrentNode(item)
Else
MyBase.InitializeItem(item)
End If
End Sub
Комментарии
Метод InitializeItem определяет функциональный тип узла, представляемого элементом, путем проверки SiteMapNodeItemType, и применяет все шаблоны или стили, определенные для этого типа узла.
SiteMapNodeItem Если имеется Root тип элемента, создается дочерний HyperLink элемент управления, и RootNodeTemplate RootNodeStyle его можно применить. RootNodeTemplate Если он задан, он ITemplate применяется к узлу. Вместо этого RootNodeStyle набор объединяется с любым определенным NodeStyle и примененным. Наконец, если шаблоны или стили не определены, базовый HyperLink элемент управления создается и инициализируется со значениями из узла.
SiteMapNodeItem Если имеется Current тип элемента, Literal создается элемент управления или HyperLink дочерний элемент управления в зависимости от возвращаемого RenderCurrentNodeAsLinkзначения. CurrentNodeTemplate Затем можно применить или CurrentNodeStyle применить его. CurrentNodeTemplate Если он задан, он ITemplate применяется к узлу. CurrentNodeStyle Если он задан, он объединяется с любым определенным NodeStyle и примененным.
SiteMapNodeItem Если имеется Parent тип элемента, создается дочерний HyperLink элемент управления, и NodeTemplate NodeStyle его можно применить. NodeTemplate Если он задан, он ITemplate применяется к узлу. NodeStyle Если он задан, он применяется.
Наконец, если SiteMapNodeItem имеет тип элемента, создается дочерний Literal элемент управления и PathSeparatorTemplate PathSeparatorStyle применяется в соответствии с теми же общими правилами, определенными для Parent типа PathSeparator узла.
Переопределите метод для управления отдельными SiteMapNodeItem объектамиInitializeItem. Если для проектирования класса требуется более широкий контроль над SiteMapNodeItem созданием и добавлением объектов в SiteMapPath элемент управления, переопределите CreateControlHierarchy метод.