Share via

HyperLink.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 le frame cible sur lequel afficher le contenu de la page Web vers laquelle un lien est établi lorsqu'un clic est effectué sur le contrôle HyperLink.

public:
 property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public string Target { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public string Target { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
Public Property Target As String

Valeur de propriété

String

Fenêtre ou frame cible pour charger la page Web à laquelle un lien est établi lorsqu'un clic a été effectué sur le contrôle HyperLink. Les valeurs doivent commencer par une lettre comprise entre a et z (qui ne respecte pas la casse), à l'exception des valeurs spéciales listées dans le tableau suivant, qui commencent par un trait de soulignement :

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

Remarque : 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 les versions ultérieures prennent en charge la valeur cible _search.

La valeur par défaut est une chaîne vide ("").

Attributs
BindableAttribute TypeConverterAttribute

Exemples

L’exemple suivant montre comment définir la Target propriété pour spécifier la fenêtre ou le cadre pour afficher la page associée au HyperLink contrôle.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
    <title>HyperLink Sample</title>
</head>
<body>
<form id="Form1" runat="server">


   <h3>HyperLink Sample</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  NavigateUrl="http://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_blank"
                  runat="server"/>       

</form>
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>
    <title>HyperLink Sample</title>
</head>
<body>
<form id="Form1" runat="server">

   <h3>HyperLink Sample</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  NavigateUrl="http://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_blank"
                  runat="server"/>       

</form>
</body>
</html>

Remarques

Utilisez la Target propriété pour spécifier le cadre ou la fenêtre qui affiche la page Web liée lorsque le HyperLink contrôle est cliqué. La page Web est spécifiée en définissant la NavigateUrl propriété.

Si cette propriété n’est pas définie, le navigateur ou la fenêtre avec focus s’actualise lorsque le HyperLink contrôle est cliqué.

Notes

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 pour le HyperLink XHTML 1.1 doit être conforme. Pour plus d’informations, reportez-vous à la rubrique XHTML Standards dans Visual Studio et ASP.NET.

Lorsque vous créez des 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 Accessibilité dans Visual Studio et ASP.NET et ASP.NET Contrôles et accessibilité.

S’applique à

Voir aussi