TreeNodeBinding.SelectAction Eigenschaft

Definition

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.Gets or sets the event or events to raise when a node to which the TreeNodeBinding object is applied is selected.

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.One of the TreeNodeSelectAction values. Der Standardwert ist TreeNodeSelectAction.Select.The default is TreeNodeSelectAction.Select.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele.This section contains two code examples. Im ersten Codebeispiel wird veranschaulicht, wie die- SelectAction Eigenschaft verwendet wird, um anzugeben, welches Ereignis ausgelöst wird, wenn auf einen Knoten geklickt wird.The first code example demonstrates how to use the SelectAction property to specify which event is raised when a node is clicked. Im zweiten Codebeispiel werden Beispiel-XML-Daten für das erste Codebeispiel bereitstellt.The second code example provides sample XML data for the first code example.

Im folgenden Beispiel wird veranschaulicht, wie die- SelectAction Eigenschaft verwendet wird, um anzugeben, welches Ereignis ausgelöst wird, wenn auf einen Knoten geklickt wird.The following example demonstrates how to use the SelectAction property to specify which event is raised when a node is clicked. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die Beispiel-XML-Daten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei mit dem Namen Book.xml kopieren.For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named 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 bereitstellt.The following code example provides sample XML data for the preceding code example.

<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 SelectAction Sie die-Eigenschaft, um den Wert anzugeben, der an die- SelectAction Eigenschaft eines-Objekts gebunden werden soll TreeNode .When the TreeView control is bound to a data source, use the SelectAction property to specify the value to bind to the SelectAction property of a TreeNode object. Diese Bindungs Beziehung wirkt sich TreeNode auf alle Objekte aus, auf die das- TreeNodeBinding Objekt angewendet wird.This binding relationship affects all TreeNode objects to which the TreeNodeBinding object is applied. Mithilfe der- SelectAction Eigenschaft wird angegeben, welches Ereignis oder welche Ereignisse ausgelöst werden, wenn ein Knoten ausgewählt wird.The SelectAction property is used to specify which event or events are raised when a node is selected.

Hinweis

Sie können die-Eigenschaft selektiv überschreiben, SelectAction indem Sie die- SelectAction Eigenschaft der einzelnen Knoten direkt festlegen.You can selectively override the SelectAction property by setting the SelectAction property of each node directly.

In der folgenden Tabelle sind die verfügbaren Optionen aufgelistet.The following table lists the available options.

Wert vom Typ SelectActionSelectAction value BESCHREIBUNGDescription
TreeNodeSelectAction.Expand Schaltet den Knoten zwischen erweitert und reduziert um.Toggles the node between expanded and collapsed. Löst das- TreeNodeExpanded Ereignis oder das- TreeNodeCollapsed Ereignis entsprechend aus.Raises the TreeNodeExpanded event or the TreeNodeCollapsed event, as appropriate.
TreeNodeSelectAction.None Löst keine Ereignisse aus, wenn ein Knoten ausgewählt wird.Raises no events when a node is selected.
TreeNodeSelectAction.Select Löst das SelectedNodeChanged-Ereignis aus, wenn ein Knoten ausgewählt wird.Raises the SelectedNodeChanged event when a node is selected.
TreeNodeSelectAction.SelectExpand Löst das SelectedNodeChanged-Ereignis und das TreeNodeExpanded-Ereignis aus, wenn ein Knoten ausgewählt wird.Raises both the SelectedNodeChanged and TreeNodeExpanded events when a node is selected. Knoten werden nur erweitert und nie reduziert.Nodes are only expanded, never collapsed.

Hinweis

Der HoverNodeStyle wird nicht für einen Knoten SelectAction gerendert, dessen-Eigenschaft auf festgelegt ist TreeNodeSelectAction.None .The HoverNodeStyle is not rendered for a node with its SelectAction property set to TreeNodeSelectAction.None.

Der Wert dieser Eigenschaft wird im Ansichts Zustand gespeichert.The value of this property is stored in view state.

Gilt für:

Siehe auch