MenuItem.Target Proprietà
Definizione
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à
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 seguente viene illustrato come usare la Target proprietà per specificare una finestra o un frame in cui visualizzare il contenuto Web collegato a una voce di menu quando viene fatto 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 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. Si noti che l'impostazione di questa proprietà esegue l'override Target della proprietà del Menu controllo per questa voce di menu.
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, Microsoft Internet Explorer 5.0 e versioni successive supportano il valore di destinazione _search
.
Nota
La Target proprietà viene eseguita come target
attributo. L'attributo target
sugli elementi di ancoraggio non è consentito nella definizione del tipo di documento XHTML 1.1. Non impostare la proprietà se l'output di cui è stato eseguito il Target rendering per l'oggetto HyperLink deve 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 eseguire la Target destinazione di un'altra finestra. Per altre informazioni, vedere Accessibilità in Visual Studio e ASP.NET.