SiteMapPath.NodeTemplate Eigenschaft

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

Eigenschaftswert

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.

Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, NodeTemplatewie eine, 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.

Wichtig

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>

Hinweise

Legen Sie auf ein ITemplate -Objekt fest, Image um ein-Steuerelement Labeloder ein anderes Steuerelement, z. b., als Benutzeroberflächen Element für alle Navigationspfad Knoten zu verwenden. NodeTemplateSet 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 NodeStyle als auch alle darauf angewendeten.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 CurrentNodeTemplate ein RootNodeTemplate oder festgelegt ist, überschreiben NodeTemplatediese Vorlagen den.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 ITemplate Webserver-Steuerelement als 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. Webserver Steuerelemente implementieren die ITemplate -Schnittstelle jedoch nicht. Daher müssen Sie beim programmgesteuerten Arbeiten mit den ITemplate Eigenschaften einen ITemplate Wrapper für jeden Vorlagen Code 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 ITemplate des-Wrappers festgelegt.Then, the RootNodeTemplate property is set to an instance of the ITemplate wrapper.

Gilt für:

Siehe auch