TreeNodeBinding.FormatString Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.
public:
property System::String ^ FormatString { System::String ^ get(); void set(System::String ^ value); };public string FormatString { get; set; }member this.FormatString : string with get, setPublic Property FormatString As StringValor da propriedade
Uma cadeia de caracteres de formatação que especifica o formato de exibição do texto de um nó ao qual o TreeNodeBinding objeto é aplicado. O padrão é uma cadeia de caracteres vazia (""), que indica que a propriedade FormatString não está definida.
Exemplos
Esta seção contém dois exemplos de código. O primeiro exemplo de código demonstra como usar a FormatString propriedade para especificar um formato de exibição personalizado para o texto exibido no nó raiz. O segundo exemplo de código fornece dados XML de exemplo para o primeiro exemplo de código.
O exemplo de código a seguir demonstra como usar a FormatString propriedade para especificar um formato de exibição personalizado para o texto exibido no nó raiz. 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.
<%@ 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 é dados XML de exemplo para o exemplo 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>
Comentários
A FormatString propriedade é usada para fornecer um formato personalizado para o texto de um nó. A cadeia de caracteres de formato de dados consiste em duas partes, separadas por dois-pontos, no formato { A : Bxx }. Por exemplo, a cadeia de caracteres de formatação {0:F2} exibe um número de ponto fixo com duas casas decimais.
Observação
A cadeia de caracteres inteira deve estar entre chaves para indicar que é uma cadeia de caracteres de formato e não uma cadeia de caracteres literal. Qualquer texto fora das chaves é exibido como texto literal.
O valor antes dos dois-pontos (A no exemplo geral) especifica o índice de parâmetro em uma lista de parâmetros baseada em zero.
Observação
Esse valor pode ser definido apenas como 0 porque há apenas um valor em cada nó.
O caractere após os dois-pontos (B no exemplo geral) especifica o formato de exibição para o valor. A tabela a seguir lista os formatos comuns.
| Caractere de formato | Exibe valores numéricos em |
|---|---|
C |
Formato de moeda. |
D |
Formato decimal. |
E |
Formato científico (exponencial). |
F |
Formato fixo. |
G |
Formato geral. |
N |
Formato de número. |
X |
Formato hexadecimal. |
Observação
Exceto para X, o caractere de formato não diferencia maiúsculas de minúsculas. O X caractere de formato exibe os caracteres hexadecimal no caso especificado.
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 exibidas.
Para mais informações sobre cadeias de caracteres de formatação, consulte Tipos de formatação.
O valor dessa propriedade é armazenado no estado de exibição.
O valor da FormatString propriedade, quando definido, pode ser salvo automaticamente em um arquivo de recurso usando uma ferramenta de designer. Para obter mais informações, consulte LocalizableAttributee Globalização e Localização.
