Menu.Target Proprietà

  • Riferimento

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 (""), a indicare che verrà eseguito l'aggiornamento della finestra o del frame attivo.

Esempio

Nell'esempio di codice seguente viene illustrato come usare 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 sulla 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 viene fatto clic su tale voce di menu. I valori devono iniziare con una lettera compresa tra A e Z, senza distinzione tra maiuscole e minuscole, ad eccezione dei seguenti valori speciali che iniziano con un carattere di sottolineatura come illustrato nella tabella riportata di seguito.

Valore di destinazione Descrizione
_blank Visualizza il contenuto in una nuova finestra senza frame.
_parent Visualizza il contenuto nell'elemento padre immediato del set di frame.
_search Visualizza il contenuto nel riquadro di ricerca.
_self Consente di visualizzare il contenuto nel frame attivo.
_top Visualizza il contenuto in tutta la finestra senza frame.

Nota

Controllare nella documentazione relativa al browser se è supportato il valore _search. Ad esempio, Internet Explorer versioni 5.0 e successive supportano il valore di _search 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.

Nota

La Target proprietà viene eseguito come attributo di destinazione. L'attributo di destinazione sugli elementi di ancoraggio non è consentito nella definizione del tipo di documento XHTML 1.1. Se l'output sottoposto a rendering deve essere conforme agli standard XHTML o 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