HyperLinkField.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 dans lequel afficher la page Web vers laquelle un lien est établi lorsqu'un clic est effectué sur un lien hypertexte dans un objet HyperLinkField.

public:
 virtual property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public virtual string Target { 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 dans lequel charger la page web vers laquelle un lien hypertexte est établi lorsqu’un un clic est effectué dans un HyperLinkField. La valeur par défaut est une chaîne vide (""), ce qui signifie que cette propriété n'est pas définie.

Attributs: TypeConverterAttribute

Exemples

L’exemple de code suivant montre comment utiliser la Target propriété pour spécifier une fenêtre cible dans laquelle afficher le contenu de la page Web associée à un lien hypertexte dans un HyperLinkField objet. La page Web liée s’affiche dans une nouvelle fenêtre lorsque le lien hypertexte est cliqué.


<%@ 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>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- Set the HyperLinkField field column to a static     -->
      <!-- caption and URL.                                    -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="OrderID"/>
          <asp:boundfield datafield="CustomerID" 
            headertext="Customer ID"/>
          <asp:boundfield datafield="OrderDate" 
            headertext="Order Date"
            dataformatstring="{0:d}" />
          <asp:hyperlinkfield text="Details..."
            navigateurl="~\details.aspx"            
            headertext="Order Details"
            target="_blank" />
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </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>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- Set the HyperLinkField field column to a static     -->
      <!-- caption and URL.                                    -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="OrderID"/>
          <asp:boundfield datafield="CustomerID" 
            headertext="Customer ID"/>
          <asp:boundfield datafield="OrderDate" 
            headertext="Order Date"
            dataformatstring="{0:d}" />
          <asp:hyperlinkfield text="Details..."
            navigateurl="~\details.aspx"            
            headertext="Order Details"
            target="_blank" />
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </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 lien hypertexte lorsque ce lien hypertexte est cliqué.

Les valeurs doivent commencer par une lettre de la plage A à Z (sans respect de la casse), à l’exception des valeurs spéciales répertoriées dans le tableau suivant, chacune commençant par un trait de soulignement.

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

Notes

La Target propriété est rendue 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 de l’objet HyperLinkField doit être conforme à XHTML 1.1. 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é.

S’applique à