MenuItemBinding.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 a cui è applicato l'oggetto MenuItemBinding.
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 di codice seguente viene illustrato come usare la proprietà per specificare la Target finestra in cui visualizzare il contenuto Web associato a una voce di menu, quando viene fatto clic su tale voce di menu. Per il corretto funzionamento di questo esempio, è necessario copiare i dati XML di esempio seguenti in un file denominato Menu.xml.
<%@ 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>MenuItemBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemBinding Example</h3>
<asp:menu id="NavigationMenu"
datasourceid="MenuSource"
runat="server">
<DataBindings>
<asp:menuitembinding datamember="MapHomeNode"
formatstring="({0})"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_self" />
<asp:menuitembinding datamember="MapNode"
depth="1"
formatstring="[{0}]"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
formatstring="<{0}>"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
</DataBindings>
</asp:menu>
<asp:xmldatasource id="MenuSource"
datafile="Menu.xml"
runat="server"/>
</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>MenuItemBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemBinding Example</h3>
<asp:menu id="NavigationMenu"
datasourceid="MenuSource"
runat="server">
<DataBindings>
<asp:menuitembinding datamember="MapHomeNode"
formatstring="({0})"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_self" />
<asp:menuitembinding datamember="MapNode"
depth="1"
formatstring="[{0}]"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
formatstring="<{0}>"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
</DataBindings>
</asp:menu>
<asp:xmldatasource id="MenuSource"
datafile="Menu.xml"
runat="server"/>
</form>
</body>
</html>
Il codice seguente è i dati della mappa del sito di esempio per l'esempio precedente.
<MapHomeNode ImageUrl="~\Images\Home.gif"
Title="Home"
Description="Root Page"
ToolTip="Home Page">
<MapNode ImageUrl="~\Images\Music.gif"
Title="Music"
Description="Music Category"
ToolTip="Music Page">
<MapNode ImageUrl="~\Images\Classical.gif"
Title="Classical"
Description="Classical Section"
ToolTip="Classical Page"/>
<MapNode ImageUrl="~\Images\Rock.gif"
Title="Rock"
Description="Rock Section"
ToolTip="Rock Page"/>
<MapNode ImageUrl="~\Images\Jazz.gif"
Title="Jazz"
Description="Jazz Section"
ToolTip="Jazz Page"/>
</MapNode>
<MapNode ImageUrl="~\Images\Movies.gif"
Title="Movies"
Description="Movies Category"
ToolTip="Movies Page">
<MapNode ImageUrl="~\Images\Action.gif"
Title="Action"
Description="Action Section"
ToolTip="Action Page"/>
<MapNode ImageUrl="~\Images\Drama.gif"
Title="Drama"
Description="Drama Section"
ToolTip="Drama Page"/>
<MapNode ImageUrl="~\Images\Musical.gif"
Title="Musical"
Description="Musical Section"
ToolTip="Musical Page"/>
</MapNode>
</MapHomeNode>
Commenti
Quando il controllo è associato a un'origine dati, utilizzare la MenuTarget 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.
Nota
L'impostazione di questa proprietà esegue l'override Menu.Target della proprietà del Menu controllo per le voci di menu a cui viene applicato l'oggetto MenuItemBinding . È possibile eseguire l'override selettiva di questa proprietà impostando direttamente la MenuItem.Target proprietà di ogni voce di menu.
I valori di destinazione devono iniziare con una lettera nell'intervallo di A tramite 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 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 eseguito come target
attributo. L'attributo target
sugli anchor
elementi 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 MenuItemBinding deve essere conforme A XHTML 1.1. Per altre informazioni, vedere l'argomento 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à ASP.NET.
Si applica a
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per