TreeNodeBinding.Value Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает отображаемое значение, которое не отображается, но используется для хранения любых дополнительных данных об узле, к которому применяется объект TreeNodeBinding, например, данных, которые используются для обработки событий обратной передачи.
public:
property System::String ^ Value { System::String ^ get(); void set(System::String ^ value); };public string Value { get; set; }member this.Value : string with get, setPublic Property Value As StringЗначение свойства
Дополнительные данные об узле, к которому применяется объект TreeNodeBinding; эти данные не отображаются. Значение по умолчанию — пустая строка ("").
Примеры
Этот раздел содержит два примера кода. В первом примере кода показано, как использовать Value свойство для хранения дополнительных данных об узле, к которому TreeNodeBinding применяется объект. Второй пример кода содержит примеры XML-данных для первого примера кода.
В следующем примере показано, как использовать Value свойство для хранения дополнительных данных о узле, к которому TreeNodeBinding применяется объект. Для правильной работы этого примера необходимо скопировать образцы XML-данных, предоставленные после этого примера кода, в файл с именем Booklist.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>TreeViewBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeViewBinding Example</h3>
<!-- Set the Text, ImageUrl, ImageToolTip, -->
<!-- NavigateUrl, Value, and ToolTip -->
<!-- properties of a TreeNodeBinding -->
<!-- object declaratively. -->
<asp:TreeView id="BookTreeView"
DataSourceID="BookXmlDataSource"
Target="_blank"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Books"
Depth="0"
TextField="Text"/>
<asp:TreeNodeBinding DataMember="Book"
Depth="1"
Text="Book Title"
ImageUrl="Image.jpg"
ImageToolTip="Book Image"
NavigateUrl="http://www.microsoft.com"
Value="BookID"
ToolTip="Book Information"/>
<asp:TreeNodeBinding DataMember="Description"
Depth="2"
TextField="Text"/>
<asp:TreeNodeBinding DataMember="Price"
Depth="2"
TextField="Value"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="BookXmlDataSource"
DataFile="Booklist.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>TreeViewBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeViewBinding Example</h3>
<!-- Set the Text, ImageUrl, ImageToolTip, -->
<!-- NavigateUrl, Value, and ToolTip -->
<!-- properties of a TreeNodeBinding -->
<!-- object declaratively. -->
<asp:TreeView id="BookTreeView"
DataSourceID="BookXmlDataSource"
Target="_blank"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Books"
Depth="0"
TextField="Text"/>
<asp:TreeNodeBinding DataMember="Book"
Depth="1"
Text="Book Title"
ImageUrl="Image.jpg"
ImageToolTip="Book Image"
NavigateUrl="http://www.microsoft.com"
Value="BookID"
ToolTip="Book Information"/>
<asp:TreeNodeBinding DataMember="Description"
Depth="2"
TextField="Text"/>
<asp:TreeNodeBinding DataMember="Price"
Depth="2"
TextField="Value"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="BookXmlDataSource"
DataFile="Booklist.xml"
runat="server">
</asp:XmlDataSource>
</form>
</body>
</html>
В следующем примере кода приведен пример XML-данных для предыдущего примера кода.
<Books Text="Books List">
<Book Text="Book Title One"
Value="1"
Image="Bookimage1.jpg"
ImageToolTip="Book 1 Photo"
Nav="http://www.microsoft.com"
Tip="Book Title 1">
<Description Text="Book Description">
</Description>
<Price Value="$1.99">
</Price>
<Author Text="Author Name"
Value="LastName"
Image="Authorimage1.jpg"
Nav="http://www.microsoft.com"
Tip="Author Name">
</Author>
</Book>
<Book Text="Book Title Two"
Value="2"
Image="Bookimage2.jpg"
ImageToolTip="Book 2 Photo"
Nav="http://www.microsoft.com"
Tip="Click Me">
<Description Text="Book Description">
</Description>
<Price Value="$2.99">
</Price>
<Author Text="Author Name"
Value="LastName"
Image="Authorimage2.jpg"
Nav="http://www.microsoft.com"
Tip="Author Name">
</Author>
</Book>
</Books>
Комментарии
TreeView Если элемент управления привязан к источнику данных, используйте Value свойство, чтобы указать значение для привязки TreeNode к Value свойству объекта. Эта связь привязки влияет на все TreeNode объекты, к которым TreeNodeBinding применяется объект. Свойство Value используется для дополнения Text свойства путем хранения любых дополнительных данных, связанных с узлом, к которому TreeNodeBinding применяется объект. Это значение не отображается в элементе управления и обычно используется для хранения данных для обработки событий обратной передачи.
Примечание
Можно выборочно переопределить Value свойство, задав Value свойство каждого узла напрямую.
Вместо использования Value свойства для привязки одного значения к каждому узлу можно привязать Value свойство TreeNode объекта к полю источника данных, задав ValueField свойство.
Значение этого свойства хранится в состоянии представления.
Значение этого свойства при установке может быть автоматически сохранено в файле ресурсов с помощью средства конструктора. Дополнительные сведения см. в разделе LocalizableAttribute и глобализации и локализации.