TreeNode Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Denetimdeki TreeView bir düğümü temsil eder.

public ref class TreeNode : ICloneable, System::Web::UI::IStateManager

public class TreeNode : ICloneable, System.Web.UI.IStateManager

type TreeNode = class
    interface IStateManager
    interface ICloneable

Public Class TreeNode
Implements ICloneable, IStateManager

Devralma: Object
TreeNode

Uygulamalar: ICloneable IStateManager

Örnekler

Aşağıdaki kod örneğinde, bir sonraki kod örneği için çerçevelerin nasıl ayarlanacağı gösterilmektedir.


<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>TreeView Frameset Example</title>
</head>
         
    <frameset cols="30%, 75%">
   
        <frame title="MenuFrame" name="Menu" src="TreeViewFramecs.aspx"/>
        <frame title="ContentFrame" name="Content" src="Home.aspx"/> 
           
    </frameset>      
   
</html>


<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>TreeView Frameset Example</title>
</head>
         
    <frameset cols="30%, 75%">
   
        <frame title="MenuFrame" name="Menu" src="TreeViewFramevb.aspx"/>
        <frame title="ContentFrame" name="Content" src="Home.aspx"/> 
           
    </frameset>      
   
</html>

Aşağıdaki kod örneği, denetimde nesne oluşturmak TreeNode için bildirim temelli söz diziminin TreeView nasıl kullanılacağını gösterir. Bu örnek, içindekiler tablosunu görüntülemek için önceki örneğin çerçeve kümesi içinde kullanılır.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView Declarative Syntax Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView Declarative Syntax Example</h3>
      
      <asp:TreeView id="SampleTreeView" 
        runat="server">
         
        <Nodes>
        
          <asp:TreeNode Value="Home" 
            NavigateUrl="Home.aspx" 
            Text="Home"
            Target="Content" 
            Expanded="True">
             
            <asp:TreeNode Value="Page 1" 
              NavigateUrl="Page1.aspx" 
              Text="Page1"
              Target="Content">
               
              <asp:TreeNode Value="Section 1" 
                NavigateUrl="Section1.aspx" 
                Text="Section 1"
                Target="Content"/>
                 
            </asp:TreeNode>              
            
            <asp:TreeNode Value="Page 2" 
              NavigateUrl="Page2.aspx"
              Text="Page 2"
              Target="Content">
               
            </asp:TreeNode> 
            
          </asp:TreeNode>
        
        </Nodes>
        
      </asp:TreeView>

    </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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView Declarative Syntax Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView Declarative Syntax Example</h3>
      
      <asp:TreeView id="SampleTreeView" 
        runat="server">
         
        <Nodes>
        
          <asp:TreeNode Value="Home" 
            NavigateUrl="Home.aspx" 
            Text="Home"
            Target="Content" 
            Expanded="True">
             
            <asp:TreeNode Value="Page 1" 
              NavigateUrl="Page1.aspx" 
              Text="Page1"
              Target="Content">
               
              <asp:TreeNode Value="Section 1" 
                NavigateUrl="Section1.aspx" 
                Text="Section 1"
                Target="Content"/>
                 
            </asp:TreeNode>              
            
            <asp:TreeNode Value="Page 2" 
              NavigateUrl="Page2.aspx"
              Text="Page 2"
              Target="Content">
               
            </asp:TreeNode> 
            
          </asp:TreeNode>
        
        </Nodes>
        
      </asp:TreeView>

    </form>
  </body>
</html>

Açıklamalar

Denetim TreeView düğümlerden oluşur. Ağaçtaki her giriş düğüm olarak adlandırılır ve bir TreeNode nesneyle temsil edilir. Diğer düğümleri içeren düğüme üst düğüm adı verilir. Başka bir düğümün içerdiği düğüme alt düğüm adı verilir. Alt düğümü olmayan bir düğüme yaprak düğüm adı verilir. Başka bir düğüm tarafından kapsanmayan ancak diğer tüm düğümlerin atası olan bir düğüm kök düğümdür. Düğüm hem üst hem de alt düğüm olabilir, ancak kök, üst ve yaprak düğümler birbirini dışlar. Düğümlerin çeşitli görsel ve davranış özellikleri, düğümün kök, üst veya yaprak düğüm olup olmadığına göre belirlenir.

Tipik bir ağaçta yalnızca bir kök düğüm olsa da, TreeView denetim ağaç yapınıza birden çok kök düğüm eklemenize olanak tanır. Bu, ürün kategorileri listesinde olduğu gibi tek bir ana kök düğüm görüntülemeden öğe listelerini görüntülemek istediğinizde kullanışlıdır.

Bir düğüm öncelikli olarak verileri özelliği ve özelliği olmak üzere iki özellikte Text depolar Value . özelliğinin Text değeri denetimde TreeView görüntülenir ve Value özellik, geri gönderme olaylarını işlemek için kullanılan veriler gibi düğümle ilgili ek verileri depolamak için kullanılır. Düğüm ayrıca düğümden kök düğümüne giden yolu özelliğinde ValuePath depolar. ValuePath özelliği, düğümün kök düğüme göre konumunu gösterir.

Not

Aynı düzeydeki düğümlerin her birinin özelliği için Value benzersiz bir değere sahip olması gerekir; TreeView denetim aynı değere sahip aynı düzeydeki farklı düğümleri ayırt edemez. Bu senaryoda, kullanıcı yinelenen değere sahip bir düğüme tıklarsa, denetimde TreeView ilk görüntülenen düğüm seçilir.

Bir TreeNode nesne, özelleştirilebilen veya gizlenebilen aşağıdaki dört kullanıcı arabirimi (UI) öğesinden oluşur:

Düğümün genişletilip genişletilemez, daraltılmış veya genişletilemez olduğunu göstermek için kullanılan genişletme düğümü göstergesi simgesi.
Düğümle ilişkilendirilmiş isteğe bağlı bir onay kutusu.
İsteğe bağlı bir düğüm görüntüsü.
Düğüm metni.

Sınıfının , CollapseImageUrlve NoExpandImageUrl özelliklerini TreeView ayarlayarak ExpandImageUrlgenişletilebilir, daraltılabilir ve genişletilemeyen düğüm göstergeleri için özel bir görüntü belirtebilirsiniz. Genişletme düğümü gösterge simgeleri, sınıfının falseözelliği olarak ayarlanarak ShowExpandCollapse tamamen gizlenebilirTreeView.

Düğümün yanındaki onay kutusunu görüntülemek için sınıfının özelliğini TreeView ayarlayınShowCheckBoxes. ShowCheckBoxes özelliği dışında TreeNodeType.Nodebir değere ayarlandığında, belirtilen düğüm türünün yanında onay kutuları görüntülenir. Düğümün özelliğini ayarlayarak ShowCheckBox tek bir düğümün onay kutusunu seçmeli olarak geçersiz kılabilirsiniz. Onay kutusu görüntülendiğinde, onay kutusunun seçili olup olmadığını belirlemek için özelliğini kullanın Checked .

özelliğini ayarlayarak ImageUrl bir görüntüyü düğümde görüntüleyebilirsiniz. Bu görüntü düğüm metninin yanında görüntülenir.

Denetimdeki bir düğümün TreeView metni iki moddan birinde olabilir: seçim modu veya gezinti modu. Varsayılan olarak, bir düğüm seçim modundadır. Bir düğümü gezinti moduna almak için düğümün NavigateUrl özelliğini boş dize ("") dışında bir değere ayarlayın. Bir düğümü seçim moduna almak için düğümün NavigateUrl özelliğini boş bir dize olarak ayarlayın.

Not

Bazı İnternet tarayıcılarında denetimin performansını TreeView etkileyebilecek bir sınırlama vardır. Örneğin, Microsoft Internet Explorer 6.0'ın 2067 karakterlik bir URL karakter sınırı vardır. Bir düğümün URL'sindeki karakter sayısı bu sayıdan büyükse, bu düğümü genişletme işlemi başarısız olur ve özel durum oluşturmaz.

Varsayılan olarak, seçim modundaki bir düğüme tıklandığında sayfa sunucuya geri gönderilir ve olayı tetikler SelectedNodeChanged . İsteğe bağlı olarak düğümün SelectAction özelliğini ayarlayarak farklı bir olay belirtebilirsiniz. Daha fazla bilgi için bkz. SelectAction. Seçim modunda hangi düğüme tıklandığını belirlemek için denetimin SelectedNode TreeView özelliğini kullanın.

Bir düğüm gezinti modundayken, söz konusu düğüm için tüm seçim olayları devre dışı bırakılır. Gezinti modunda düğüme tıklanması kullanıcıyı belirtilen URL'ye yönlendirir. İsteğe bağlı olarak, bağlı içeriğin görüntüleneceği pencereyi veya çerçeveyi belirtmek için özelliğini ayarlayabilirsiniz Target .

sınıfı, TreeNode düğümün durumunu depolamak için kullanılan birkaç özellik içerir. Bir düğümün Selected seçilip seçilmediğini belirlemek için özelliğini kullanın. Düğümün genişletilip genişletılmediğini belirlemek için özelliğini kullanın Expanded . DataBound özelliği, bir düğümün verilere bağlı olup olmadığını belirlemek için kullanılır. Bir düğüm verilere bağlı olduğunda, özelliğini kullanarak DataItem temel alınan veri öğesine erişebilirsiniz.

sınıfı, bir düğümün ağaçtaki diğer düğümlere göre konumunu belirlemeye yardımcı olan çeşitli özellikler sağlar. Düğümün Depth derinliğini belirlemek için özelliğini kullanın. özelliğini kullanarak ValuePath geçerli düğümden kök düğümüne ayrılmış düğüm listesini alabilirsiniz. Düğümün üst düğümünü belirlemek için özelliğini kullanın Parent . Alt düğümlere koleksiyon kullanılarak ChildNodes erişilir.

Bazen, veri boyutu veya kullanıcı girişine bağlı özel içerik nedeniyle ağaç yapısını statik olarak önceden tanımlı yapmak pratik değildir. Bu nedenle denetim dinamik TreeView düğüm popülasyonunu destekler. Düğüm genişletildiğinde çalışma zamanında doldurulabilir. Zaman uyumsuz olarak oluşturulan düğümleri kalıcı hale getirdiğinizde beklenmeyen davranışlar elde edebilirsiniz. Örneğin, düğümleri zaman uyumsuz olarak doldurmak için bir arka plan çalışan iş parçacığı kullanırsanız, denetim sayfa yaşam döngüsünün geri kalanıyla devam etse de düğüm ağacı hemen doldurulamayabilir. Geri göndermede, denetimin görünüm durumu yüklendiğinde ancak düğüm ağacı tam olarak doldurulmadığında düğümlerin gecikmeli oluşturulması sorunlara neden olabilir. Dinamik düğüm popülasyonu hakkında daha fazla bilgi için özelliğine PopulateOnDemand bakın.

örneğinin ilk özellik değerlerinin TreeNodelistesi için oluşturucuya TreeNode bakın.

Oluşturucular

TreeNode()	Metin veya değer olmadan sınıfın TreeNode yeni bir örneğini başlatır.
TreeNode(String)	Belirtilen metni kullanarak sınıfının yeni bir örneğini TreeNode başlatır.
TreeNode(String, String)	Belirtilen metin ve değeri kullanarak sınıfının yeni bir örneğini TreeNode başlatır.
TreeNode(String, String, String)	Belirtilen metin, değer ve görüntü URL'sini TreeNode kullanarak sınıfın yeni bir örneğini başlatır.
TreeNode(String, String, String, String, String)	Belirtilen metni, değeri, görüntü URL'sini TreeNode , gezinti URL'sini ve hedefi kullanarak sınıfın yeni bir örneğini başlatır.
TreeNode(TreeView, Boolean)	Belirtilen sahibi kullanarak sınıfının yeni bir örneğini TreeNode başlatır.

Özellikler

Checked	Düğümün onay kutusunun seçili olup olmadığını gösteren bir değer alır veya ayarlar.
ChildNodes	Geçerli düğümün birinci düzey alt düğümlerini içeren bir TreeNodeCollection koleksiyon alır.
DataBound	Düğümün veri bağlaması aracılığıyla oluşturulup oluşturulmadığını gösteren bir değer alır.
DataItem	Denetime bağlı veri öğesini alır.
DataPath	Düğüme bağlı verilerin yolunu alır.
Depth	Düğümün derinliğini alır.
Expanded	Düğümün genişletilip genişletildiğini belirten bir değer alır veya ayarlar.
ImageToolTip	Düğümün yanında görüntülenen görüntünün Araç İpucu metnini alır veya ayarlar.
ImageUrl	Düğümün yanında görüntülenen görüntünün URL'sini alır veya ayarlar.
IsTrackingViewState	Düğümün görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır.
NavigateUrl	Düğüme tıklandığında gidilen URL'yi alır veya ayarlar.
Parent	Geçerli düğümün üst düğümünü alır.
PopulateOnDemand	Düğümün dinamik olarak doldurulup doldurulmadığını belirten bir değer alır veya ayarlar.
SelectAction	Bir düğüm seçildiğinde tetiklenecek olayı veya olayları alır veya ayarlar.
Selected	Düğümün seçili olup olmadığını gösteren bir değer alır veya ayarlar.
ShowCheckBox	Düğümün yanında bir onay kutusunun görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.
Target	Düğümle ilişkili Web sayfası içeriğinin görüntüleneceği hedef pencereyi veya çerçeveyi alır veya ayarlar.
Text	Denetimdeki düğüm TreeView için görüntülenen metni alır veya ayarlar.
ToolTip	Düğüm için Araç İpucu metnini alır veya ayarlar.
Value	Geri gönderme olaylarını işlemek için kullanılan veriler gibi düğümle ilgili ek verileri depolamak için kullanılan görüntülenmeyen bir değeri alır veya ayarlar.
ValuePath	Kök düğümden geçerli düğüme giden yolu alır.

Yöntemler

Clone()	Geçerli TreeNode örneğin özellikleriyle sınıfının yeni bir örneğini TreeNode oluşturur.
Collapse()	Geçerli ağaç düğümünü daraltıyor.
CollapseAll()	Geçerli düğümü ve tüm alt düğümlerini daraltıyor.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Expand()	Geçerli ağaç düğümünü genişletir.
ExpandAll()	Geçerli düğümü ve tüm alt düğümlerini genişletir.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
LoadViewState(Object)	Düğümün önceden kaydedilmiş görünüm durumunu yükler.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
RenderPostText(HtmlTextWriter)	Denetim geliştiricilerinin düğüme ek işleme eklemesine izin verir.
RenderPreText(HtmlTextWriter)	Denetim geliştiricilerinin düğüme ek işleme eklemesine izin verir.
SaveViewState()	Düğümün geçerli görünüm durumunu kaydeder.
Select()	Denetimdeki geçerli düğümü TreeView seçer.
ToggleExpandState()	Düğümün genişletilmiş ve daraltılmış durumu arasında geçişler.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TrackViewState()	Düğümdeki görünüm durumu değişikliklerini izlemeye ve kaydetmeye başlamak için başlangıç noktasını işaretler.

Belirtik Arabirim Kullanımları

ICloneable.Clone()	Nesnenin TreeNode bir kopyasını oluşturur.
IStateManager.IsTrackingViewState	Bu üyenin açıklaması için bkz IsTrackingViewState. .
IStateManager.LoadViewState(Object)	Düğümün daha önce kaydedilmiş görünüm durumunu yükler.
IStateManager.SaveViewState()	Görünüm durumu değişikliklerini bir Objectolarak kaydeder.
IStateManager.TrackViewState()	Nesneye görünüm durumundaki TreeNode değişiklikleri izlemesini bildirir.

Şunlara uygulanır