Поделиться через


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 используется для предоставления пользовательского формата для текста узла. Строка формата данных состоит из двух частей, разделенных двоеточием, в форме { A : Bxx }. Например, в строке {0:F2} форматирования отображается число с фиксированной запятой с двумя десятичными знаками.

Примечание

Вся строка должна быть заключена в фигурные скобки, чтобы указать, что она является строкой формата, а не строкой литерала. Любой текст за пределами фигурных скобок отображается как литеральный текст.

Значение перед двоеточием (A в общем примере) указывает индекс параметров в отсчитываемом от нуля списке параметров.

Примечание

Это значение можно задать только в 0, так как в каждом узле есть только одно значение.

Символ после двоеточия (B в общем примере) указывает формат отображения для значения. В следующей таблице перечислены распространенные форматы.

Формат символа Отображает числовые значения в
C Формат валюты.
D Десятичный формат.
E Научный (экспоненциальный) формат.
F Исправлен формат.
G Общий формат.
N Числовой формат.
X Шестнадцатеричный формат.

Примечание

XЗа исключением символа формата регистр не учитывается. Символ X формата отображает шестнадцатеричные символы в указанном регистре.

Значение после символа форматирования (xx в общем примере) указывает количество значимых цифр или десятичных разрядов для отображения.

Дополнительные сведения о форматировании строк см. в статье Общие сведения о форматировании.

Значение этого свойства хранится в состоянии представления.

Значение FormatString свойства, если задано, можно автоматически сохранить в файл ресурсов с помощью средства конструктора. Дополнительные сведения см. в разделах LocalizableAttributeи Глобализация и локализация.

Применяется к

См. также раздел