This documentation is archived and is not being maintained.

TreeNodeBinding::ToolTipField Property

Gets or sets the name of the field from the data source to bind to the ToolTip property of a TreeNode object to which the TreeNodeBinding object is applied.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

[TypeConverterAttribute(L"System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public:
property String^ ToolTipField {
	String^ get ();
	void set (String^ value);
}

Property Value

Type: System::String
The name of the field to bind to the ToolTip property of a TreeNode object to which the TreeNodeBinding object is applied. The default is an empty string (""), which indicates that the ToolTipField property is not set.

When the TreeView control is bound to a data source, use the ToolTipField property to specify the field name to bind to the ToolTip property of a TreeNode object. This binding relationship affects all TreeNode objects to which the TreeNodeBinding object is applied. The ToolTip text is displayed when the mouse pointer is positioned over the node.

NoteNote

You can selectively override the ToolTipField property by setting the ToolTip property of each node directly.

Instead of using the ToolTipField property to bind the ToolTip property of a TreeNode object to a field, you can set the ToolTip property to a fixed value by setting the ToolTip property.

NoteNote

If the data source contains multiple fields, you must first set the Depth or DataMember property, or both properties in order to bind to the appropriate field.

The value of this property is stored in view state.

This section contains two code examples. The first code example demonstrates how to use the ToolTipField property to specify which attribute of an XML element to bind to the ToolTip property of a TreeNode object to which the TreeNodeBinding object is applied. The second code example provides sample XML data for the first code example.

The following example demonstrates how to use the ToolTipField property to specify which attribute of an XML element to bind to the ToolTip property of a TreeNode object to which the TreeNodeBinding object is applied. For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named Booklist.xml.

No code example is currently available or this language may not be supported.

The following code example provides sample XML data for the preceding code example.

<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>

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: