MenuItemBinding.ImageUrl Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die URL für ein Bild ab, das neben dem Text eines Menüelements angezeigt wird, für das das MenuItemBinding-Objekt übernommen wird, oder legt diese fest.

public:
 property System::String ^ ImageUrl { System::String ^ get(); void set(System::String ^ value); };

public string ImageUrl { get; set; }

member this.ImageUrl : string with get, set

Public Property ImageUrl As String

Eigenschaftswert

String

Die URL für ein Bild, das neben dem Text eines Menüelements angezeigt wird, für das das MenuItemBinding übernommen wird. Der Standardwert ist eine leere Zeichenfolge ("") und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ImageUrl -Eigenschaft verwendet wird, um die URL eines Bilds anzugeben, das neben dem Text der Menüelemente angezeigt werden soll. Dieses Bild wird in jedem Menüelement angezeigt, auf das das MenuItemBinding Objekt angewendet wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die folgenden XML-Beispieldaten in eine Datei mit dem Namen Menu.xml kopieren.


<%@ 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>

Der folgende Code sind Beispielwebsiteübersichtsdaten für das vorherige Beispiel.

<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>

Hinweise

Wenn das Menu Steuerelement an eine Datenquelle gebunden ist, verwenden Sie die ImageUrl -Eigenschaft, um die URL eines benutzerdefinierten Bilds anzugeben, das an die MenuItem.ImageUrl Eigenschaft eines MenuItem Objekts gebunden werden soll. Dieses Bild wird für alle MenuItem Objekte freigegeben, auf die das MenuItemBinding Objekt angewendet wird. Das Bild wird neben dem Text eines Menüelements angezeigt und kann ein beliebiges Dateiformat aufweisen (.jpg, .gif, .bmp usw.), sofern der Browser des Clients dieses Format unterstützt.

Hinweis

Sie können das Bild für ein einzelnes Menüelement überschreiben, indem Sie dessen ImageUrl Eigenschaft direkt festlegen.

Anstatt diese Eigenschaft zum Anzeigen desselben Bilds in jedem Menüelement zu verwenden, können Sie die ImageUrlField -Eigenschaft auch verwenden, um die ImageUrl Eigenschaft eines MenuItem Objekts an ein Feld einer Datenquelle zu binden. Beim Rendern enthält die ImageUrl Eigenschaft jedes Menüelements, auf das das MenuItemBinding Objekt angewendet wird, den entsprechenden Wert aus dem Feld.

Hinweis

Wenn die ImageUrl Eigenschaften und ImageUrlField festgelegt sind, hat die ImageUrlField Eigenschaft Vorrang.

Gilt für:

Freigeben über