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. Das zweite Codebeispiel enthält XML-Beispieldaten für das erste Codebeispiel.

Im folgenden Beispiel wird veranschaulicht, wie die SelectAction -Eigenschaft verwendet wird, um anzugeben, welches Ereignis ausgelöst wird, wenn auf einen Knoten geklickt wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die XML-Beispieldaten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei namens Book.xml kopieren.


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

Das folgende Codebeispiel enthält XML-Beispieldaten für das vorangehende Codebeispiel.

<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, welche Ereignisse ausgelöst werden, wenn ein Knoten ausgewählt wird.

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 je nach Bedarf das TreeNodeExpanded -Ereignis oder das TreeNodeCollapsed -Ereignis 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

Wird HoverNodeStyle nicht für einen Knoten gerendert, dessen SelectAction -Eigenschaft auf TreeNodeSelectAction.Nonefestgelegt ist.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für:

Freigeben über