Udostępnij za pośrednictwem

Menu.Target Właściwość

Definicja

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

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

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

W poniższym przykładzie kodu pokazano, jak za pomocą Target właściwości określić, że zawartość połączona z każdym elementem menu powinna być wyświetlana w nowym oknie, gdy użytkownik kliknie ten element menu.


<%@ 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>Menu Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu Target Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"  
        runat="server">

        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

    </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>Menu Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu Target Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"  
        runat="server">

        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

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

Uwagi

Target Użyj 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. Wartości 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 / Notatka

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

Ta właściwość ma zastosowanie do wszystkich elementów menu w kontrolce Menu . Tę właściwość można selektywnie zastąpić, ustawiając Target właściwość każdego MenuItem obiektu bezpośrednio.

Uwaga / Notatka

Właściwość Target jest renderowana jako atrybut docelowy. Atrybut docelowy elementów kotwicy nie jest dozwolony w ścisłej definicji typu dokumentu XHTML 1.1. Jeśli renderowane dane wyjściowe muszą być zgodne ze standardami XHTML lub ułatwieniami dostępu, nie należy ustawiać Target właściwości . Aby uzyskać więcej informacji, zobacz XHTML Standards in Visual Studio (Standardy XHTML w programie Visual Studio) oraz ASP.NET and accessibility in Visual Studio (Ułatwienia dostępu i ułatwienia dostępu w programie Visual Studio) oraz ASP.NET.

Dotyczy

Zobacz też