MenuItemBinding.NavigateUrl Eigenschap

Definitie

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

Hiermee haalt u de URL op waarnaar u een koppeling wilt maken wanneer op een menu-item waarop het MenuItemBinding object wordt toegepast, wordt geklikt.

public:
 property System::String ^ NavigateUrl { System::String ^ get(); void set(System::String ^ value); };
public string NavigateUrl { get; set; }
member this.NavigateUrl : string with get, set
Public Property NavigateUrl As String

Waarde van eigenschap

String

De URL waarnaar u een koppeling wilt maken wanneer op een menu-item waarop de MenuItemBinding toepassing is toegepast, wordt geklikt. De standaardwaarde is een lege tekenreeks (""), die aangeeft dat deze eigenschap niet is ingesteld.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de NavigateUrl eigenschap gebruikt om de URL op te geven waarnaar moet worden genavigeerd wanneer op een menu-item wordt geklikt. Deze URL wordt gebruikt in elk menu-item waarop het MenuItemBinding object wordt toegepast. Als dit voorbeeld correct werkt, moet u de voorbeeld-XML-gegevens hieronder kopiëren naar een bestand met de naam Menu.xml.


<%@ 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>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <databindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            text="Static Title"
            value="Static Description"
            imageurl="~\Images\StaticImage.jpg"
            tooltip="Static ToolTip"/>
          
        </databindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

    </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>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <databindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            text="Static Title"
            value="Static Description"
            imageurl="~\Images\StaticImage.jpg"
            tooltip="Static ToolTip"/>
          
        </databindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

    </form>
  </body>
</html>

De volgende code is voorbeeld van siteoverzichtsgegevens voor het vorige voorbeeld.

<MapHomeNode ImageUrl="~\Images\Home.gif"

Title="Home"

Description="Root Page"

ToolTip="Home Page">

<MapNode ImageUrl="~\Images\Music.gif"

Title="Music"

Description="Music Category"

ToolTip="Music Page">

<MapNode ImageUrl="~\Images\Classical.gif"

Title="Classical"

Description="Classical Section"

ToolTip="Classical Page"/>

<MapNode ImageUrl="~\Images\Rock.gif"

Title="Rock"

Description="Rock Section"

ToolTip="Rock Page"/>

<MapNode ImageUrl="~\Images\Jazz.gif"

Title="Jazz"

Description="Jazz Section"

ToolTip="Jazz Page"/>

</MapNode>

<MapNode ImageUrl="~\Images\Movies.gif"

Title="Movies"

Description="Movies Category"

ToolTip="Movies Page">

<MapNode ImageUrl="~\Images\Action.gif"

Title="Action"

Description="Action Section"

ToolTip="Action Page"/>

<MapNode ImageUrl="~\Images\Drama.gif"

Title="Drama"

Description="Drama Section"

ToolTip="Drama Page"/>

<MapNode ImageUrl="~\Images\Musical.gif"

Title="Musical"

Description="Musical Section"

ToolTip="Musical Page"/>

</MapNode>

</MapHomeNode>

Opmerkingen

Wanneer het Menu besturingselement is gebonden aan een gegevensbron, gebruikt u de NavigateUrl eigenschap om de URL op te geven die moet worden gekoppeld aan de MenuItem.NavigateUrl eigenschap van een MenuItem object. Deze URL wordt gedeeld met alle menu-items waarop het MenuItemBinding object wordt toegepast. Wanneer de gebruiker op het menu-item klikt, wordt de gebruiker naar de opgegeven URL gebracht.

Note

U kunt de URL voor een afzonderlijke menu-item overschrijven door de NavigateUrl eigenschap rechtstreeks in te stellen.

In plaats van deze eigenschap te gebruiken om naar dezelfde URL in elk menu-item te navigeren, kunt u de NavigateUrl eigenschap van een MenuItem object ook binden aan een veld van een gegevensbron door de NavigateUrlField eigenschap in te stellen. Wanneer deze wordt weergegeven, bevat de NavigateUrl eigenschap van elk menu-item waarop het MenuItemBinding object wordt toegepast de bijbehorende waarde uit het veld.

Note

Als de NavigateUrl eigenschappen NavigateUrlField beide zijn ingesteld, heeft de NavigateUrlField eigenschap voorrang.

Van toepassing op

Zie ook