Condividi tramite

Menu.Target Proprietà

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta la finestra o il frame di destinazione in cui visualizzare il contenuto della pagina Web associato a una voce di 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

Valore della proprietà

String

Finestra o frame di destinazione in cui visualizzare il contenuto della pagina Web collegata. Il valore predefinito è una stringa vuota (""), che aggiorna la finestra o il frame con lo stato attivo.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la Target proprietà per specificare che il contenuto collegato a ogni voce di menu deve essere visualizzato in una nuova finestra quando l'utente fa clic su tale voce di 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>

Commenti

Utilizzare la Target proprietà per specificare la finestra o la cornice in cui visualizzare il contenuto Web collegato a una voce di menu quando si fa clic su tale voce di menu. I valori devono iniziare con una lettera nell'intervallo da A a Z (senza distinzione tra maiuscole e minuscole), ad eccezione di determinati valori speciali che iniziano con un carattere di sottolineatura, come illustrato nella tabella seguente.

Valore target Descrizione
_blank Esegue il rendering del contenuto in una nuova finestra senza frame.
_parent Esegue il rendering del contenuto nell'elemento padre del frameset immediato.
_search Esegue il rendering del contenuto nel riquadro di ricerca.
_self Esegue il rendering del contenuto nel frame con lo stato attivo.
_top Esegue il rendering del contenuto nella finestra completa senza frame.

Annotazioni

Controllare la documentazione del browser per determinare se il _search valore è supportato. Ad esempio, Internet Explorer versioni 5.0 e successive supportano il _search valore di destinazione

Questa proprietà si applica a tutte le voci di menu in un Menu controllo . È possibile eseguire l'override selettiva di questa proprietà impostando direttamente la Target proprietà di ogni MenuItem oggetto.

Annotazioni

La proprietà esegue il Target rendering come attributo di destinazione. L'attributo di destinazione sugli elementi di ancoraggio non è consentito nella definizione del tipo di documento strict XHTML 1.1. Se l'output sottoposto a rendering deve essere conforme agli standard XHTML o di accessibilità, non impostare la Target proprietà . Per altre informazioni, vedere Standard XHTML in Visual Studio e ASP.NET eaccessibilità in Visual Studio e ASP.NET.

Si applica a

Vedi anche