TreeNodeBinding.Target Propiedad

  • Referencia

Definición

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

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

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 que se debe mostrar el contenido de página web vinculado. Los valores deben empezar con una letra de la A a la Z (sin distinción de mayúsculas y minúsculas), excepto en el caso de ciertos valores especiales que empiezan con un carácter de subrayado, como se muestra en la siguiente tabla.

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

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

El valor predeterminado es una cadena vacía (""), que actualiza la ventana o 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 se debe mostrar en una nueva ventana. En el segundo ejemplo de código se proporcionan 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 se debe mostrar 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

Al establecer la Target propiedad se 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 la Target propiedad de cada nodo directamente.

Nota

La Target propiedad se representa como un target atributo. No target se permite el atributo en anchor los elementos en la definición de tipo de documento XHTML 1.1. No establezca la propiedad si la Target 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 dirigirse a otra ventana. Para obtener más información, consulte accesibilidad de ASP.NET.

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

Se aplica a

Consulte también