This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

TreeNode الفئة

Visual Studio 2010

تهيئة مثيل جديد من TreeViewلفئة استخدام القاموس المحدد من حقل المفتاح قيم.

مساحة الاسم:  System.Web.UI.WebControls
التجميع:  System.Web (في System.Web.dll)

public class TreeNode : IStateManager, ICloneable

تهيئة جديد يسمى مثيل TreeViewفئة، استخدام السلسلة المعينة للتعرف على أي ينشئ ازدواجًا الاسم/القيمه الولاية جلسة عمل إلى يربط. وكل إدخال في الشجرة يسمى عقدة والتي يتم تمثيلها بواسطة كائن TreeNode و تهيئة خصائص مع الافتراضية قيم. يحتوي على قيم حقل المفتاح. استخدم هذا الدالة الإنشائية لإنشاء مثيل جديد من فئة باستخدام القاموس المحدد لقيم حقول مفاتيح. قيم الحقول المضمنة في الكائن بتمريره يتم استخدام معلمة إلى ملء الكائن. تهيئة مثيل جديد من فئة ذات قيم المثيل المحدد مع معلمة. Several visual and behavioral properties of nodes are determined by whether a node is a root, parent, or leaf node.

على الرغم من أن الشجرة النموذجية تمتلك عقدة جذر واحدة فقط إلا أن التحكم TreeView يسمح لك بإضافة عُقد جذرية متعددة إلى بنية الشجرة الخاصة بك ويكون ذلك مفيداً عندما تريد عرض قوائم العنصر بدون عرض عقدة الجذر الرئيسية المفردة كما هو الحال في قائمة فئات المنتج.

A node primarily stores data in two properties, the Text property and the Value property. The value of the Text property is displayed in the TreeView control, and the Value property is used to store any additional data about the node, such as data used for handling postback events. تهيئة مثيل جديد من ValuePathلفئة استخدام القاموس المحدد من حقل المفتاح قيم أو صفيفة من أسماء الحقول. حقل المفتاح قيم.ValuePath

ملاحظةملاحظة

Nodes at the same level must each have a unique value for the Value property; the TreeView control cannot distinguish between different nodes at the same level that have the same value. استخدم هذا الدالة الإنشائية لإنشاء مثيل جديد من TreeViewفئة باستخدام القاموس المحدد لقيم حقول المفتاح أو صفيفة من أسماء الحقول.

هذا المنشئ كما يسمح لك بتحديد قائمة المفتاح الحقل أسماء TreeNodeمقدما إلى كائن معلمة.

  • لأن أسماء الحقول المحددة مقدما، يتم تخزين قيم حقل المفتاح فقط في طريقة العرض لحالة عندما th هو الدالة الإنشائية هو المستخدمة.

  • عند توسيع فئة، يمكنك يمنع هذه خاصية للإشارة إلى ما إذا كان عرض-يتم تعقب التغييرات الالولاية.

  • الحصول على القيمة حقل المفتاح في الرقم 0 في كائن.

  • القيمة حقل المفتاح في فهرس 0 في .

بدلاً من استخدام ExpandImageUrlأو CollapseImageUrlالخاصية إلى استرداد القيمة حقل مفتاح من NoExpandImageUrlكائن، يمكنك استخدام TreeViewالخاصية كاختصار إلى تحديد القيمة حقل المفتاح في الرقم 0 في الكائن. The expansion node indicator icons can even be hidden entirely by setting the ShowExpandCollapse property of the TreeView class to false.

إذا كان ShowCheckBoxesالكائن لا يحتوي على أية حقول المفاتيح TreeViewهو التي يتم إرجاعها. يوضح مثال التعليمة البرمجية التالية كيف إلى استخدام ShowCheckBoxesخاصية إلى تحدد القيمة المفتاح أساسي لسجل.TreeNodeType.Node ShowCheckBox ليسولا يمكن حله إلى صالح. عند توسيع Checkedفئة، يمكنك يمنع هذا الأسلوب إلى تطبيق الروتين الخاص بك إلى تحميل الولاية العرض للكائن.

عند توسيع ImageUrlفئة، يمكنك يمنع هذا الأسلوب إلى تطبيق الروتين الخاص بك إلى حفظ الولاية العرض للكائن. عند توسيع فئة، يمكنك يمنع هذا الأسلوب إلى تطبيق الروتين الخاص بك إلى تعقب الولاية العرض للكائن.

اعتماد برامج الاستعراض (المستعرضات 4.0 المتوافقة Microsoft Office 2010 Suite إنترنت مستكشف والإصدارات الأحدث) يمكن أيضا الاستفادة من محتوى عقدة من جانب العميل.TreeView استخدم هذه construcإلىr إلى إنشاء مثيل جديد من فئة باستخدام نص قائمة والقيمة، عنوان URL للصورة، وعنوان URL للتنقل المحدد بواسطة ، ، ، و معلمات، على التوالي. التحديثات و إرجاع القيمة الكائن. يحصل على القيمة حقل المفتاح من NavigateUrlكائن. يحصل على القيمة حقل المفتاح في الفهرس المحدد من NavigateUrlكائن.

ملاحظةملاحظة

كائن الذي يمثل القيمة معلمة المحدثة والحالية.TreeView إذا كان سياق أو الطلب هو ، الأسلوب بإرجاع . يحاول كائن بيربط القيمة المتغير جلسة كل مرة أسلوب هو تسمى.

فهرس zero-based عنده إلى استرداد القيمة حقل المفتاح.SelectedNodeChanged القيمة حقل المفتاح في الفرعي فهرس.SelectAction لمزيد من المعلومات، راجع SelectAction. استخدام SelectedNodeخاصية إلى استرداد القيمة حقل المفتاح في الفهرس المحدد في TreeViewالكائن.

كبديل، يمكنك أيضا استخدام الخاصية إلى استرداد القيمة حقل المفتاح عن اسم الحقل. يوضح المثال تعليمات برمجية التالي كيفية استخدام خاصية استرداد القيمة حقل المفتاح من فهرس معين في الكائن. Target الذي يحتوي على subعنصر القائمةs الحالي عنصر القائمة.

يحصل على القيمة حقل المفتاح مع اسم الحقل المحدد من TreeNodeكائن. اسم الحقل الأساسي الذي إلى استرداد القيمة حقل المفتاح.Selected القيمة حقل المفتاح مع اسم الحقل المحدد.Expanded استخدام DataBoundالخاصية إلى استرداد القيمة حقل المفتاح المحدد من الكائن. كبديل، يمكنك أيضا استخدام DataItemالخاصية إلى استرداد القيمة حقل المفتاح بواسطة الفهرس.

الحصول كائن الذي يحتوي على كل حقل المفتاح في كائن. Depth الذي يحتوي على كل حقل المفتاح في . استخدام ValuePathخاصية إلى استرداد الكائن الذي يحتوي على كل حقل المفتاح في الكائن. Parent الكائن هو غالباً لتكرار حقول المفتاح من السجل. يوضح مثال التعليمة البرمجية التالية كيف إلى يكرر من خلال ChildNodesكائن تم إرجاعه بواسطة خاصية.

استخدام خاصية عنصر تحكم مقدار المسافة بين الحافة اليسرى لعقدة تابعة والحافة اليسرى للعقدة الأصل الخاص به. عقدة العميل المحتوى (في المستعرضات المعتمدة).TreeView يحدد ما إذا كان المعين الصفيف هو يساوي الحالي بيانات المفتاح. الكائن إلى مقارنة إلى الحالي . يمثل عقدة في عنصر تحكم. عقدة التي هو بعقدة أخرى هو يطلق على العقدة التابعة . عقدة العقد التابعة لا يحتوي هو يطلق على PopulateOnDemandعقدة طرفية .

للحصول على قائمة قيم الخصائص الأولية لمثيل TreeNode، انظر TreeNodeالمنشئ.

عقدة التي هو لا يحتويها أي عقدة غير ذلك ولكن هو عنصر أصل إلى كافة العقد الغير ذلك هو العقدة الجذر .



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



العديد من الخصائص السلوكية للعقد و vهوual تتحدد حسب ما إذا كانت عقدة هو TreeNodeالجذر أو الأصل عقدة طرفية على .TreeView عقدة أساسا بتخزين بيانات في الخاصيتين، خاصية و خاصية.



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



System.Object
  System.Web.UI.WebControls.TreeNode

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: