TreeNodeBinding.FormatString 属性

定义

获取或设置字符串,指定 TreeNodeBinding 对象应用到的节点的文本显示格式。

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

属性值

格式字符串,指定 TreeNodeBinding 对象应用到的节点的文本显示格式。 默认值为空字符串 (""),表示尚未设置 FormatString 属性。

示例

本部分包含两个代码示例。 第一个代码示例演示如何使用 FormatString 属性为根节点中显示的文本指定自定义显示格式。 第二个代码示例提供第一个代码示例的示例 XML 数据。

下面的代码示例演示如何使用 FormatString 属性为根节点中显示的文本指定自定义显示格式。 若要使此示例正常工作,必须将此示例后提供的示例 XML 数据复制到名为 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>

下面的代码示例是上述示例的示例 XML 数据。

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

注解

属性 FormatString 用于为节点的文本提供自定义格式。 数据格式字符串由两部分组成,由冒号分隔,格式为 { ABxx }。 例如,格式字符串 {0:F2} 显示具有两位小数的定点数。

注意

整个字符串必须括在大括号中,以指示它是格式字符串而不是文本字符串。 大括号外的任何文本都显示为文本文本。

在常规示例中,冒号前的值 (A) 指定从零开始的参数列表中的参数索引。

注意

此值只能设置为 0,因为每个节点中只有一个值。

常规示例中冒号后 (B 字符) 指定值的显示格式。 下表列出了常用格式。

格式字符 在 中显示数值
C 货币格式。
D 十进制格式。
E 科学 (指数) 格式。
F 固定格式。
G 常规格式。
N 数字格式。
X 十六进制格式。

注意

X除 外,格式字符不区分大小写。 格式 X 字符在指定的情况下显示十六进制字符。

常规示例中格式字符 (xx 后的值) 指定要显示的重要位数或小数位数。

有关设置字符串格式的详细信息,请参阅格式设置类型

此属性的值存储在视图状态中。

属性的值 FormatString 在设置后,可以使用设计器工具自动保存到资源文件中。 有关详细信息,请参阅 LocalizableAttribute全球化和本地化

适用于

另请参阅