TreeNodeBinding.Target Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia okno docelowe lub ramkę, w której ma być wyświetlana zawartość strony sieci Web skojarzona z węzłem, do którego TreeNodeBinding jest stosowany obiekt.

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

Wartość właściwości

String

Okno docelowe lub ramka, w której ma być wyświetlana połączona zawartość strony sieci Web. Wartości muszą zaczynać się literą w zakresie od A do Z (bez uwzględniania wielkości liter), z wyjątkiem niektórych wartości specjalnych rozpoczynających się od podkreślenia, jak pokazano w poniższej tabeli.

Wartość docelowa Opis
_blank Renderuje zawartość w nowym oknie bez ramek.
_parent Renderuje zawartość w obiekcie nadrzędnym bezpośredniego zestawu ramek.
_search Renderuje zawartość w okienku wyszukiwania.
_self Renderuje zawartość w ramce z fokusem.
_top Renderuje zawartość w pełnym oknie bez ramek.

Uwaga: Sprawdź dokumentację przeglądarki, aby określić, czy wartość jest obsługiwana _search . Na przykład program Microsoft Internet Explorer w wersji 5.0 lub nowszej obsługuje wartość docelową_search.

Wartość domyślna to pusty ciąg (""), który odświeża okno lub ramkę z fokusem.

Przykłady

Ten rozdział zawiera dwa przykłady kodu. W pierwszym przykładzie kodu pokazano, jak za pomocą Target właściwości określić, że strona sieci Web skojarzona z węzłem głównym powinna być wyświetlana w nowym oknie. Drugi przykład kodu zawiera przykładowe dane XML dla pierwszego przykładu kodu.

W poniższym przykładzie pokazano, jak za pomocą Target właściwości określić, że strona sieci Web skojarzona z węzłem głównym powinna być wyświetlana w nowym oknie. Aby ten przykład działał poprawnie, należy skopiować przykładowe dane XML podane po tym przykładzie kodu do pliku o nazwie 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>

Poniższy przykład kodu zawiera przykładowe dane XML dla poprzedniego przykładu kodu.

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

Uwagi

Gdy kontrolka TreeView jest powiązana ze źródłem danych, użyj Target właściwości , aby określić wartość, która ma być powiązana Target z właściwością TreeNode obiektu. Ta relacja powiązania ma wpływ na wszystkie TreeNode obiekty, do których TreeNodeBinding jest stosowany obiekt. Właściwość Target służy do określania okna lub ramki, w której ma być wyświetlana zawartość sieci Web połączona z węzłem po kliknięciu tego węzła.

Uwaga

Target Ustawienie właściwości zastępuje Target właściwość kontrolki TreeView dla węzłów, do których TreeNodeBinding jest stosowany obiekt. Właściwość można selektywnie zastąpić Target , ustawiając Target właściwość każdego węzła bezpośrednio.

Uwaga

Właściwość Target jest renderowana jako target atrybut. Atrybut target elementów anchor nie jest dozwolony w definicji typu dokumentu XHTML 1.1. Nie ustawiaj Target właściwości , jeśli renderowane dane wyjściowe kontrolki TreeNodeBinding muszą być zgodne z XHTML 1.1. Aby uzyskać więcej informacji, zobacz XHTML Standards in Visual Studio and ASP.NET (Standardy XHTML w programie Visual Studio i ASP.NET).

Podczas tworzenia dostępnych stron sieci Web należy unikać używania Target właściwości do kierowania innego okna. Aby uzyskać więcej informacji, zobacz ASP.NET Ułatwienia dostępu.

Wartość tej właściwości jest przechowywana w stanie widoku.

Dotyczy

Zobacz też