MenuItemBinding.Target 속성

정의

MenuItemBinding 개체가 적용된 메뉴 항목에 연결된 웹 페이지 내용을 표시할 대상 창이나 프레임을 가져오거나 설정합니다.Gets or sets the target window or frame in which to display the Web page content associated with a menu item to which the MenuItemBinding object is applied.

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

속성 값

연결된 웹 페이지 콘텐츠를 표시할 대상 창이나 프레임입니다.The target window or frame in which to display the linked Web page content. 기본값은 빈 문자열("")이며 이 경우 포커스가 있는 창이나 프레임이 새로 고쳐집니다.The default value is an empty string (""), which refreshes the window or frame with focus.

예제

다음 코드 예제를 사용 하는 방법에 설명 합니다 Target 속성을 해당 메뉴 항목을 클릭할 때 메뉴 항목을 연결 된 웹 콘텐츠를 표시 하는 기간을 지정 합니다.The following code example demonstrates how to use the Target property to specify the window in which to display the Web content associated with a menu item, when that menu item is clicked. 제대로 작동 하려면이 예제에서는 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 데이터 원본에 바인딩된 컨트롤을 사용 합니다 Target 속성 창이 나 프레임을 표시할 웹 콘텐츠를 지정 하는 메뉴 항목을 클릭할 때 메뉴 항목에 연결 합니다.When the Menu control is bound to a data source, use the Target property to specify the window or frame in which to display the Web content linked to a menu item when that menu item is clicked.

참고

이 속성을 재정의 하는 설정을 Menu.Target 의 속성을 Menu 는 메뉴 항목에 대 한 제어를 MenuItemBinding 개체가 적용 된.Setting this property overrides the Menu.Target property of the Menu control for the menu items to which the MenuItemBinding object is applied. 이 속성을 설정 하 여 선택적으로 재정의할 수 있습니다는 MenuItem.Target 직접 각 메뉴 항목의 속성입니다.You can selectively override this property by setting the MenuItem.Target property of each menu item directly.

대상 값의 범위의 A ~ Z (대/소문자 구분)를 표에 표시 된 것과 같이 밑줄로 시작 하는 특수 한 값을 제외 하 고 문자로 시작 해야 합니다.Target values must begin with a letter in the range of A through Z (case-insensitive), except for certain special values that begin with an underscore, as shown in the following table.

대상 값Target value DescriptionDescription
_blank 콘텐츠를 프레임이 없는 새 창에 렌더링합니다.Renders the content in a new window without frames.
_parent 콘텐츠를 직접 실행 프레임셋 부모에 렌더링합니다.Renders the content in the immediate frameset parent.
_search 콘텐츠를 검색 창에 렌더링합니다.Renders the content in the search pane.
_self 콘텐츠를 포커스가 있는 프레임에 렌더링합니다.Renders the content in the frame with focus.
_top 콘텐츠를 프레임이 없는 전체 창에 렌더링합니다.Renders the content in the full window without frames.

참고

_search 값이 지원되는지 여부를 확인하려면 브라우저 설명서를 참조하십시오.Check your browser documentation to determine if the _search value is supported. 예를 들어, Microsoft Internet Explorer 5.0 이상에서는 _search 대상 값을 지원합니다.For example, Microsoft Internet Explorer 5.0 and later support the _search target value.

참고

합니다 Target 속성으로 렌더링 한 target 특성입니다.The Target property renders as a target attribute. 합니다 target 특성을 anchor 요소 XHTML 1.1 문서 종류 정의에서 허용 되지 않습니다.The target attribute on anchor elements is not allowed in the XHTML 1.1 document type definition. 설정 하지 마십시오는 Target 속성 경우 렌더링된 된 출력에 대 한는 MenuItemBinding 개체 XHTML 1.1 규격 이어야 합니다.Do not set the Target property if the rendered output for the MenuItemBinding object must be XHTML 1.1 compliant. 자세한 내용은 항목을 참조 XHTML 표준 Visual Studio 및 ASP.NET에입니다.For more information, refer to the topic XHTML Standards in Visual Studio and ASP.NET.

액세스할 수 있는 웹 페이지를 만들 때이 가장 좋습니다 사용 하지 마십시오는 Target 다른 창을 대상으로 하는 속성입니다.When creating accessible Web pages, it is strongly recommended you avoid using the Target property to target another window. 자세한 내용은 ASP.NET Accessibility를 참조 하세요.For more information, see ASP.NET Accessibility.

적용 대상

추가 정보