TreeNodeBinding.SelectAction Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta l'evento o gli eventi da generare quando viene selezionato un nodo a cui viene applicato l'oggetto TreeNodeBinding .
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
Valore della proprietà
Uno dei TreeNodeSelectAction valori. Il valore predefinito è TreeNodeSelectAction.Select.
Esempio
Questa sezione contiene due esempi di codice. Il primo esempio di codice illustra come usare la SelectAction proprietà per specificare quale evento viene generato quando si fa clic su un nodo. Il secondo esempio di codice fornisce dati XML di esempio per il primo esempio di codice.
Nell'esempio seguente viene illustrato come utilizzare la SelectAction proprietà per specificare quale evento viene generato quando si fa clic su un nodo. Affinché questo esempio funzioni correttamente, è necessario copiare i dati XML di esempio, forniti dopo questo esempio di codice, in un file denominato 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>
Nell'esempio di codice seguente vengono forniti dati XML di esempio per l'esempio di codice precedente.
<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>
Commenti
Quando il TreeView controllo è associato a un'origine dati, utilizzare la SelectAction proprietà per specificare il valore da associare alla SelectAction proprietà di un TreeNode oggetto . Questa relazione di associazione influisce su tutti gli TreeNode oggetti a cui viene applicato l'oggetto TreeNodeBinding . La SelectAction proprietà viene utilizzata per specificare l'evento o gli eventi generati quando viene selezionato un nodo.
Annotazioni
È possibile eseguire l'override selettiva della SelectAction proprietà impostando direttamente la SelectAction proprietà di ogni nodo.
Nella tabella seguente sono elencate le opzioni disponibili.
Valore della proprietà SelectAction |
Descrizione |
|---|---|
TreeNodeSelectAction.Expand |
Attiva/disattiva il nodo tra espanso e compresso. Genera l'evento TreeNodeExpanded o l'evento TreeNodeCollapsed , in base alle esigenze. |
TreeNodeSelectAction.None |
Genera alcun evento quando viene selezionato un nodo. |
TreeNodeSelectAction.Select |
Genera l'evento SelectedNodeChanged quando viene selezionato un nodo. |
TreeNodeSelectAction.SelectExpand |
Genera sia gli SelectedNodeChanged eventi e TreeNodeExpanded quando viene selezionato un nodo. I nodi vengono espansi e non vengono mai compressi. |
Annotazioni
Il HoverNodeStyle rendering di non viene eseguito per un nodo con la relativa SelectAction proprietà impostata su TreeNodeSelectAction.None.
Il valore di questa proprietà viene archiviato nello stato di visualizzazione.