TreeNode Constructors
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Initializes a new instance of the TreeNode class.
Overloads
TreeNode() |
Initializes a new instance of the TreeNode class without text or a value. |
TreeNode(String) |
Initializes a new instance of the TreeNode class using the specified text. |
TreeNode(String, String) |
Initializes a new instance of the TreeNode class using the specified text and value. |
TreeNode(TreeView, Boolean) |
Initializes a new instance of the TreeNode class using the specified owner. |
TreeNode(String, String, String) |
Initializes a new instance of the TreeNode class using the specified text, value, and image URL. |
TreeNode(String, String, String, String, String) |
Initializes a new instance of the TreeNode class using the specified text, value, image URL, navigation URL, and target. |
TreeNode()
Initializes a new instance of the TreeNode class without text or a value.
public:
TreeNode();
public TreeNode ();
Public Sub New ()
Examples
The following code example demonstrates how to use this constructor to dynamically add a node to the TreeView control.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Page_Init(Object sender, EventArgs e)
{
if(!IsPostBack)
{
// Add the first tree to the TreeView control.
CreateTree("Section 1");
// Add the second tree to the TreeView control.
CreateTree("Section 2");
}
}
void CreateTree(String NodeText)
{
// Create the root node using the default constructor.
TreeNode root = new TreeNode();
root.Text = NodeText;
// Use the ChildNodes property of the root TreeNode to add child nodes.
// Create the node using the constructor that takes the text parameter.
root.ChildNodes.Add(new TreeNode("Topic 1"));
// Create the node using the constructor that takes the text and value parameters.
root.ChildNodes.Add(new TreeNode("Topic 2", "Value 2"));
// Create the node using the constructor that takes the text, value,
// and imageUrl parameters.
root.ChildNodes.Add(new TreeNode("Topic 3", "Value 3", "Image1.jpg"));
// Create the node using the constructor that takes the text, value,
// imageUrl, navigateUrl, and target parameters.
root.ChildNodes.Add(new TreeNode("Topic 4", "Value 4", "Image1.jpg", "http://www.microsoft.com", "_blank"));
// Add the root node to the Nodes collection of the TreeView control.
DynamicTreeView.Nodes.Add(root);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNode Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNode Constructor Example</h3>
<asp:TreeView id="DynamicTreeView"
EnableClientScript="false"
ExpandDepth="2"
runat="server">
</asp:TreeView>
</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">
<script runat="server">
Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
If Not IsPostBack Then
' Add the first tree to the TreeView control.
CreateTree("Section 1")
' Add the second tree to the TreeView control.
CreateTree("Section 2")
End If
End Sub
Sub CreateTree(ByVal NodeText As String)
' Create the root node using the default constructor.
Dim root As TreeNode = New TreeNode
root.Text = NodeText
' Use the ChildNodes property of the root TreeNode to add child nodes.
' Create the node using the constructor that takes the text parameter.
root.ChildNodes.Add(New TreeNode("Topic 1"))
' Create the node using the constructor that takes the text and value parameters.
root.ChildNodes.Add(New TreeNode("Topic 2", "Value 2"))
' Create the node using the constructor that takes the text, value,
' and imageUrl parameters.
root.ChildNodes.Add(New TreeNode("Topic 3", "Value 3", "Image1.jpg"))
' Create the node using the constructor that takes the text, value,
' imageUrl, navigateUrl, and target parameters.
root.ChildNodes.Add(New TreeNode("Topic 4", "Value 4", "Image1.jpg", "http://www.microsoft.com", "_blank"))
' Add the root node to the Nodes collection of the TreeView control.
DynamicTreeView.Nodes.Add(root)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNode Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNode Constructor Example</h3>
<asp:TreeView id="DynamicTreeView"
EnableClientScript="false"
ExpandDepth="2"
runat="server">
</asp:TreeView>
</form>
</body>
</html>
Remarks
Use this constructor to initialize a new instance of the TreeNode class using the default values.
Note
When this constructor is used, all properties in the TreeNode object are set to their default values. Be sure to set the properties, as necessary, after creating the object.
See also
Applies to
TreeNode(String)
Initializes a new instance of the TreeNode class using the specified text.
public:
TreeNode(System::String ^ text);
public TreeNode (string text);
new System.Web.UI.WebControls.TreeNode : string -> System.Web.UI.WebControls.TreeNode
Public Sub New (text As String)
Parameters
Examples
The following code example demonstrates how to use this constructor to dynamically add a node to the TreeView control.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Page_Init(Object sender, EventArgs e)
{
if(!IsPostBack)
{
// Add the first tree to the TreeView control.
CreateTree("Section 1");
// Add the second tree to the TreeView control.
CreateTree("Section 2");
}
}
void CreateTree(String NodeText)
{
// Create the root node using the default constructor.
TreeNode root = new TreeNode();
root.Text = NodeText;
// Use the ChildNodes property of the root TreeNode to add child nodes.
// Create the node using the constructor that takes the text parameter.
root.ChildNodes.Add(new TreeNode("Topic 1"));
// Create the node using the constructor that takes the text and value parameters.
root.ChildNodes.Add(new TreeNode("Topic 2", "Value 2"));
// Create the node using the constructor that takes the text, value,
// and imageUrl parameters.
root.ChildNodes.Add(new TreeNode("Topic 3", "Value 3", "Image1.jpg"));
// Create the node using the constructor that takes the text, value,
// imageUrl, navigateUrl, and target parameters.
root.ChildNodes.Add(new TreeNode("Topic 4", "Value 4", "Image1.jpg", "http://www.microsoft.com", "_blank"));
// Add the root node to the Nodes collection of the TreeView control.
DynamicTreeView.Nodes.Add(root);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNode Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNode Constructor Example</h3>
<asp:TreeView id="DynamicTreeView"
EnableClientScript="false"
ExpandDepth="2"
runat="server">
</asp:TreeView>
</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">
<script runat="server">
Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
If Not IsPostBack Then
' Add the first tree to the TreeView control.
CreateTree("Section 1")
' Add the second tree to the TreeView control.
CreateTree("Section 2")
End If
End Sub
Sub CreateTree(ByVal NodeText As String)
' Create the root node using the default constructor.
Dim root As TreeNode = New TreeNode
root.Text = NodeText
' Use the ChildNodes property of the root TreeNode to add child nodes.
' Create the node using the constructor that takes the text parameter.
root.ChildNodes.Add(New TreeNode("Topic 1"))
' Create the node using the constructor that takes the text and value parameters.
root.ChildNodes.Add(New TreeNode("Topic 2", "Value 2"))
' Create the node using the constructor that takes the text, value,
' and imageUrl parameters.
root.ChildNodes.Add(New TreeNode("Topic 3", "Value 3", "Image1.jpg"))
' Create the node using the constructor that takes the text, value,
' imageUrl, navigateUrl, and target parameters.
root.ChildNodes.Add(New TreeNode("Topic 4", "Value 4", "Image1.jpg", "http://www.microsoft.com", "_blank"))
' Add the root node to the Nodes collection of the TreeView control.
DynamicTreeView.Nodes.Add(root)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNode Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNode Constructor Example</h3>
<asp:TreeView id="DynamicTreeView"
EnableClientScript="false"
ExpandDepth="2"
runat="server">
</asp:TreeView>
</form>
</body>
</html>
Remarks
Use this constructor to initialize a new instance of the TreeNode class using the text specified by the text
parameter.
The following table shows the initial property value for an instance of TreeNode.
Property | Initial value |
---|---|
Text | The value of the text parameter. |
See also
Applies to
TreeNode(String, String)
Initializes a new instance of the TreeNode class using the specified text and value.
public:
TreeNode(System::String ^ text, System::String ^ value);
public TreeNode (string text, string value);
new System.Web.UI.WebControls.TreeNode : string * string -> System.Web.UI.WebControls.TreeNode
Public Sub New (text As String, value As String)
Parameters
- value
- String
The supplemental data associated with the node, such as data used for handling postback events.
Examples
The following code example demonstrates how to use this constructor to dynamically add a node to the TreeView control.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Page_Init(Object sender, EventArgs e)
{
if(!IsPostBack)
{
// Add the first tree to the TreeView control.
CreateTree("Section 1");
// Add the second tree to the TreeView control.
CreateTree("Section 2");
}
}
void CreateTree(String NodeText)
{
// Create the root node using the default constructor.
TreeNode root = new TreeNode();
root.Text = NodeText;
// Use the ChildNodes property of the root TreeNode to add child nodes.
// Create the node using the constructor that takes the text parameter.
root.ChildNodes.Add(new TreeNode("Topic 1"));
// Create the node using the constructor that takes the text and value parameters.
root.ChildNodes.Add(new TreeNode("Topic 2", "Value 2"));
// Create the node using the constructor that takes the text, value,
// and imageUrl parameters.
root.ChildNodes.Add(new TreeNode("Topic 3", "Value 3", "Image1.jpg"));
// Create the node using the constructor that takes the text, value,
// imageUrl, navigateUrl, and target parameters.
root.ChildNodes.Add(new TreeNode("Topic 4", "Value 4", "Image1.jpg", "http://www.microsoft.com", "_blank"));
// Add the root node to the Nodes collection of the TreeView control.
DynamicTreeView.Nodes.Add(root);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNode Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNode Constructor Example</h3>
<asp:TreeView id="DynamicTreeView"
EnableClientScript="false"
ExpandDepth="2"
runat="server">
</asp:TreeView>
</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">
<script runat="server">
Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
If Not IsPostBack Then
' Add the first tree to the TreeView control.
CreateTree("Section 1")
' Add the second tree to the TreeView control.
CreateTree("Section 2")
End If
End Sub
Sub CreateTree(ByVal NodeText As String)
' Create the root node using the default constructor.
Dim root As TreeNode = New TreeNode
root.Text = NodeText
' Use the ChildNodes property of the root TreeNode to add child nodes.
' Create the node using the constructor that takes the text parameter.
root.ChildNodes.Add(New TreeNode("Topic 1"))
' Create the node using the constructor that takes the text and value parameters.
root.ChildNodes.Add(New TreeNode("Topic 2", "Value 2"))
' Create the node using the constructor that takes the text, value,
' and imageUrl parameters.
root.ChildNodes.Add(New TreeNode("Topic 3", "Value 3", "Image1.jpg"))
' Create the node using the constructor that takes the text, value,
' imageUrl, navigateUrl, and target parameters.
root.ChildNodes.Add(New TreeNode("Topic 4", "Value 4", "Image1.jpg", "http://www.microsoft.com", "_blank"))
' Add the root node to the Nodes collection of the TreeView control.
DynamicTreeView.Nodes.Add(root)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNode Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNode Constructor Example</h3>
<asp:TreeView id="DynamicTreeView"
EnableClientScript="false"
ExpandDepth="2"
runat="server">
</asp:TreeView>
</form>
</body>
</html>
Remarks
Use this constructor to initialize a new instance of the TreeNode class using the text and value specified by the text
and value
parameters, respectively.
The following table shows initial property values for an instance of TreeNode.
Property | Initial value |
---|---|
Text | The value of the text parameter. |
Value | The value of the value parameter. |
See also
Applies to
TreeNode(TreeView, Boolean)
Initializes a new instance of the TreeNode class using the specified owner.
protected public:
TreeNode(System::Web::UI::WebControls::TreeView ^ owner, bool isRoot);
protected internal TreeNode (System.Web.UI.WebControls.TreeView owner, bool isRoot);
new System.Web.UI.WebControls.TreeNode : System.Web.UI.WebControls.TreeView * bool -> System.Web.UI.WebControls.TreeNode
Protected Friend Sub New (owner As TreeView, isRoot As Boolean)
Parameters
See also
Applies to
TreeNode(String, String, String)
Initializes a new instance of the TreeNode class using the specified text, value, and image URL.
public:
TreeNode(System::String ^ text, System::String ^ value, System::String ^ imageUrl);
public TreeNode (string text, string value, string imageUrl);
new System.Web.UI.WebControls.TreeNode : string * string * string -> System.Web.UI.WebControls.TreeNode
Public Sub New (text As String, value As String, imageUrl As String)
Parameters
- value
- String
The supplemental data associated with the node, such as data used for handling postback events.
- imageUrl
- String
The URL to an image that is displayed next to the node.
Examples
The following code example demonstrates how to use this constructor to dynamically add a node to the TreeView control.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Page_Init(Object sender, EventArgs e)
{
if(!IsPostBack)
{
// Add the first tree to the TreeView control.
CreateTree("Section 1");
// Add the second tree to the TreeView control.
CreateTree("Section 2");
}
}
void CreateTree(String NodeText)
{
// Create the root node using the default constructor.
TreeNode root = new TreeNode();
root.Text = NodeText;
// Use the ChildNodes property of the root TreeNode to add child nodes.
// Create the node using the constructor that takes the text parameter.
root.ChildNodes.Add(new TreeNode("Topic 1"));
// Create the node using the constructor that takes the text and value parameters.
root.ChildNodes.Add(new TreeNode("Topic 2", "Value 2"));
// Create the node using the constructor that takes the text, value,
// and imageUrl parameters.
root.ChildNodes.Add(new TreeNode("Topic 3", "Value 3", "Image1.jpg"));
// Create the node using the constructor that takes the text, value,
// imageUrl, navigateUrl, and target parameters.
root.ChildNodes.Add(new TreeNode("Topic 4", "Value 4", "Image1.jpg", "http://www.microsoft.com", "_blank"));
// Add the root node to the Nodes collection of the TreeView control.
DynamicTreeView.Nodes.Add(root);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNode Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNode Constructor Example</h3>
<asp:TreeView id="DynamicTreeView"
EnableClientScript="false"
ExpandDepth="2"
runat="server">
</asp:TreeView>
</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">
<script runat="server">
Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
If Not IsPostBack Then
' Add the first tree to the TreeView control.
CreateTree("Section 1")
' Add the second tree to the TreeView control.
CreateTree("Section 2")
End If
End Sub
Sub CreateTree(ByVal NodeText As String)
' Create the root node using the default constructor.
Dim root As TreeNode = New TreeNode
root.Text = NodeText
' Use the ChildNodes property of the root TreeNode to add child nodes.
' Create the node using the constructor that takes the text parameter.
root.ChildNodes.Add(New TreeNode("Topic 1"))
' Create the node using the constructor that takes the text and value parameters.
root.ChildNodes.Add(New TreeNode("Topic 2", "Value 2"))
' Create the node using the constructor that takes the text, value,
' and imageUrl parameters.
root.ChildNodes.Add(New TreeNode("Topic 3", "Value 3", "Image1.jpg"))
' Create the node using the constructor that takes the text, value,
' imageUrl, navigateUrl, and target parameters.
root.ChildNodes.Add(New TreeNode("Topic 4", "Value 4", "Image1.jpg", "http://www.microsoft.com", "_blank"))
' Add the root node to the Nodes collection of the TreeView control.
DynamicTreeView.Nodes.Add(root)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNode Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNode Constructor Example</h3>
<asp:TreeView id="DynamicTreeView"
EnableClientScript="false"
ExpandDepth="2"
runat="server">
</asp:TreeView>
</form>
</body>
</html>
Remarks
Use this constructor to initialize a new instance of the TreeNode class using the text, value, and image URL specified by the text
, value
, and imageUrl
parameters, respectively.
The following table shows initial property values for an instance of TreeNode.
Property | Initial value |
---|---|
Text | The value of the text parameter. |
Value | The value of the value parameter. |
ImageUrl | The value of the imageUrl parameter. |
See also
Applies to
TreeNode(String, String, String, String, String)
Initializes a new instance of the TreeNode class using the specified text, value, image URL, navigation URL, and target.
public:
TreeNode(System::String ^ text, System::String ^ value, System::String ^ imageUrl, System::String ^ navigateUrl, System::String ^ target);
public TreeNode (string text, string value, string imageUrl, string navigateUrl, string target);
new System.Web.UI.WebControls.TreeNode : string * string * string * string * string -> System.Web.UI.WebControls.TreeNode
Public Sub New (text As String, value As String, imageUrl As String, navigateUrl As String, target As String)
Parameters
- value
- String
The supplemental data associated with the node, such as data used for handling postback events.
- imageUrl
- String
The URL to an image that is displayed next to the node.
- navigateUrl
- String
The URL to link to when the node is clicked.
- target
- String
The target window or frame in which to display the Web page content linked to when the node is clicked.
Examples
The following code example demonstrates how to use this constructor to dynamically add a node to the TreeView control.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Page_Init(Object sender, EventArgs e)
{
if(!IsPostBack)
{
// Add the first tree to the TreeView control.
CreateTree("Section 1");
// Add the second tree to the TreeView control.
CreateTree("Section 2");
}
}
void CreateTree(String NodeText)
{
// Create the root node using the default constructor.
TreeNode root = new TreeNode();
root.Text = NodeText;
// Use the ChildNodes property of the root TreeNode to add child nodes.
// Create the node using the constructor that takes the text parameter.
root.ChildNodes.Add(new TreeNode("Topic 1"));
// Create the node using the constructor that takes the text and value parameters.
root.ChildNodes.Add(new TreeNode("Topic 2", "Value 2"));
// Create the node using the constructor that takes the text, value,
// and imageUrl parameters.
root.ChildNodes.Add(new TreeNode("Topic 3", "Value 3", "Image1.jpg"));
// Create the node using the constructor that takes the text, value,
// imageUrl, navigateUrl, and target parameters.
root.ChildNodes.Add(new TreeNode("Topic 4", "Value 4", "Image1.jpg", "http://www.microsoft.com", "_blank"));
// Add the root node to the Nodes collection of the TreeView control.
DynamicTreeView.Nodes.Add(root);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNode Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNode Constructor Example</h3>
<asp:TreeView id="DynamicTreeView"
EnableClientScript="false"
ExpandDepth="2"
runat="server">
</asp:TreeView>
</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">
<script runat="server">
Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
If Not IsPostBack Then
' Add the first tree to the TreeView control.
CreateTree("Section 1")
' Add the second tree to the TreeView control.
CreateTree("Section 2")
End If
End Sub
Sub CreateTree(ByVal NodeText As String)
' Create the root node using the default constructor.
Dim root As TreeNode = New TreeNode
root.Text = NodeText
' Use the ChildNodes property of the root TreeNode to add child nodes.
' Create the node using the constructor that takes the text parameter.
root.ChildNodes.Add(New TreeNode("Topic 1"))
' Create the node using the constructor that takes the text and value parameters.
root.ChildNodes.Add(New TreeNode("Topic 2", "Value 2"))
' Create the node using the constructor that takes the text, value,
' and imageUrl parameters.
root.ChildNodes.Add(New TreeNode("Topic 3", "Value 3", "Image1.jpg"))
' Create the node using the constructor that takes the text, value,
' imageUrl, navigateUrl, and target parameters.
root.ChildNodes.Add(New TreeNode("Topic 4", "Value 4", "Image1.jpg", "http://www.microsoft.com", "_blank"))
' Add the root node to the Nodes collection of the TreeView control.
DynamicTreeView.Nodes.Add(root)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNode Constructor Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNode Constructor Example</h3>
<asp:TreeView id="DynamicTreeView"
EnableClientScript="false"
ExpandDepth="2"
runat="server">
</asp:TreeView>
</form>
</body>
</html>
Remarks
Use this constructor to initialize a new instance of the TreeNode class using the text, value, image and navigation URLs, and display target specified by the text
, value
, imageUrl
, navigateUrl
, and target
parameters, respectively.
The following table shows initial property values for an instance of TreeNode.
Property | Initial value |
---|---|
Text | The value of the text parameter. |
Value | The value of the value parameter. |
ImageUrl | The value of the imageUrl parameter. |
NavigateUrl | The value of the navigateUrl parameter. |
Target | The value of the target parameter. |