MenuItemBinding.ImageUrlField 속성

정의

ImageUrl 개체가 적용된 MenuItem 개체의 MenuItemBinding 속성에 바운딩하기 위해 데이터 소스 필드의 이름을 가져오거나 설정합니다.Gets or sets the name of the field from the data source to bind to the ImageUrl property of a MenuItem object to which the MenuItemBinding object is applied.

public:
 property System::String ^ ImageUrlField { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ImageUrlField { get; set; }
member this.ImageUrlField : string with get, set
Public Property ImageUrlField As String

속성 값

ImageUrl이 적용된 MenuItemMenuItemBinding에 바인딩할 필드의 이름입니다.The name of the field to bind to the ImageUrl of a MenuItem to which the MenuItemBinding is applied. 기본값은 빈 문자열("")로, 이 속성이 설정되어 있지 않음을 나타냅니다.The default is an empty string (""), which indicates that this property is not set.

특성

예제

다음 코드 예제를 사용 하는 방법에 설명 합니다 ImageUrlField 속성에 바인딩할 필드의 이름을 지정 하는 ImageUrl 메뉴 항목의 속성입니다.The following code example demonstrates how to use the ImageUrlField property to specify the name of the field to bind to the ImageUrl property of a menu item. 제대로 작동 하려면이 예제에서는 Menu.xml 라는 파일에 아래 샘플 XML 데이터를 복사 해야 합니다.For this example to work correctly, you must copy the sample XML data below to a file named 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"
            formatstring="({0})" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_self" />
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            formatstring="[{0}]" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            formatstring="<{0}>" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          
        </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"
            formatstring="({0})" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_self" />
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            formatstring="[{0}]" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            formatstring="<{0}>" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          
        </DataBindings>
        
      </asp:menu>

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

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

다음 코드는 이전 예제에 대 한 사이트 맵 데이터 샘플입니다.The following code is sample site map data for the previous example.

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

설명

때를 Menu 컨트롤이 데이터 소스에 바인딩된, 사용 하 여를 ImageUrlField 속성에 바인딩할 필드의 이름을 지정 하는 ImageUrl 의 속성을 MenuItem 개체.When the Menu control is bound to a data source, use the ImageUrlField property to specify the name of the field to bind to the ImageUrl property of a MenuItem object. 렌더링 될 때를 ImageUrl 하려는 각 메뉴 항목의 속성을 MenuItemBinding 개체가 적용 된 필드에서 해당 값을 포함 합니다.When rendered, the ImageUrl property of each menu item to which the MenuItemBinding object is applied contains the corresponding value from the field. 이미지 메뉴 항목의 텍스트 옆에 표시 되 고 클라이언트의 브라우저에서 해당 형식을 지원으로 모든 파일 형식 (.jpg,.gif,.bmp, 및 등)에 있을 수 있습니다.The image is displayed next to a menu item's text and can be in any file format (.jpg, .gif, .bmp, and so on), as long as the client's browser supports that format.

참고

설정 하 여 개별 메뉴 항목에 대 한 이미지를 재정의할 수 해당 ImageUrl 속성을 직접.You can override the image for an individual menu item by setting its ImageUrl property directly.

바인딩 기준에 설정 하 여 먼저 설정 해야 데이터 원본에 여러 테이블이 나 특성이 있으면, 합니다 Depth 속성을 DataMember 속성 또는 둘 다.If the data source contains multiple tables or attributes, you must first establish the binding criteria by setting the Depth property, the DataMember property, or both.

바인딩할이 속성을 사용 하는 대신 합니다 ImageUrl 의 속성을 MenuItem 바인딩할 수 있습니다이 정적 값으로 설정 하 여 필드에 개체를 MenuItemBinding.ImageUrl 속성.Instead of using this property to bind the ImageUrl property of a MenuItem object to a field, you can also bind it to a static value by setting the MenuItemBinding.ImageUrl property. 각 메뉴 항목에 동일한 이미지를 표시할 수 있습니다는 MenuItemBinding 개체 적용 됩니다.This allows you to display the same image in each menu item to which the MenuItemBinding object is applied.

참고

경우는 ImageUrlImageUrlField 속성이 모두 설정의 ImageUrlField 속성이 우선 합니다.If the ImageUrl and ImageUrlField properties are both set, the ImageUrlField property takes precedence.

적용 대상

추가 정보