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, setPublic 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и Глобализация и локализация.
