Menu.Target Właściwość

  • Odwołanie

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

Poniższy przykład kodu pokazuje, jak za pomocą właściwości określić, że zawartość połączona z Target 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

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

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

Dotyczy

Zobacz też