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

TreeNodeBinding.FormatString Свойство

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Возвращает или задает строку, указывающую формат отображения для текста узла, к которому 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

Значение свойства

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 и глобализации и локализации.

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

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