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 gli eventi da generare quando si seleziona un nodo a cui è 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 valori di TreeNodeSelectAction. Il valore predefinito è TreeNodeSelectAction.Select
.
Esempio
In questa sezione sono riportati due esempi di codice. Nel primo esempio di codice viene illustrato come utilizzare la SelectAction proprietà per specificare l'evento generato quando si fa clic su un nodo. Nel secondo esempio di codice vengono forniti dati XML di esempio per il primo esempio di codice.
Nell'esempio seguente viene illustrato come utilizzare la SelectAction proprietà per specificare l'evento generato quando si fa clic su un nodo. Per il corretto funzionamento di questo esempio, è 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.
Nota
È 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 o disattiva il nodo tra espanso e compresso. Genera l'evento TreeNodeExpanded o l'evento TreeNodeCollapsed , in base alle esigenze. |
TreeNodeSelectAction.None |
Non genera eventi quando si seleziona un nodo. |
TreeNodeSelectAction.Select |
Genera l'evento SelectedNodeChanged quando viene selezionato un nodo. |
TreeNodeSelectAction.SelectExpand |
Genera gli eventi SelectedNodeChanged e TreeNodeExpanded quando si seleziona un nodo. I nodi vengono espansi e non vengono mai compressi. |
Nota
Il rendering dell'oggetto HoverNodeStyle 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.