SiteMapPath.PathSeparatorTemplate Eigenschaft

Definition

Ruft eine Steuerelementvorlage ab oder legt eine Steuerelementvorlage fest, die für das Pfadtrennzeichen eines Sitenavigationspfades verwendet werden soll.

public:
 virtual property System::Web::UI::ITemplate ^ PathSeparatorTemplate { 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 PathSeparatorTemplate { get; set; }
[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.SiteMapNodeItem))>]
member this.PathSeparatorTemplate : System.Web.UI.ITemplate with get, set
Public Overridable Property PathSeparatorTemplate As ITemplate

Eigenschaftswert

Ein ITemplate-Objekt, das die InstantiateIn(Control)-Methode implementiert, um benutzerdefinierten Inhalt für das Pfadtrennzeichen eines Navigationspfades zu rendern.

Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie Image als deklarativ PathSeparatorTemplate in einem Webformular definiert werden.

<%@ Page language="c#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>About Us</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">
      <asp:SiteMapPath
          runat="server"
          ID="SiteMapPath1"
          RootNodeStyle-Font-Names="Verdana"
          RootNodeStyle-Font-Italic="True"
          RootNodeStyle-ForeColor="Blue"
          CurrentNodeStyle-ForeColor="Red">
          <PATHSEPARATORTEMPLATE>
              <asp:Image id="Image1" runat="server" 
                GenerateEmptyAlternateText="true" 
                ImageUrl="6.jpg"></asp:Image>
          </PATHSEPARATORTEMPLATE>
        </asp:SiteMapPath>
        <h1>About Us</h1>
      <p>This company was founded in 1899, as the demand for widgets grew.</p>
    </form>
  </body>
</html>
<%@ Page language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>About Us</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">
      <asp:SiteMapPath
          runat="server"
          ID="SiteMapPath1"
          RootNodeStyle-Font-Names="Verdana"
          RootNodeStyle-Font-Italic="True"
          RootNodeStyle-ForeColor="Blue"
          CurrentNodeStyle-ForeColor="Red">
          <PATHSEPARATORTEMPLATE>
              <asp:Image id="Image1" runat="server" 
                GenerateEmptyAlternateText="true" 
                ImageUrl="6.jpg"></asp:Image>
          </PATHSEPARATORTEMPLATE>
        </asp:SiteMapPath>
        <h1>About Us</h1>
      <p>This company was founded in 1899, as the demand for widgets grew.</p>
    </form>
  </body>
</html>

Hinweise

Legen Sie auf PathSeparatorTemplate ein ITemplate -Objekt fest, um ein Image oder ein anderes Steuerelement zu verwenden, z. B. ein Label, als Pfadtrennzeichen zwischen Navigationsknoten anstelle der PathSeparator Zeichenfolge.

Wenn die PathSeparatorTemplate -Eigenschaft festgelegt ist, überschreibt die Vorlage sowohl den PathSeparator angezeigten Text als auch alle darauf angewendeten PathSeparatorStyle .

Sie können die PathSeparatorTemplate -Eigenschaft deklarativ auf ein beliebiges Webserversteuerelement festlegen, und die ASP.NET-Infrastruktur führt die erforderlichen Schritte aus, um das Webserversteuerelement in umzuschließen ITemplate. Webserversteuerelemente implementieren die ITemplate -Schnittstelle jedoch nicht. Wenn Sie mit den ITemplate Eigenschaften programmgesteuert arbeiten, müssen Sie daher einen ITemplate Wrapper für jeden Vorlagencode schreiben. Anschließend wird die PathSeparatorTemplate -Eigenschaft auf eine Instanz des ITemplate Wrappers festgelegt.

Gilt für:

Weitere Informationen