MenuItemBinding.Target Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia okno docelowe lub ramkę, w której ma być wyświetlana zawartość strony sieci Web skojarzona z elementem menu, do którego MenuItemBinding jest stosowany obiekt.

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

Wartość właściwości

String

Okno docelowe lub ramka, w której ma być wyświetlana połączona zawartość strony sieci Web. Wartość domyślna to pusty ciąg (""), który odświeża okno lub ramkę fokusem.

Przykłady

Poniższy przykład kodu pokazuje, jak za pomocą Target właściwości określić okno, w którym ma być wyświetlana zawartość sieci Web skojarzona z elementem menu, po kliknięciu tego elementu menu. Aby ten przykład działał poprawnie, należy skopiować przykładowe dane XML poniżej do pliku o nazwie 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>

Poniższy kod to przykładowe dane mapy witryny dla poprzedniego przykładu.

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

Uwagi

Gdy kontrolka Menu jest powiązana ze źródłem danych, użyj Target właściwości , aby określić okno lub ramkę, w której ma być wyświetlana zawartość sieci Web połączona z elementem menu po kliknięciu tego elementu menu.

Uwaga

Ustawienie tej właściwości zastępuje Menu.Target właściwość kontrolki Menu dla elementów menu, do których MenuItemBinding zastosowano obiekt. Tę właściwość można selektywnie zastąpić, ustawiając MenuItem.Target właściwość każdego elementu menu bezpośrednio.

Wartości docelowe muszą zaczynać się literą w zakresie od A do Z (bez uwzględniania wielkości liter), z wyjątkiem niektórych wartości specjalnych rozpoczynających się od podkreślenia, jak pokazano w poniższej tabeli.

Wartość docelowa	Opis
`_blank`	Renderuje zawartość w nowym oknie bez ramek.
`_parent`	Renderuje zawartość w obiekcie nadrzędnym natychmiastowego zestawu ramek.
`_search`	Renderuje zawartość w okienku wyszukiwania.
`_self`	Renderuje zawartość w ramce z fokusem.
`_top`	Renderuje zawartość w pełnym oknie bez ramek.

Uwaga

Sprawdź dokumentację przeglądarki, aby określić, czy wartość jest obsługiwana _search . Na przykład program Microsoft Internet Explorer 5.0 lub nowszy obsługuje wartość docelową _search .

Uwaga

Właściwość Target jest renderowana jako target atrybut. Atrybut target elementów anchor nie jest dozwolony w definicji typu dokumentu XHTML 1.1. Nie ustawiaj właściwości, Target jeśli renderowane dane wyjściowe obiektu MenuItemBinding muszą być zgodne ze standardem XHTML 1.1. Aby uzyskać więcej informacji, zapoznaj się z tematem XHTML Standards in Visual Studio and ASP.NET (Standardy XHTML w programie Visual Studio i ASP.NET).

Podczas tworzenia dostępnych stron sieci Web zdecydowanie zaleca się unikanie używania Target właściwości do kierowania innego okna. Aby uzyskać więcej informacji, zobacz ASP.NET Ułatwienia dostępu.

Dotyczy

Udostępnij za pośrednictwem

MenuItemBinding.Target Właściwość

Definicja

Wartość właściwości

Przykłady

Uwagi

Dotyczy

Zobacz też

Dodatkowe zasoby