Menu.Target Propriété

Définition

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.Gets or sets the target window or frame in which to display the Web page content associated with a menu item.

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.The target window or frame in which to display the linked Web page content. 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.The default value is an empty string (""), which refreshes the window or frame with focus.

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.The following code example demonstrates how to use the Target property to specify that the content linked to each menu item should be displayed in a new window when the user clicks that menu item.


<%@ 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 frame dans lequel afficher le contenu Web lié à un élément de menu lorsque l’utilisateur clique sur cet élément de menu.Use the Target property to specify the window or frame in which to display the Web content linked to a menu item when that menu item is clicked. 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 :Values must begin with a letter in the range of A through Z (case-insensitive), except for certain special values that begin with an underscore, as shown in the following table.

Valeur cibleTarget value DescriptionDescription
_blank Génère le rendu du contenu dans une nouvelle fenêtre sans frame.Renders the content in a new window without frames.
_parent Génère le rendu du contenu dans le parent du jeu de frames immédiat.Renders the content in the immediate frameset parent.
_search Génère le rendu du contenu dans le volet de recherche.Renders the content in the search pane.
_self Génère le rendu du contenu dans le frame qui a le focus.Renders the content in the frame with focus.
_top Génère le rendu du contenu dans la fenêtre entière sans frame.Renders the content in the full window without frames.

Notes

Vérifiez la documentation de votre navigateur pour déterminer si la valeur _search est prise en charge.Check your browser documentation to determine if the _search value is supported. Par exemple, les versions 5,0 et ultérieures d’Internet Explorer prennent en charge la _search valeur cibleFor example, Internet Explorer versions 5.0 and above support the _search target value

Cette propriété s’applique à tous les éléments de menu d’un Menu contrôle.This property applies to all menu items in a Menu control. Vous pouvez substituer cette propriété de manière sélective en définissant la Target propriété de chaque MenuItem objet directement.You can selectively override this property by setting the Target property of each MenuItem object directly.

Notes

La Target propriété est rendue sous la forme d’un attribut cible.The Target property renders as a target attribute. L’attribut Target sur les éléments d’ancrage n’est pas autorisé dans la définition de type de document XHTML 1,1 strict.The target attribute on anchor elements is not allowed in the XHTML 1.1 strict document type definition. Si la sortie rendue doit se conformer aux normes XHTML ou d’accessibilité, ne définissez pas la Target propriété.If rendered output must conform to XHTML or accessibility standards, do not set the Target property. Pour plus d’informations, consultez normes XHTML dans Visual Studio et ASP.net et accessibilité dans visual studio et ASP.net.For more information, see XHTML Standards in Visual Studio and ASP.NET and Accessibility in Visual Studio and ASP.NET.

S’applique à

Voir aussi