TreeNodeBinding.SelectAction Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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.

Ruft das Ereignis bzw. die Ereignisse ab, die ausgelöst werden sollen, wenn ein Knoten ausgewählt wird, auf den das TreeNodeBinding-Objekt angewendet wird, oder legt dieses Ereignis bzw. diese Ereignisse fest.

public:
 property System::Web::UI::WebControls::TreeNodeSelectAction SelectAction { System::Web::UI::WebControls::TreeNodeSelectAction get(); void set(System::Web::UI::WebControls::TreeNodeSelectAction value); };

public System.Web.UI.WebControls.TreeNodeSelectAction SelectAction { get; set; }

member this.SelectAction : System.Web.UI.WebControls.TreeNodeSelectAction with get, set

Public Property SelectAction As TreeNodeSelectAction

Eigenschaftswert

TreeNodeSelectAction

Einer der TreeNodeSelectAction-Werte. Der Standardwert ist TreeNodeSelectAction.Select.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie Die SelectAction Eigenschaft verwendet wird, um anzugeben, welches Ereignis ausgelöst wird, wenn auf einen Knoten geklickt wird. Im zweiten Codebeispiel werden Beispiel-XML-Daten für das erste Codebeispiel bereitgestellt.

Im folgenden Beispiel wird veranschaulicht, wie Mithilfe der SelectAction Eigenschaft angegeben wird, welches Ereignis ausgelöst wird, wenn auf einen Knoten geklickt wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die Beispiel-XML-Daten kopieren, die nach diesem Codebeispiel angegeben wurden, in eine Datei mit dem Namen Book.xml.


<%@ 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 Node_Changed(Object sender, EventArgs e)
  {

    Message.Text = BookTreeView.SelectedNode.Text + " node selected.";

  }

  void Node_Expanded(Object sender, TreeNodeEventArgs e)
  {

    Message.Text = e.Node.Text + " node expanded.";

  }

  void Node_Collapsed(Object sender, TreeNodeEventArgs e)
  {

    Message.Text = "";

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNodeBinding SelectAction Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding SelectAction Example</h3>
    
      <asp:TreeView id="BookTreeView"
        Font-Names= "Arial"
        ForeColor="Blue"
        DataSourceID="BookXmlDataSource"
        EnableClientScript="false" 
        OnSelectedNodeChanged="Node_Changed"
        OnTreeNodeExpanded="Node_Expanded"
        OnTreeNodeCollapsed="Node_Collapsed"   
        runat="server">
        
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            TextField="Title"
            SelectAction="Expand"/>
          <asp:TreeNodeBinding DataMember="Chapter" 
            TextField="Heading"
            SelectAction="Expand"/>
        </DataBindings>
        
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
      
      <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 Node_Changed(ByVal sender As Object, ByVal e As EventArgs)

    Message.Text = BookTreeView.SelectedNode.Text & " node selected."

  End Sub

  Sub Node_Expanded(ByVal sender As Object, ByVal e As TreeNodeEventArgs)

    Message.Text = e.Node.Text & " node expanded."

  End Sub

  Sub Node_Collapsed(ByVal sender As Object, ByVal e As TreeNodeEventArgs)

    Message.Text = ""

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNodeBinding SelectAction Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding SelectAction Example</h3>
    
      <asp:TreeView id="BookTreeView"
        Font-Names= "Arial"
        ForeColor="Blue"
        DataSourceID="BookXmlDataSource"
        EnableClientScript="false" 
        OnSelectedNodeChanged="Node_Changed"
        OnTreeNodeExpanded="Node_Expanded"
        OnTreeNodeCollapsed="Node_Collapsed"   
        runat="server">
        
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            TextField="Title"
            SelectAction="Expand"/>
          <asp:TreeNodeBinding DataMember="Chapter" 
            TextField="Heading"
            SelectAction="Expand"/>
        </DataBindings>
        
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
      
      <br /><br />
      
      <asp:Label id="Message" runat="server"/>
      
    </form>
  </body>
</html>

Im folgenden Codebeispiel werden Beispiel-XML-Daten für das vorherige Codebeispiel bereitgestellt.

<Book Title="Book Title">  
    <Chapter Heading="Chapter 1">  
        <Section Heading="Section 1">  
        </Section>  
        <Section Heading="Section 2">  
        </Section>  
    </Chapter>  
    <Chapter Heading="Chapter 2">  
        <Section Heading="Section 1">  
        </Section>  
    </Chapter>  
    <Appendix Heading="Appendix A">  
    </Appendix>  
</Book>

Hinweise

Wenn das TreeView Steuerelement an eine Datenquelle gebunden ist, verwenden Sie die SelectAction Eigenschaft, um den Wert anzugeben, der an die SelectAction Eigenschaft eines TreeNode Objekts gebunden werden soll. Diese Bindungsbeziehung wirkt sich auf alle TreeNode Objekte aus, auf die das TreeNodeBinding Objekt angewendet wird. Die SelectAction Eigenschaft wird verwendet, um anzugeben, welches Ereignis oder welche Ereignisse ausgelöst werden, wenn ein Knoten ausgewählt ist.

Hinweis

Sie können die SelectAction Eigenschaft selektiv überschreiben, indem Sie die SelectAction Eigenschaft jedes Knotens direkt festlegen.

In der folgenden Tabelle sind die verfügbaren Optionen aufgelistet.

Wert vom Typ `SelectAction`	BESCHREIBUNG
`TreeNodeSelectAction.Expand`	Schaltet den Knoten zwischen erweitert und reduziert um. Löst das TreeNodeExpanded Ereignis oder das TreeNodeCollapsed Ereignis entsprechend aus.
`TreeNodeSelectAction.None`	Löst keine Ereignisse aus, wenn ein Knoten ausgewählt wird.
`TreeNodeSelectAction.Select`	Löst das SelectedNodeChanged-Ereignis aus, wenn ein Knoten ausgewählt wird.
`TreeNodeSelectAction.SelectExpand`	Löst das SelectedNodeChanged-Ereignis und das TreeNodeExpanded-Ereignis aus, wenn ein Knoten ausgewählt wird. Knoten werden nur erweitert, nie reduziert.

Hinweis

Dies HoverNodeStyle wird für einen Knoten nicht gerendert, dessen SelectAction Eigenschaft auf TreeNodeSelectAction.None".

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für: