TreeView.SelectedNode Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
public:
property System::Web::UI::WebControls::TreeNode ^ SelectedNode { System::Web::UI::WebControls::TreeNode ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.TreeNode SelectedNode { get; }
[<System.ComponentModel.Browsable(false)>]
member this.SelectedNode : System.Web.UI.WebControls.TreeNode
Public ReadOnly Property SelectedNode As TreeNode
Eigenschaftswert
Ein TreeNode, der den ausgewählten Knoten in TreeView darstellt.
- Attribute
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die SelectedNode -Eigenschaft verwendet wird, um den Wert des ausgewählten Knotens TreeView im Steuerelement zu bestimmen.
<%@ 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 Select_Change(Object sender, EventArgs e)
{
Message.Text = "You selected: " + LinksTreeView.SelectedNode.Text;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeView SelectedNodeStyle Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeView SelectedNodeStyle Example</h3>
<asp:TreeView id="LinksTreeView"
Font-Names= "Arial"
ForeColor="Blue"
SelectedNodeStyle-ForeColor="Green"
SelectedNodeStyle-VerticalPadding="0"
OnSelectedNodeChanged="Select_Change"
runat="server">
<LevelStyles>
<asp:TreeNodeStyle ChildNodesPadding="10"
Font-Bold="true"
Font-Size="12pt"
ForeColor="DarkGreen"/>
<asp:TreeNodeStyle ChildNodesPadding="5"
Font-Bold="true"
Font-Size="10pt"/>
<asp:TreeNodeStyle ChildNodesPadding="5"
Font-UnderLine="true"
Font-Size="10pt"/>
<asp:TreeNodeStyle ChildNodesPadding="10"
Font-Size="8pt"/>
</LevelStyles>
<Nodes>
<asp:TreeNode Text="Table of Contents"
SelectAction="None">
<asp:TreeNode Text="Chapter One">
<asp:TreeNode Text="Section 1.0">
<asp:TreeNode Text="Topic 1.0.1"/>
<asp:TreeNode Text="Topic 1.0.2"/>
<asp:TreeNode Text="Topic 1.0.3"/>
</asp:TreeNode>
<asp:TreeNode Text="Section 1.1">
<asp:TreeNode Text="Topic 1.1.1"/>
<asp:TreeNode Text="Topic 1.1.2"/>
<asp:TreeNode Text="Topic 1.1.3"/>
<asp:TreeNode Text="Topic 1.1.4"/>
</asp:TreeNode>
</asp:TreeNode>
<asp:TreeNode Text="Chapter Two">
<asp:TreeNode Text="Section 2.0">
<asp:TreeNode Text="Topic 2.0.1"/>
<asp:TreeNode Text="Topic 2.0.2"/>
</asp:TreeNode>
</asp:TreeNode>
</asp:TreeNode>
<asp:TreeNode Text="Appendix A" />
<asp:TreeNode Text="Appendix B" />
<asp:TreeNode Text="Appendix C" />
</Nodes>
</asp:TreeView>
<br /><br />
<asp:Label id="Message" runat="server"/>
</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 Select_Change(ByVal sender As Object, ByVal e As EventArgs)
Message.Text = "You selected: " & LinksTreeView.SelectedNode.Text
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeView SelectedNodeStyle Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeView SelectedNodeStyle Example</h3>
<asp:TreeView id="LinksTreeView"
Font-Names= "Arial"
ForeColor="Blue"
SelectedNodeStyle-ForeColor="Green"
SelectedNodeStyle-VerticalPadding="0"
OnSelectedNodeChanged="Select_Change"
runat="server">
<LevelStyles>
<asp:TreeNodeStyle ChildNodesPadding="10"
Font-Bold="true"
Font-Size="12pt"
ForeColor="DarkGreen"/>
<asp:TreeNodeStyle ChildNodesPadding="5"
Font-Bold="true"
Font-Size="10pt"/>
<asp:TreeNodeStyle ChildNodesPadding="5"
Font-UnderLine="true"
Font-Size="10pt"/>
<asp:TreeNodeStyle ChildNodesPadding="10"
Font-Size="8pt"/>
</LevelStyles>
<Nodes>
<asp:TreeNode Text="Table of Contents"
SelectAction="None">
<asp:TreeNode Text="Chapter One">
<asp:TreeNode Text="Section 1.0">
<asp:TreeNode Text="Topic 1.0.1"/>
<asp:TreeNode Text="Topic 1.0.2"/>
<asp:TreeNode Text="Topic 1.0.3"/>
</asp:TreeNode>
<asp:TreeNode Text="Section 1.1">
<asp:TreeNode Text="Topic 1.1.1"/>
<asp:TreeNode Text="Topic 1.1.2"/>
<asp:TreeNode Text="Topic 1.1.3"/>
<asp:TreeNode Text="Topic 1.1.4"/>
</asp:TreeNode>
</asp:TreeNode>
<asp:TreeNode Text="Chapter Two">
<asp:TreeNode Text="Section 2.0">
<asp:TreeNode Text="Topic 2.0.1"/>
<asp:TreeNode Text="Topic 2.0.2"/>
</asp:TreeNode>
</asp:TreeNode>
</asp:TreeNode>
<asp:TreeNode Text="Appendix A" />
<asp:TreeNode Text="Appendix B" />
<asp:TreeNode Text="Appendix C" />
</Nodes>
</asp:TreeView>
<br /><br />
<asp:Label id="Message" runat="server"/>
</form>
</body>
</html>
Hinweise
Der Text eines Knotens TreeView im Steuerelement kann sich in einem von zwei Modi befinden: Auswahlmodus und Navigationsmodus. Standardmäßig befindet sich ein Knoten im Auswahlmodus. Um einen Knoten in den Navigationsmodus zu versetzen, legen Sie die NavigateUrl Eigenschaft für den Knoten auf einen anderen Wert als eine leere Zeichenfolge ("") fest. Um einen Knoten in den Auswahlmodus zu versetzen, legen Sie die NavigateUrl Eigenschaft für den Knoten auf leere Zeichenfolge ("") fest.
Wenn sich ein Knoten im Auswahlmodus befindet, kann der Benutzer einen Knoten auswählen, indem er auf den Text im Knoten klickt. Verwenden Sie die SelectedNode -Eigenschaft, um zu bestimmen, welcher Knoten im TreeView Steuerelement ausgewählt ist.
Hinweis
Ein Knoten kann nicht ausgewählt werden, wenn das TreeView Steuerelement Links anzeigt. Wenn Links angezeigt werden, gibt die SelectedNode -Eigenschaft immer zurück null
.
Wenn der Benutzer einen anderen Knoten im TreeView Steuerelement auswählt, indem er auf den Text im neuen Knoten klickt, wird das SelectedNodeChanged -Ereignis standardmäßig ausgelöst. Sie können ein anderes Ereignis angeben, indem Sie die SelectAction -Eigenschaft für die -Eigenschaft festlegen. In der folgenden Tabelle sind die verfügbaren Optionen aufgelistet.
Auswahlaktion | BESCHREIBUNG |
---|---|
Expand | Schaltet den Knoten zwischen erweitert und reduziert um. Löst das - oder TreeNodeCollapsed -TreeNodeExpandedEreignis nach Bedarf aus. |
None | Löst keine Ereignisse aus, wenn ein Knoten ausgewählt wird. |
Select | Löst das SelectedNodeChanged-Ereignis aus, wenn ein Knoten ausgewählt wird. |
SelectExpand | Löst das SelectedNodeChanged-Ereignis und das TreeNodeExpanded-Ereignis aus, wenn ein Knoten ausgewählt wird. Knoten werden nur erweitert, nie reduziert. |
Hinweis
Wird HoverNodeStyle nicht für einen Knoten gerendert, dessen SelectAction -Eigenschaft auf TreeNodeSelectAction.None
festgelegt ist.