Compartir por

TreeNodeBinding.Target Propiedad

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece la ventana o marco de destino en el que se va a mostrar el contenido de la página web asociado a un nodo al que se aplica el TreeNodeBinding objeto.

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

Valor de propiedad

String

Ventana o marco de destino en el que se va a mostrar el contenido de la página web vinculada. Los valores deben comenzar con una letra en el intervalo de A a Z (sin distinción entre mayúsculas y minúsculas), excepto para determinados valores especiales que comienzan con un carácter de subrayado, como se muestra en la tabla siguiente.

Valor de destino Descripción
_blank Representa el contenido en una nueva ventana sin marcos.
_parent Representa el contenido en el elemento primario del conjunto de marcos inmediato.
_search Representa el contenido en el panel de búsqueda.
_self Representa el contenido en el marco con el foco.
_top Representa el contenido en la ventana completa sin marcos.

Nota: Compruebe la documentación del explorador para determinar si se admite el _search valor. Por ejemplo, Microsoft Internet Explorer versión 5.0 y versiones posteriores admiten el _search valor de destino.

El valor predeterminado es una cadena vacía (""), que actualiza la ventana o el marco con el foco.

Ejemplos

Esta sección contiene dos ejemplos de código. En el primer ejemplo de código se muestra cómo usar la Target propiedad para especificar que la página web asociada al nodo raíz debe mostrarse en una nueva ventana. El segundo ejemplo de código proporciona datos XML de ejemplo para el primer ejemplo de código.

En el ejemplo siguiente se muestra cómo usar la Target propiedad para especificar que la página web asociada al nodo raíz debe mostrarse en una nueva ventana. Para que este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo, proporcionados después de este ejemplo de código, en un archivo denominado 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>

En el ejemplo de código siguiente se proporcionan datos XML de ejemplo para el ejemplo de código anterior.

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

Comentarios

Cuando el TreeView control está enlazado a un origen de datos, use la Target propiedad para especificar el valor que se va a enlazar a la Target propiedad de un TreeNode objeto . Esta relación de enlace afecta a todos los objetos a los TreeNode que se aplica el TreeNodeBinding objeto. La Target propiedad se usa para especificar la ventana o marco en el que se muestra el contenido web que está vinculado a un nodo cuando se hace clic en ese nodo.

Nota:

Establecer la Target propiedad invalida la Target propiedad del TreeView control para los nodos a los que se aplica el TreeNodeBinding objeto. Puede invalidar selectivamente la Target propiedad estableciendo directamente la Target propiedad de cada nodo.

Nota:

La Target propiedad se representa como un target atributo. No se permite el target atributo en anchor los elementos en la definición de tipo de documento XHTML 1.1. No establezca la Target propiedad si la salida representada para el TreeNodeBinding control debe ser compatible con XHTML 1.1. Para obtener más información, vea Estándares XHTML en Visual Studio y ASP.NET.

Al crear páginas web accesibles, debe evitar el uso de la Target propiedad para tener como destino otra ventana. Para obtener más información, consulte ASP.NET Accesibilidad.

El valor de esta propiedad se almacena en estado de vista.

Se aplica a

Consulte también