MenuItem.Target Proprietà

Definizione

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

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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 seguente viene illustrato come utilizzare la Target proprietà per specificare una finestra o un frame in cui visualizzare il contenuto Web collegato a una voce di menu quando si 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>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>

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. Si noti che l'impostazione di questa proprietà sostituisce la Target proprietà del Menu controllo per questa voce di menu.

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, Microsoft Internet Explorer 5.0 e versioni successive supportano il _search valore di destinazione.

Annotazioni

Il rendering della Target proprietà viene eseguito come target attributo. L'attributo target sugli elementi di ancoraggio non è consentito nella definizione del tipo di documento strict XHTML 1.1. Non impostare la Target proprietà se l'output sottoposto a rendering per deve HyperLink essere conforme a XHTML 1.1. Per altre informazioni, vedere Standard XHTML in Visual Studio e ASP.NET.

Quando si creano pagine Web accessibili, è consigliabile evitare di usare la proprietà per impostare come Target destinazione un'altra finestra. Per altre informazioni, vedere Accessibilità in Visual Studio e ASP.NET.

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?