HyperLinkColumn.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 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 propriété pour spécifier la Target fenêtre pour afficher le contenu de la page Web liée lorsque le lien hypertexte de la colonne est cliqué. 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 Web Forms modèle de code de page.

<%@ 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 focus 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 le HyperLinkColumn XHTML 1.1 doit être conforme. Pour plus d’informations, reportez-vous à 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 ASP.NET Accessibilité.

La Target valeur doit commencer par une lettre de la plage 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

ASP.NET fonctionnalités de contrôle de serveur web et de navigateur

HyperLinkColumn.Target Propriété

Définition

Valeur de propriété

Exemples

Remarques

S’applique à

Voir aussi

Ressources supplémentaires