MenuItemBinding.Target Propriété

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit la fenêtre cible ou le cadre dans lequel afficher le contenu de la page Web associé à un élément de menu auquel l’objet MenuItemBinding est appliqué.

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

Valeur de propriété

String

Fenêtre ou cadre cible dans lequel afficher le contenu de la page Web liée. La valeur par défaut est une chaîne vide (« »), qui actualise la fenêtre ou le cadre avec le focus.

Exemples

L’exemple de code suivant montre comment utiliser la Target propriété pour spécifier la fenêtre dans laquelle afficher le contenu Web associé à un élément de menu, lorsque cet élément de menu est cliqué. Pour que cet exemple fonctionne correctement, vous devez copier les exemples de données XML ci-dessous dans un fichier nommé 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>

Le code suivant est un exemple de données de carte de site pour l’exemple précédent.

<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>

Remarques

Lorsque le Menu contrôle est lié à une source de données, utilisez la Target propriété pour spécifier la fenêtre ou le cadre dans lequel afficher le contenu Web lié à un élément de menu lorsque cet élément de menu est cliqué.

Note

La définition de cette propriété remplace la Menu.Target propriété du Menu contrôle pour les éléments de menu auxquels l’objet MenuItemBinding est appliqué. Vous pouvez remplacer cette propriété de manière sélective en définissant la MenuItem.Target propriété de chaque élément de menu directement.

Les valeurs cibles doivent commencer par une lettre dans la plage de A à Z (sans respect de la casse), à l’exception de certaines valeurs spéciales qui commencent par un trait de soulignement, comme indiqué dans le tableau suivant.

Valeur cible	Description
`_blank`	Affiche le contenu dans une nouvelle fenêtre sans cadres.
`_parent`	Affiche le contenu dans le parent du jeu de frameset immédiats.
`_search`	Affiche le contenu dans le volet de recherche.
`_self`	Affiche le contenu dans le cadre avec le focus.
`_top`	Affiche le contenu dans la fenêtre complète sans cadres.

Note

Consultez la documentation de votre navigateur pour déterminer si la _search valeur est prise en charge. Par exemple, Microsoft Internet Explorer 5.0 et versions ultérieures prennent en charge la _search valeur cible.

Note

La Target propriété s’affiche en tant qu’attribut target . L’attribut target sur les anchor éléments n’est pas autorisé dans la définition de type de document XHTML 1.1. Ne définissez pas la Target propriété si la sortie rendue de l’objet MenuItemBinding doit être conforme À XHTML 1.1. Pour plus d’informations, consultez la rubrique XHTML Standards dans Visual Studio et ASP.NET.

Lors de la création de pages Web accessibles, il est fortement recommandé d’éviter d’utiliser la Target propriété pour cibler une autre fenêtre. Pour plus d’informations, consultez ASP.NET Accessibilité.

S’applique à

Voir aussi

Commentaires

Est-ce que cette page vous a été utile?

Partage via

MenuItemBinding.Target Propriété

Définition

Valeur de propriété

Exemples

Remarques

S’applique à

Voir aussi

Commentaires