TreeNodeBinding.Text Propriedade

Definição

Obtém ou define o texto que é exibido para o nó ao qual o objeto TreeNodeBinding é aplicado.Gets or sets the text that is displayed for the node to which the TreeNodeBinding object is applied.

public:
 property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
public string Text { get; set; }
member this.Text : string with get, set
Public Property Text As String

Valor da propriedade

String

O texto exibido para o nó ao qual o TreeNodeBinding objeto é aplicado.The text displayed for the node to which the TreeNodeBinding object is applied. O padrão é uma cadeia de caracteres vazia ("").The default is an empty string ("").

Exemplos

Esta seção contém dois exemplos de código.This section contains two code examples. O primeiro exemplo de código demonstra como usar a Text propriedade para especificar o valor a ser exibido para um nó ao qual o TreeNodeBinding objeto é aplicado.The first code example demonstrates how to use the Text property to specify the value to display for a node to which the TreeNodeBinding object is applied. O segundo exemplo de código fornece dados XML de exemplo para o primeiro exemplo de código.The second code example provides sample XML data for the first code example.

O exemplo a seguir demonstra como usar a Text propriedade para especificar o valor a ser exibido para um nó ao qual o TreeNodeBinding objeto é aplicado.The following example demonstrates how to use the Text property to specify the value to display for a node to which the TreeNodeBinding object is applied. Para que este exemplo funcione corretamente, você deve copiar os dados XML de exemplo, fornecidos após este exemplo de código, para um arquivo chamado Booklist.xml.For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named Booklist.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>TreeViewBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeViewBinding Example</h3>
    
      <!-- Set the Text, ImageUrl, ImageToolTip, -->
      <!-- NavigateUrl, Value, and ToolTip       -->
      <!-- properties of a TreeNodeBinding       -->
      <!-- object declaratively.                 -->   
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        Target="_blank" 
        runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Books" 
            Depth="0" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="1" 
            Text="Book Title" 
            ImageUrl="Image.jpg"
            ImageToolTip="Book Image" 
            NavigateUrl="http://www.microsoft.com" 
            Value="BookID" 
            ToolTip="Book Information"/>
          <asp:TreeNodeBinding DataMember="Description" 
            Depth="2" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Price" 
            Depth="2" 
            TextField="Value"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Booklist.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>TreeViewBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeViewBinding Example</h3>
    
      <!-- Set the Text, ImageUrl, ImageToolTip, -->
      <!-- NavigateUrl, Value, and ToolTip       -->
      <!-- properties of a TreeNodeBinding       -->
      <!-- object declaratively.                 -->   
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        Target="_blank" 
        runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Books" 
            Depth="0" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="1" 
            Text="Book Title" 
            ImageUrl="Image.jpg"
            ImageToolTip="Book Image" 
            NavigateUrl="http://www.microsoft.com" 
            Value="BookID" 
            ToolTip="Book Information"/>
          <asp:TreeNodeBinding DataMember="Description" 
            Depth="2" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Price" 
            Depth="2" 
            TextField="Value"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Booklist.xml"
        runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

O exemplo de código a seguir fornece dados XML de exemplo para o exemplo de código anterior.The following code example provides sample XML data for the preceding code example.

<Books Text="Books List">  
    <Book Text="Book Title One"  
        Value="1"   
        Image="Bookimage1.jpg"  
        ImageToolTip="Book 1 Photo"   
        Nav="http://www.microsoft.com"  
        Tip="Book Title 1">  
        <Description Text="Book Description">  
        </Description>  
        <Price Value="$1.99">  
        </Price>  
        <Author Text="Author Name"  
            Value="LastName"   
            Image="Authorimage1.jpg"   
            Nav="http://www.microsoft.com"  
            Tip="Author Name">  
        </Author>  
    </Book>  
    <Book Text="Book Title Two"  
        Value="2"   
        Image="Bookimage2.jpg"  
        ImageToolTip="Book 2 Photo"   
        Nav="http://www.microsoft.com"  
        Tip="Click Me">  
        <Description Text="Book Description">  
        </Description>  
        <Price Value="$2.99">  
        </Price>  
        <Author Text="Author Name"  
            Value="LastName"   
            Image="Authorimage2.jpg"   
            Nav="http://www.microsoft.com"  
            Tip="Author Name">  
        </Author>  
    </Book>  
</Books>  

Comentários

Quando o TreeView controle estiver associado a uma fonte de dados, use a Text propriedade para especificar o valor a ser associado à Text propriedade de um TreeNode objeto.When the TreeView control is bound to a data source, use the Text property to specify the value to bind to the Text property of a TreeNode object. Essa relação de associação afeta todos os TreeNode objetos aos quais o TreeNodeBinding objeto é aplicado.This binding relationship affects all TreeNode objects to which the TreeNodeBinding object is applied. A Text propriedade é usada para especificar o texto exibido em um nó.The Text property is used to specify the text displayed in a node.

Observação

Você pode substituir seletivamente a Text Propriedade definindo a Text propriedade de cada nó diretamente.You can selectively override the Text property by setting the Text property of each node directly.

Em vez de usar a Text propriedade para associar o mesmo texto a cada nó, você pode associar a Text propriedade de um TreeNode objeto a um campo de uma fonte de dados definindo a TextField propriedade.Instead of using the Text property to bind the same text to each node, you can bind the Text property of a TreeNode object to a field of a data source by setting the TextField property.

O valor dessa propriedade é armazenado em estado de exibição.The value of this property is stored in view state.

O valor dessa propriedade, quando definido, pode ser salvo automaticamente em um arquivo de recurso usando uma ferramenta de designer.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Para obter mais informações, consulte, LocalizableAttribute globalização e localização.For more information, see LocalizableAttribute and Globalization and Localization.

Aplica-se a

Confira também