MenuItem.Target Propriété

  • Référence

Définition

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

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 suivant montre comment utiliser la Target propriété pour spécifier une fenêtre ou un cadre dans lequel afficher le contenu Web lié à un élément de menu 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>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>

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 vous cliquez sur cet élément de menu. 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 : Notez que la définition de cette propriété remplace la Target propriété du Menu contrôle pour cet élément de menu.

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, Microsoft Internet Explorer 5.0 et les versions ultérieures prennent en charge la valeur cible _search.

Notes

La Target propriété est rendue sous la forme d’un target attribut. L’attribut target sur les éléments d’ancrage n’est pas autorisé dans la définition de type de document stricte XHTML 1.1. Ne définissez pas la Target propriété si la sortie rendue pour doit HyperLink être conforme à XHTML 1.1. Pour plus d’informations, consultez Normes XHTML dans Visual Studio et ASP.NET.

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

S’applique à

Voir aussi