TreeNodeBinding.FormatString Propriedade

Definição

Obtém ou define a cadeia de caracteres que especifica o formato de exibição do texto de um nó ao qual o objeto TreeNodeBinding é aplicado.Gets or sets the string that specifies the display format for the text of a node to which the TreeNodeBinding object is applied.

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

Valor da propriedade

String

Uma cadeia de caracteres de formatação que especifica o formato de exibição para o texto de um nó ao qual o TreeNodeBinding objeto é aplicado.A formatting string that specifies the display format for the text of a node to which the TreeNodeBinding object is applied. O padrão é uma cadeia de caracteres vazia (""), que indica que a propriedade FormatString não está definida.The default is an empty string (""), which indicates that the FormatString property is not set.

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 FormatString propriedade para especificar um formato de exibição personalizado para o texto que é exibido no nó raiz.The first code example demonstrates how to use the FormatString property to specify a custom display format for the text that is displayed in the root node. 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 de código a seguir demonstra como usar a FormatString propriedade para especificar um formato de exibição personalizado para o texto que é exibido no nó raiz.The following code example demonstrates how to use the FormatString property to specify a custom display format for the text that is displayed in the root node. 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 Book.xml.For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named 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 FormatString Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding FormatString Example</h3>
    
      <!-- Use the FormatString property to apply   -->
      <!-- a custom format string to the root node. -->
      <!-- The placeholder ({0}) is automatically   -->
      <!-- replaced with the value of the field     -->
      <!-- specified in the TextField property.     -->
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="0"
            TextField="Title" 
            FormatString="Best Seller: {0}"/>
          <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 FormatString Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding FormatString Example</h3>
    
      <!-- Use the FormatString property to apply   -->
      <!-- a custom format string to the root node. -->
      <!-- The placeholder ({0}) is automatically   -->
      <!-- replaced with the value of the field     -->
      <!-- specified in the TextField property.     --> 
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="0"
            TextField="Title" 
            FormatString="Best Seller: {0}"/>
          <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>

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

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

Comentários

A FormatString propriedade é usada para fornecer um formato personalizado para o texto de um nó.The FormatString property is used to provide a custom format for a node's text. A cadeia de caracteres de formato de dados consiste em duas partes, separadas por dois-pontos, no formato { A : Bxx }.The data format string consists of two parts, separated by a colon, in the form { A : Bxx }. Por exemplo, a cadeia de caracteres de formatação {0:F2} exibe um número de ponto fixo com duas casas decimais.For example, the formatting string {0:F2} displays a fixed-point number with two decimal places.

Observação

A cadeia de caracteres inteira deve ser colocada entre chaves para indicar que é uma cadeia de caracteres de formato e não uma cadeia de caracteres literal.The entire string must be enclosed in braces to indicate that it is a format string and not a literal string. Qualquer texto fora das chaves é exibido como texto literal.Any text outside the braces is displayed as literal text.

O valor antes dos dois-pontos ( A no exemplo geral) especifica o índice de parâmetro em uma lista de parâmetros com base em zero.The value before the colon (A in the general example) specifies the parameter index in a zero-based list of parameters.

Observação

Esse valor só pode ser definido como 0 porque há apenas um valor em cada nó.This value can be set only to 0 because there is only one value in each node.

O caractere após os dois-pontos ( B no exemplo geral) especifica o formato de exibição para o valor.The character after the colon (B in the general example) specifies the display format for the value. A tabela a seguir lista os formatos comuns.The following table lists the common formats.

Formatar caractereFormat character Exibe valores numéricos emDisplays numeric values in
C Formato de moeda.Currency format.
D Formato decimal.Decimal format.
E Formato científico (exponencial).Scientific (exponential) format.
F Formato fixo.Fixed format.
G Formato geral.General format.
N Formato de número.Number format.
X Formato hexadecimal.Hexadecimal format.

Observação

Exceto para X , o caractere de formato não diferencia maiúsculas de minúsculas.Except for X, the format character is not case sensitive. O X caractere de formato exibe os caracteres hexadecimais no caso especificado.The X format character displays the hexadecimal characters in the case that is specified.

O valor após o caractere de formato ( xx no exemplo geral) especifica o número de dígitos significativos ou casas decimais a serem exibidos.The value after the format character (xx in the general example) specifies the number of significant digits or decimal places to display.

Para mais informações sobre cadeias de caracteres de formatação, consulte Tipos de formatação.For more information on formatting strings, see Formatting Types.

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

O valor da FormatString propriedade, quando definido, pode ser salvo automaticamente em um arquivo de recurso usando uma ferramenta de designer.The value of the FormatString 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