Menu.Target Propriété

Référence

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 ou frame cible dans lequel afficher le contenu de la page web associé à un élément de 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

Valeur de propriété

String

Fenêtre ou frame cible dans lequel afficher le contenu de la page web liée. La valeur par défaut est une chaîne vide (""), ce qui signifie que la fenêtre ou le cadre ayant le focus sont actualisés.

Exemples

L’exemple de code suivant montre comment utiliser la Target propriété pour spécifier que le contenu lié à chaque élément de menu doit être affiché dans une nouvelle fenêtre lorsque l’utilisateur clique sur cet élément de 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>

Remarques

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é. Les valeurs doivent commencer par une lettre comprise entre A et Z (qui ne respecte pas la casse), à l'exception de certaines valeurs spéciales qui commencent par un trait de soulignement, comme le montre le tableau suivant :

Valeur cible	Description
`_blank`	Génère le rendu du contenu dans une nouvelle fenêtre sans frame.
`_parent`	Génère le rendu du contenu dans le parent du jeu de frames immédiat.
`_search`	Génère le rendu du contenu dans le volet de recherche.
`_self`	Génère le rendu du contenu dans le frame qui a le focus.
`_top`	Génère le rendu du contenu dans la fenêtre entière sans frame.

Notes

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

Cette propriété s’applique à tous les éléments de menu d’un Menu contrôle. Vous pouvez remplacer cette propriété de manière sélective en définissant directement la Target propriété de chaque MenuItem objet.

Notes

La Target propriété s’affiche en tant qu’attribut cible. L’attribut cible sur les éléments d’ancrage n’est pas autorisé dans la définition de type de document strict XHTML 1.1. Si la sortie rendue doit être conforme aux normes XHTML ou d’accessibilité, ne définissez pas la Target propriété. Pour plus d’informations, consultez normes XHTML dans Visual Studio et ASP.NET et accessibilité dans Visual Studio et ASP.NET.

S’applique à

Voir aussi

Target