TreeNodeBinding.Value Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een weergegeven waarde opgehaald of ingesteld die niet wordt weergegeven, maar wordt gebruikt om aanvullende gegevens op te slaan over een knooppunt waarop het TreeNodeBinding object wordt toegepast, zoals gegevens die worden gebruikt voor het verwerken van terugvalgebeurtenissen.
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 StringWaarde van eigenschap
Aanvullende gegevens over een knooppunt waarop het TreeNodeBinding object wordt toegepast; deze gegevens worden niet weergegeven. De standaardwaarde is een lege tekenreeks ("").
Voorbeelden
Deze sectie bevat twee codevoorbeelden. In het eerste codevoorbeeld ziet u hoe u de Value eigenschap gebruikt om aanvullende gegevens op te slaan over een knooppunt waarop het TreeNodeBinding object wordt toegepast. Het tweede codevoorbeeld bevat voorbeeld-XML-gegevens voor het eerste codevoorbeeld.
In het volgende voorbeeld ziet u hoe u de Value eigenschap gebruikt om aanvullende gegevens op te slaan over een knooppunt waarop het TreeNodeBinding object wordt toegepast. Als dit voorbeeld correct werkt, moet u de voorbeeld-XML-gegevens kopiëren, die na dit codevoorbeeld zijn opgegeven, naar een bestand met de naam 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>
Het volgende codevoorbeeld bevat voorbeeld-XML-gegevens voor het voorgaande codevoorbeeld.
<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>
Opmerkingen
Wanneer het TreeView besturingselement is gebonden aan een gegevensbron, gebruikt u de Value eigenschap om de waarde op te geven die moet worden gekoppeld aan de Value eigenschap van een TreeNode object. Deze bindingsrelatie is van invloed op alle TreeNode objecten waarop het TreeNodeBinding object wordt toegepast. De Value eigenschap wordt gebruikt om de Text eigenschap aan te vullen door aanvullende gegevens op te slaan die zijn gekoppeld aan het knooppunt waarop het TreeNodeBinding object wordt toegepast. Deze waarde wordt niet weergegeven in het besturingselement en wordt vaak gebruikt voor het opslaan van gegevens voor het verwerken van terugvalgebeurtenissen.
Note
U kunt de Value eigenschap selectief overschrijven door de Value eigenschap van elk knooppunt rechtstreeks in te stellen.
In plaats van de Value eigenschap te gebruiken om dezelfde waarde aan elk knooppunt te binden, kunt u de Value eigenschap van een TreeNode object binden aan een veld van een gegevensbron door de ValueField eigenschap in te stellen.
De waarde van deze eigenschap wordt opgeslagen in de weergavestatus.
De waarde van deze eigenschap, wanneer deze is ingesteld, kan automatisch worden opgeslagen in een resourcebestand met behulp van een ontwerpprogramma. Zie en LocalizableAttribute voor meer informatie.
