Gewusst wie: Anpassen der Darstellung von SiteMapPath-Webserversteuerelementen

Aktualisiert: November 2007

Die visuelle Darstellung von Sitenavigationssteuerelementen kann entweder durch Festlegen der Attribute oder durch Konfiguration der für das Steuerelement verfügbaren Vorlagen angepasst werden. Auf Links werden Vorlagen und Formate anhand zweier Vorrangsregeln angewendet, die im Abschnitt "Hinweise" von SiteMapPath dargestellt werden.

Alternativ können Sie ein Design oder ein Steuerelementdesign auf das Steuerelement anwenden oder benutzerdefinierte Sitenavigationssteuerelemente entwickeln, die Ihren Darstellungsanforderungen entsprechen. Weitere Informationen über das Anwenden von Designs auf Websteuerelemente finden Sie unter Gewusst wie: Anpassen des ASP.NET-CreateUserWizard-Steuerelements.

Das SiteMapPath-Steuerelement zeigt einen Navigationspfad an (auch Breadcrumb oder Eyebrow genannt), der Links als Pfad von der aktuellen Seite zurück zur Startseite der Website anzeigt. Auf einer ASP.NET-Seite zeigt das SiteMapPath-Steuerelement in etwa Folgendes an:

Startseite > Dienste > Training

Das TreeView-Steuerelement und das Menu-Steuerelement stellen ebenfalls Siteübersichtsdaten dar und können, ähnlich dem SiteMapPath-Steuerelement, wie die meisten anderen Websteuerelemente angepasst werden. In diesem Thema wird die Verwendung der folgenden Anpassungsfunktionen des SiteMapPath-Webserversteuerelements beschrieben:

• Angeben von Zeichen oder Bildern, die zwischen den Links angezeigt werden sollen.

• Umkehren der Navigationspfadrichtung.

• Angeben der Anzahl von übergeordneten Links, die angezeigt werden sollen.

Bei den Verfahrensweisen in diesem Thema wird davon ausgegangen, dass Sie bereits eine Siteübersicht sowie eine Seite mit einem SiteMapPath-Steuerelement erstellt haben. Sie können die Beispieldatei Web.sitemap aus ASP.NET-Siteübersichten verwenden.

So passen Sie die Formateigenschaften von Links an

1. Fügen Sie in einer ASP.NET-Webseite, die ein SiteMapPath-Steuerelement enthält, dem Steuerelement die folgenden Eigenschaften hinzu:

   RootNodeStyle-Font-Names="Verdana"
   RootNodeStyle-ForeColor="Orange"
   RootNodeStyle-BorderWidth=2
   

   Der Code für das SiteMapPath-Steuerelement könnte beispielsweise wie folgt aussehen:

   <asp:SiteMapPath ID="SiteMapPath1" Runat="server" 
     SkipLinkText="Skip Menu"
     RootNodeStyle-Font-Names="Verdana"
     RootNodeStyle-ForeColor="Orange"
     RootNodeStyle-BorderWidth=2 >
   </asp:SiteMapPath>
   

   Die meisten Eigenschaften der Style-Klasse und der FontInfo-Klasse stehen zur Verfügung, einschließlich der CssClass-Eigenschaft.

2. Wenn das Format für jeden Link unterschiedlich sein soll, wiederholen Sie den obigen Schritt mit den Eigenschaften ParentNodeStyle, CurrentNodeStyle und PathSeperatorStyle des SiteMapPath-Steuerelements.

   Hinweis:
   Zur Verbesserung der Leistung können Sie mithilfe von NodeTemplate das Format aller Links gleichzeitig anpassen. Weitere Informationen finden Sie unter Vorlagen für ASP.NET-Webserver-Steuerelemente.

So passen Sie das Zeichen an, das zwischen den Links anzeigt wird

• Fügen Sie in einer ASP.NET-Webseite, die ein SiteMapPath-Steuerelement enthält, dem Steuerelement die PathSeparator-Eigenschaft hinzu.

  Der Code für das SiteMapPath-Steuerelement könnte beispielsweise wie folgt aussehen:

  <asp:SiteMapPath ID="SiteMapPath1" Runat="server" 
    PathSeparator=" :: ">
  </asp:SiteMapPath>
  

  Das SiteMapPath-Steuerelement zeigt in etwa Folgendes an:

  Startseite :: Dienste :: Training

  Sie können die Links mit einer beliebigen Zeichenfolge voneinander trennen. Wenn Sie jedoch ein Bild dazu verwenden möchten, führen Sie die folgenden Schritte aus.

So geben Sie ein Bild an, das zwischen den Links anzeigt wird

• Fügen Sie in einer ASP.NET-Webseite, die ein SiteMapPath-Steuerelement enthält, dem Steuerelement die folgenden Codezeilen hinzu:

  <PathSeparatorTemplate>
    <asp:Image ID="Image1" Runat="Server" 
      Width="20" 
      ImageUrl="Images/PathSeparatorImage.jpg" />
    </PathSeparatorTemplate>
  </PathSeparatorTemplate>
  

  Der Code für das SiteMapPath-Steuerelement könnte beispielsweise wie folgt aussehen:

  <asp:SiteMapPath ID="SiteMapPath1" Runat="server" >
    <PathSeparatorTemplate>
      <asp:Image ID="Image1" Runat="Server" 
        Width="20" 
        ImageUrl="Images/PathSeparatorImage.jpg" />
      </PathSeparatorTemplate>
    </PathSeparatorTemplate>
  </asp:SiteMapPath>
  

So kehren Sie die Richtung des Pfades um, der vom SiteMapPath-Steuerelement angezeigt wird

• Fügen Sie in einer ASP.NET-Webseite, die ein SiteMapPath-Steuerelement enthält, dem Steuerelement PathDirection und PathSeparator hinzu.

  Der Code für das SiteMapPath-Steuerelement könnte beispielsweise wie folgt aussehen:

  <asp:SiteMapPath ID="SiteMapPath1" Runat="server"
    PathDirection="CurrentToRoot"
    PathSeparator=" <-- " >
  </asp:SiteMapPath>
  

So begrenzen Sie die Anzahl der angezeigten übergeordneten Links

• Fügen Sie in einer ASP.NET-Webseite, die ein SiteMapPath-Steuerelement enthält, dem Steuerelement die ParentLevelsDisplayed-Eigenschaft hinzu.

  Der Code für ein SiteMapPath-Steuerelement, das maximal zwei übergeordnete Links anzeigt, könnte beispielsweise wie folgt aussehen:

  <asp:SiteMapPath ID="SiteMapPath1" Runat="server"
    ParentLevelsDisplayed="2" >
  </asp:SiteMapPath>
  

Eingabehilfen

Typischerweise werden auf jeder Seite einer Website Sitenavigationssteuerelemente verwendet. Programme mit Bildschirmsprachausgabe und andere Hilfsmittel lesen beim Besuch einer Seite und beim Postback den Text eines Navigationssteuerelements laut vor.

Die Sitenavigationssteuerelemente SiteMapPath, TreeView und Menu verfügen jeweils über eine Eigenschaft mit dem Namen SkipLinkText, mit der wiederholte Informationen auf folgenden Seiten oder bei wiederholter Darstellung derselben Seite übersprungen werden können.

So verwenden Sie das Übersprungsfeature für Eingabehilfen

• Fügen Sie in einer ASP.NET-Webseite, die ein Navigationssteuerelement enthält, dem Steuerelement die folgende Steuerelementeigenschaft hinzu:

  SkipLinkText="Skipped Menu"
  

  Der Code für das SiteMapPath-Steuerelement könnte beispielsweise wie folgt aussehen:

  <asp:SiteMapPath ID="SiteMapPath1" 
    Runat="server" 
    SkipLinkText="Skip Breadcrumb">
  </asp:SiteMapPath>
  

Siehe auch

Aufgaben

Gewusst wie: Anpassen des ASP.NET-CreateUserWizard-Steuerelements

Konzepte

Übersicht über die ASP.NET-Sitenavigation

Vorlagen für ASP.NET-Webserver-Steuerelemente

Übersicht über das SiteMapPath-Webserversteuerelement

Anpassen von Aussehen und Verhalten des TreeView-Webserversteuerelements

Sichern der ASP.NET-Sitenavigation

Sichern des Datenzugriffs

Weitere Ressourcen

ASP.NET-Anwendungssicherheit in Hostumgebungen