TreeNodeBinding.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 où afficher le contenu de page Web associé à un nœud auquel l'objet TreeNodeBinding est appliqué.

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. Les valeurs doivent commencer par une lettre comprise entre A et Z (sans respect des minuscules/majuscules), à l'exception de certaines valeurs spéciales qui commencent par un trait de soulignement, comme le montre le tableau suivant :

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.

Remarque : consultez la documentation de votre navigateur pour déterminer si la _search valeur est prise en charge. Par exemple, Microsoft Internet Explorer version 5.0 ou ultérieure prend en charge la valeur cible _search.

La valeur par défaut est une chaîne vide (""), ce qui signifie que la fenêtre ou le frame ayant le focus sont actualisés.

Exemples

Cette section contient deux exemples de code. Le premier exemple de code montre comment utiliser la Target propriété pour spécifier que la page Web associée au nœud racine doit être affichée dans une nouvelle fenêtre. Le deuxième exemple de code fournit des exemples de données XML pour le premier exemple de code.

L’exemple suivant montre comment utiliser la Target propriété pour spécifier que la page Web associée au nœud racine doit être affichée dans une nouvelle fenêtre. Pour que cet exemple fonctionne correctement, vous devez copier l’exemple de données XML, fourni après cet exemple de code, dans un fichier nommé Book.xml.


<%@ 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>TreeNodeBinding Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding Target Example</h3>
    
      <!-- Clicking the root node will navigate  -->
      <!-- the user to another page. Because the -->
      <!-- Target property is set to "_blank",   -->
      <!-- the linked page is displayed in a new -->
      <!-- window.                               -->
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="0" 
            TextField="Title"
            NavigateUrl="~\Page1.aspx"
            Target="_blank"/>
          <asp:TreeNodeBinding DataMember="Chapter" 
            Depth="1" 
            TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Appendix" 
            Depth="1" 
            TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
    </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>TreeNodeBinding Target Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding Target Example</h3>
    
      <!-- Clicking the root node will navigate  -->
      <!-- the user to another page. Because the -->
      <!-- Target property is set to "_blank",   -->
      <!-- the linked page is displayed in a new -->
      <!-- window.                               -->
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="0" 
            TextField="Title"
            NavigateUrl="~\Page1.aspx"
            Target="_blank"/>
          <asp:TreeNodeBinding DataMember="Chapter" 
            Depth="1" 
            TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Appendix" 
            Depth="1" 
            TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

L’exemple de code suivant fournit des exemples de données XML pour l’exemple de code précédent.

<Book Title="Book Title">  
    <Chapter Heading="Chapter 1">  
        <Section Heading="Section 1">  
        </Section>  
        <Section Heading="Section 2">  
        </Section>  
    </Chapter>  
    <Chapter Heading="Chapter 2">  
        <Section Heading="Section 1">  
        </Section>  
    </Chapter>  
    <Appendix Heading="Appendix A">  
    </Appendix>  
</Book>

Remarques

Lorsque le TreeView contrôle est lié à une source de données, utilisez la Target propriété pour spécifier la valeur à lier à la Target propriété d’un TreeNode objet. Cette relation de liaison affecte tous les TreeNode objets auxquels l’objet TreeNodeBinding est appliqué. La Target propriété est utilisée pour spécifier la fenêtre ou le cadre dans lequel afficher le contenu Web lié à un nœud lorsque ce nœud est cliqué.

Notes

La définition de la Target propriété remplace la Target propriété du TreeView contrôle pour les nœuds auxquels l’objet TreeNodeBinding est appliqué. Vous pouvez remplacer de manière sélective la Target propriété en définissant directement la Target propriété de chaque nœud.

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 TreeNodeBinding contrôle doit être conforme à XHTML 1.1. Pour plus d’informations, consultez normes XHTML dans Visual Studio et ASP.NET.

Lorsque vous créez des pages Web accessibles, vous devez éviter d’utiliser la Target propriété pour cibler une autre fenêtre. Pour plus d’informations, consultez ASP.NET Accessibilité.

La valeur de cette propriété est stockée dans l’état d’affichage.

S’applique à

Share via