Freigeben über


Gewusst wie: Implementieren von ASP.NET-Siteübersichtsanbietern

Aktualisiert: November 2007

In diesem Thema wird beschrieben, wie Sie ASP.NET-Siteübersichtsanbieter erstellen und eine ASP.NET-Anwendung so konfigurieren, dass sie einen Siteübersichtsanbieter verwendet.

In der folgenden Tabelle sind verwandte Themen aufgeführt, die auch den Code für zwei Siteübersichtsanbieter in Visual Basic und C# enthalten. Einer der Beispielanbieter verwendet den .NET Framework-Datenanbieter für ODBC, um sich mit einer ODBC-Datenquelle zu verbinden. Im anderen Beispiel wird eine Microsoft Access-Datenbank als Datenquelle verwendet.

Beispiel für einen Text-Siteübersichtsanbieter

Veranschaulicht einen vollständig textbasierten Siteübersichtsanbieter.

Beispiel für einen Access-Siteübersichtsanbieter

Veranschaulicht einen vollständig Access-basierten Siteübersichtsanbieter.

So erstellen Sie einen Siteübersichtsanbieter

  • Fügen Sie den Quellcode im Verzeichnis App_Code Ihrer Anwendung ein.

    Hinweis:

    Wenn sich bereits Quellcode im Verzeichnis App_Code der Anwendung befindet, müssen Sie eine Version des Siteübersichtsanbieters hinzufügen, die in derselben Sprache geschrieben ist wie der bereits vorhandene Code.

    Der Anbieter wird von ASP.NET kompiliert, wenn die Anwendung angefordert wird. Weitere Informationen hierzu finden Sie unter Ordner für freigegebenen Code in ASP.NET-Websites.

    – oder –

    Sie können den Siteübersichtsanbieter auch als Bibliothek kompilieren und ins Verzeichnis Bin Ihrer Webanwendung einfügen bzw. ihn stark benennen und in den globalen Assemblycache einfügen. Der folgende Befehl zeigt beispielsweise, wie Sie einen Beispiel-Siteübersichtsanbieter mit dem Befehlszeilencompiler kompilieren können.

    vbc /out:<example_name>.dll /t:library <example_name>.vb /r:System.Web.dll /r:System.Configuration.dll
    
    csc /out:<example_name>.dll /t:library <example_name>.cs /r:System.Web.dll /r:System.Configuration.dll
    

So verwenden Sie den Siteübersichtsanbieter in einer ASP.NET-Anwendung

  1. Konfigurieren Sie Ihre Webanwendung für die Verwendung des Siteübersichtsanbieters, und fügen Sie der Datei Web.config den Anbieter hinzu.

  2. Fügen Sie Steuerelemente hinzu, die den Siteübersichtsanbieter verwenden. Nachdem die Datei Web.config geändert und der Anbieter kompiliert wurde, lädt der Anbieter die Navigationsdaten in die im Speicher befindliche Instanz der SiteMap-Klasse. Nun können die Navigationsdaten von Komponenten der Siteübersichtsinfrastruktur zur Anzeige der Siteübersichtsinformationen für die Benutzer verwendet werden – beispielsweise von den Steuerelementen SiteMapPath, TreeView und Menu. Im folgenden Beispielcode werden alle diese drei Steuerelemente in einer ASP.NET-Seite verwendet.

    <%@ Page Language="VB" %>
    
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    
    <script >
    
    </script>
    
    <html xmlns="http://www.w3.org/1999/xhtml" >
    <head id="Head1" >
      <title>Simple Navigation Controls</title>
    </head>
    <body>
      <form id="form1" >
      <div>
    
      <h2>Using SiteMapPath</h2>
      <asp:SiteMapPath ID="SiteMapPath1" Runat="server">
      </asp:SiteMapPath>
    
    
      <asp:SiteMapDataSource ID="SiteMapDataSource1" Runat="server" />
    
      <h2>Using TreeView</h2>
      <asp:TreeView ID="TreeView1" Runat="Server" DataSourceID="SiteMapDataSource1">
      </asp:TreeView>
    
      <h2>Using Menu</h2>
      <asp:Menu ID="Menu2" Runat="server" DataSourceID="SiteMapDataSource1">
      </asp:Menu>
    
      <h2>Using a Horizontal Menu</h2>
      <asp:Menu ID="Menu1" Runat="server" DataSourceID="SiteMapDataSource1"
        Orientation="Horizontal" 
        StaticDisplayLevels="2" >
      </asp:Menu>
    
      </div>
      </form>
    </body>
    </html>
    
    <%@ Page Language="C#" %>
    
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    
    <script >
    </script>
    
    <html xmlns="http://www.w3.org/1999/xhtml" >
    <head >
      <title>Simple Navigation Controls</title>
    </head>
    <body>
      <form id="form1" >
      <div>
    
      <h2>Using SiteMapPath</h2>
      <asp:SiteMapPath ID="SiteMapPath1" Runat="server">
      </asp:SiteMapPath>
    
    
      <asp:SiteMapDataSource ID="SiteMapDataSource1" Runat="server" />
    
      <h2>Using TreeView</h2>
      <asp:TreeView ID="TreeView1" Runat="Server" DataSourceID="SiteMapDataSource1">
      </asp:TreeView>
    
      <h2>Using Menu</h2>
      <asp:Menu ID="Menu2" Runat="server" DataSourceID="SiteMapDataSource1">
      </asp:Menu>
    
      <h2>Using a Horizontal Menu</h2>
      <asp:Menu ID="Menu1" Runat="server" DataSourceID="SiteMapDataSource1"
        Orientation="Horizontal" 
        StaticDisplayLevels="2" >
      </asp:Menu>
    
      </div>
      </form>
    </body>
    </html>
    

Siehe auch

Konzepte

Implementieren von ASP.NET-Siteübersichtsanbietern

Übersicht über die ASP.NET-Sitenavigation

Sichern der ASP.NET-Sitenavigation

Sichern des Datenzugriffs

Weitere Ressourcen

ASP.NET-Anwendungssicherheit in Hostumgebungen