Teilen über

SiteMapPath.PathSeparatorTemplate Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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

ITemplate

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

Attribute
BrowsableAttribute PersistenceModeAttribute TemplateContainerAttribute

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