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.
Veranschaulicht einen vollständig textbasierten 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
Konfigurieren Sie Ihre Webanwendung für die Verwendung des Siteübersichtsanbieters, und fügen Sie der Datei Web.config den Anbieter hinzu.
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