TreeView.BeginUpdate 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

禁用任何树视图重绘。

C#

public void BeginUpdate ();

示例

下面的代码示例在控件中 TreeView 显示客户信息。 根树节点显示客户名称，子树节点显示分配给每个客户的订单号。 在此示例中，将显示 1，000 个客户，每个订单 15 个。 通过使用和方法取消重新绘制，TreeView创建和绘制TreeNode对象时TreeView会显示等待Cursor。EndUpdate BeginUpdate 此示例要求你有一个 Customer 可以保存对象集合 Order 的对象。 它还要求你有一个在应用程序目录中命名MyWait.cur的游标文件，并且已在应用程序Form目录中创建了控件的TreeView实例。

C#

// The basic Customer class.
public class Customer : System.Object
{
   private string custName = "";
   protected ArrayList custOrders = new ArrayList();

   public Customer(string customername)
   {
      this.custName = customername;
   }

   public string CustomerName
   {      
      get{return this.custName;}
      set{this.custName = value;}
   }

   public ArrayList CustomerOrders 
   {
      get{return this.custOrders;}
   }
} // End Customer class 

// The basic customer Order class.
public class Order : System.Object
{
   private string ordID = "";

   public Order(string orderid)
   {
      this.ordID = orderid;
   }

   public string OrderID
   {      
      get{return this.ordID;}
      set{this.ordID = value;}
   }
} // End Order class

// Create a new ArrayList to hold the Customer objects.
private ArrayList customerArray = new ArrayList(); 

private void FillMyTreeView()
{
   // Add customers to the ArrayList of Customer objects.
   for(int x=0; x<1000; x++)
   {
      customerArray.Add(new Customer("Customer" + x.ToString()));
   }

   // Add orders to each Customer object in the ArrayList.
   foreach(Customer customer1 in customerArray)
   {
      for(int y=0; y<15; y++)
      {
         customer1.CustomerOrders.Add(new Order("Order" + y.ToString()));    
      }
   }

   // Display a wait cursor while the TreeNodes are being created.
   Cursor.Current = new Cursor("MyWait.cur");
        
   // Suppress repainting the TreeView until all the objects have been created.
   treeView1.BeginUpdate();

   // Clear the TreeView each time the method is called.
   treeView1.Nodes.Clear();

   // Add a root TreeNode for each Customer object in the ArrayList.
   foreach(Customer customer2 in customerArray)
   {
      treeView1.Nodes.Add(new TreeNode(customer2.CustomerName));
          
      // Add a child treenode for each Order object in the current Customer object.
      foreach(Order order1 in customer2.CustomerOrders)
      {
         treeView1.Nodes[customerArray.IndexOf(customer2)].Nodes.Add(
           new TreeNode(customer2.CustomerName + "." + order1.OrderID));
      }
   }

   // Reset the cursor to the default for all controls.
   Cursor.Current = Cursors.Default;

   // Begin repainting the TreeView.
   treeView1.EndUpdate();
}

注解

若要在一次 TreeView向项添加一个项时保持性能，请调用该方法 BeginUpdate 。 在调用该方法之前EndUpdate，该方法BeginUpdate可防止控件进行绘制。

将项添加到树视图控件的首选方法是使用 AddRange 方法将树节点项数组添加到树视图。 但是，如果要一次添加项目，请使用 BeginUpdate 该方法防止 TreeView 控件在添加操作期间进行绘制。 若要允许控件恢复绘制，当所有树节点都已添加到树视图时，调用 EndUpdate 该方法。

适用于

另请参阅

• EndUpdate()