Udostępnij za pośrednictwem

MenuItem.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ę z fokusem.

Przykłady

W poniższym przykładzie pokazano, jak za pomocą Target właściwości 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.


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

        <items>
          <asp:menuitem navigateurl="Home.aspx"
            target="_self" 
            text="Home">
            <asp:menuitem navigateurl="Music.aspx"
              target="_self"
              text="Music">
              <asp:menuitem navigateurl="Classical.aspx"
                target="_blank" 
                text="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                target="_blank"
                text="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                target="_blank"
                text="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              target="_self"
              text="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                target="_blank"
                text="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                target="_blank"
                text="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                target="_blank"
                text="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>MenuItem Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Target Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="1"
        staticsubmenuindent="10" 
        orientation="Vertical" 
        target="_blank"  
        runat="server">

        <items>
          <asp:menuitem navigateurl="Home.aspx"
            target="_self" 
            text="Home">
            <asp:menuitem navigateurl="Music.aspx"
              target="_self"
              text="Music">
              <asp:menuitem navigateurl="Classical.aspx"
                target="_blank" 
                text="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                target="_blank"
                text="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                target="_blank"
                text="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              target="_self"
              text="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                target="_blank"
                text="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                target="_blank"
                text="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                target="_blank"
                text="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. Należy pamiętać, że ustawienie tej właściwości zastępuje Target właściwość kontrolki Menu dla tego elementu menu.

Wartość docelowa Opis
_blank Renderuje zawartość w nowym oknie bez ramek.
_parent Renderuje zawartość w obiekcie nadrzędnym bezpośredniego 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ługują wartość docelową _search .

Uwaga

Właściwość Target jest renderowana jako target atrybut. Atrybut target elementów kotwicy nie jest dozwolony w ścisłej definicji typu dokumentu XHTML 1.1. Nie ustawiaj Target właściwości, jeśli renderowane dane wyjściowe elementu muszą być zgodne ze standardem HyperLink XHTML 1.1. Aby uzyskać więcej informacji, zobacz 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 Ułatwienia dostępu w programie Visual Studio i ASP.NET.

Dotyczy

Zobacz też