SiteMapPath.NodeTemplate Property

Definition

Ruft eine Steuerelementvorlage ab bzw. legt eine Steuerelementvorlage fest, die für alle funktionalen Knoten eines Sitenavigationspfades verwendet werden soll.Gets or sets a control template to use for all functional nodes of a site navigation path.

public:
 virtual property System::Web::UI::ITemplate ^ NodeTemplate { System::Web::UI::ITemplate ^ get(); void set(System::Web::UI::ITemplate ^ value); };
[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.SiteMapNodeItem))]
public virtual System.Web.UI.ITemplate NodeTemplate { get; set; }
member this.NodeTemplate : System.Web.UI.ITemplate with get, set
Public Overridable Property NodeTemplate As ITemplate

Property Value

ITemplate

Ein ITemplate-Objekt, das die InstantiateIn(Control)-Methode implementiert, um benutzerdefinierten Inhalt für jeden Knoten eines Navigationspfades zu rendern.An ITemplate object that implements the InstantiateIn(Control) method, to render custom content for each node of a navigation path.

Attributes

Examples

Im folgenden Codebeispiel wird veranschaulicht, wie eine NodeTemplate, wenn eine angegeben ist, die für alle Knoten definierten Stile überschreibt, einschließlich spezieller Stile für den Stamm Knoten und den aktuellen Knoten.The following code example demonstrates how a NodeTemplate, when one is specified, overrides styles defined for all nodes, including special styles for the root node and current node.

Important

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see Script Exploits Overview.

<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="Form1" runat="server">

            <!-- The following example demonstrates some of the orders
                 of precedence when applying styles and templates to
                 functional nodes of a SiteMapPath.

                 A NodeStyle, RootNodeStyle, and CurrentNodeStyle are
                 all defined. However, so is a NodeTemplate. The template
                 is applied to all nodes, and the styles ignored. -->

            <asp:SiteMapPath ID="SiteMapPath1" runat="server"
                RenderCurrentNodeAsLink="true"
                NodeStyle-Font-Names="Franklin Gothic Medium"
                NodeStyle-Font-Underline="true"
                NodeStyle-Font-Bold="true"
                RootNodeStyle-Font-Names="Symbol"
                RootNodeStyle-Font-Bold="false"
                CurrentNodeStyle-Font-Names="Verdana"
                CurrentNodeStyle-Font-Size="10pt"
                CurrentNodeStyle-Font-Bold="true"
                CurrentNodeStyle-ForeColor="red"
                CurrentNodeStyle-Font-Underline="false">
                <NODETEMPLATE>
                        <asp:CheckBox id="CheckBox1" runat="server" Checked="true" />
                        <asp:TextBox id="TextBox1" runat="server" Text="Declarative template" />
                </NODETEMPLATE>
            </asp:SiteMapPath>


        </form>
    </body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="Form1" runat="server">

            <!-- The following example demonstrates some of the orders
                 of precedence when applying styles and templates to
                 functional nodes of a SiteMapPath.

                 A NodeStyle, RootNodeStyle, and CurrentNodeStyle are
                 all defined. However, so is a NodeTemplate. The template
                 is applied to all nodes, and the styles ignored. -->

            <asp:SiteMapPath ID="SiteMapPath1" runat="server"
                RenderCurrentNodeAsLink="true"
                NodeStyle-Font-Names="Franklin Gothic Medium"
                NodeStyle-Font-Underline="true"
                NodeStyle-Font-Bold="true"
                RootNodeStyle-Font-Names="Symbol"
                RootNodeStyle-Font-Bold="false"
                CurrentNodeStyle-Font-Names="Verdana"
                CurrentNodeStyle-Font-Size="10pt"
                CurrentNodeStyle-Font-Bold="true"
                CurrentNodeStyle-ForeColor="red"
                CurrentNodeStyle-Font-Underline="false">
                <NODETEMPLATE>
                        <asp:CheckBox id="CheckBox1" runat="server" Checked="true" />
                        <asp:TextBox id="TextBox1" runat="server" Text="Declarative template" />
                </NODETEMPLATE>
            </asp:SiteMapPath>


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

Remarks

Legen Sie den NodeTemplate auf ein ITemplate Objekt fest, um ein Image oder ein anderes Steuerelement, z. b. ein Label, als Benutzeroberflächen Element für alle Navigationspfad Knoten zu verwenden.Set the NodeTemplate to an ITemplate object to use an Image or some other control, such as a Label, as a user interface element for all navigation path nodes.

Wenn die NodeTemplate-Eigenschaft festgelegt ist, überschreibt die Vorlage sowohl den angezeigten Navigations Knoten Text als auch alle darauf angewendeten NodeStyle.If the NodeTemplate property is set, the template overrides both the navigation node text displayed and any NodeStyle applied to it. Wenn für den aktuellen Knoten und den Stamm Knoten ein CurrentNodeTemplate oder RootNodeTemplate festgelegt ist, überschreiben diese Vorlagen den NodeTemplate.For the current and root nodes, if a CurrentNodeTemplate or RootNodeTemplate is set, these templates override the NodeTemplate.

Sie können die NodeTemplate-Eigenschaft deklarativ auf ein beliebiges Webserver Steuerelement festlegen, und die ASP.NET-Infrastruktur führt die erforderlichen Schritte aus, um das Webserver-Steuerelement als ITemplate-Objekt zu wrappen.You can declaratively set the NodeTemplate property to any Web server control, and the ASP.NET infrastructure performs the necessary steps to wrap the Web server control as an ITemplate object. Die ITemplate-Schnittstelle wird jedoch von Webserver Steuerelementen nicht implementiert. Wenn Sie die ITemplate Eigenschaften Programm gesteuert arbeiten, müssen Sie daher einen ITemplate-Wrapper für beliebige Vorlagen Codes schreiben.However, Web server controls do not implement the ITemplate interface; therefore, when you work with the ITemplate properties programmatically, you must write an ITemplate wrapper for any template code. Anschließend wird die RootNodeTemplate-Eigenschaft auf eine Instanz des ITemplate-Wrappers festgelegt.Then, the RootNodeTemplate property is set to an instance of the ITemplate wrapper.

Applies to

See also