Partager via

HyperLinkColumn.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 pour afficher le contenu de la page Web vers laquelle pointe le lien hypertexte sélectionné par un clic dans la colonne.

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

Valeur de propriété

String

Fenêtre ou frame cible pour charger la page Web vers laquelle pointe le lien hypertexte sélectionné par un clic dans la colonne. 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.

Attributs
TypeConverterAttribute

Exemples

L’exemple suivant montre comment utiliser la Target propriété pour spécifier la fenêtre permettant d’afficher le contenu de la page Web liée lorsque vous cliquez sur le lien hypertexte dans la colonne. Cet exemple montre comment afficher la page Web liée dans une nouvelle fenêtre.

Notes

L’exemple de code suivant utilise le modèle de code à fichier unique et peut ne pas fonctionner correctement s’il est copié directement dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide qui a une extension .aspx. Pour plus d’informations sur le modèle de code Web Forms, consultez ASP.NET modèle de code de page Web Forms.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!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>HyperLinkColumn Example</title>
<script runat="server">

      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("PriceValue", typeof(Double)));
       
         for (int i = 0; i < 3; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = (Double)i * 1.23;

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;
      }

      void Page_Load(Object sender, EventArgs e) 
      {
         MyDataGrid.DataSource = CreateDataSource();
         MyDataGrid.DataBind();
      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>HyperLinkColumn Example</h3>

      <asp:DataGrid id="MyDataGrid" 
           BorderColor="black"
           BorderWidth="1"
           GridLines="Both"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#aaaadd"/>

         <Columns>

            <asp:HyperLinkColumn
                 HeaderText="Select an Item"
                 DataNavigateUrlField="IntegerValue"
                 DataNavigateUrlFormatString="detailspage.aspx?id={0}"
                 DataTextField="PriceValue"
                 DataTextFormatString="{0:c}"
                 Target="_blank"/>
           
         </Columns>

      </asp:DataGrid>

   </form>

</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!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>HyperLinkColumn Example</title>
<script runat="server">

      Function CreateDataSource() As ICollection 
      
         Dim dt As DataTable = New DataTable()
         Dim dr As DataRow
         Dim i As Integer

         dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
         dt.Columns.Add(New DataColumn("PriceValue", GetType(Double)))
       
         For i = 0 to 2 
         
            dr = dt.NewRow()

            dr(0) = i
            dr(1) = CDbl(i) * 1.23

            dt.Rows.Add(dr)

         Next i

         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function

      Sub Page_Load(sender As Object, e As EventArgs) 
    
         MyDataGrid.DataSource = CreateDataSource()
         MyDataGrid.DataBind()

      End Sub

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>HyperLinkColumn Example</h3>

      <asp:DataGrid id="MyDataGrid" 
           BorderColor="black"
           BorderWidth="1"
           GridLines="Both"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#aaaadd"/>

         <Columns>

            <asp:HyperLinkColumn
                 HeaderText="Select an Item"
                 DataNavigateUrlField="IntegerValue"
                 DataNavigateUrlFormatString="detailspage.aspx?id={0}"
                 DataTextField="PriceValue"
                 DataTextFormatString="{0:c}"
                 Target="_blank"/>
           
         </Columns>

      </asp:DataGrid>

   </form>

</body>
</html>

L’exemple correspondant suivant affiche l’élément sélectionné dans l’exemple précédent.

<%@ 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>Details page for DataGrid</title>
<script runat="server">
 
      void Page_Load(Object sender, EventArgs e) 
      {
         Label1.Text = "You selected item: " + Request.QueryString["id"];
      }
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</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>Details page for DataGrid</title>
<script runat="server">
 
      Sub Page_Load(sender As Object, e As EventArgs) 
      
         Label1.Text = "You selected item: " & Request.QueryString("id")
      
      End Sub
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</body>
</html>

Remarques

Utilisez la Target propriété pour spécifier le cadre ou la fenêtre qui affiche la page Web liée lorsqu’un lien hypertexte dans la colonne est cliqué.

Si cette propriété n’est pas définie, le navigateur ou la fenêtre avec le focus s’actualise lorsqu’un lien hypertexte dans la colonne 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 doit HyperLinkColumn être conforme à XHTML 1.1. Pour plus d’informations, consultez la rubrique 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é ASP.NET.

La Target valeur doit commencer par une lettre dans la plage de A à Z (sans respect de la casse), à l’exception des valeurs spéciales suivantes, qui commencent par un trait de soulignement.

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

S’applique à

Voir aussi