【零基础 Revit API 教学】 #Day5 - 清单 List 介绍 ( part 2 )

清单 List 介绍（part 2）

昨天已对 “清单 List” 做了初步的介绍，说明了清单 "宣告" 与 “借用记忆体位置” 的语法，接着要继续说明 List 常使用的函式。然而，这些函式与第三天介绍的函式使用方式有些许不同，第三天所介绍的函式可以被单独呼叫，例如 functionA()。但是接下来要介绍的函式，则 必须 接在 List 后面做使用，假设有一个名为 name 的 List，而接续在 List 后做使用的函式 functionB()，其呼叫方式为：name.functionB()。此类型的函式，是为特定的 “类型” 所创建，因此需要在某类型的 物件(变数) 后方呼叫，并且也只能使用在该物件上。

Add()

首先要介绍的函式是 Add()，若要使用 List，就务必要知道这个函式功用，此函式是用来将物件放入清单中。例如，我们有三个物件，分别为 int x、int y、int z，要将这三个物件，放入到名为 intlist 的清单中，其程式表示如下：

// 宣告并初始化物件int x = 1;int y = 2;int z = 3;// 宣告清单并借用记忆体空间List< int > intlist = new List< int >;// 将物件放入清单中intlist.Add(x);intlist.Add(y);intlist.Add(z);

程式执行的先后顺序是由上而下，因此先被放置到清单中的物件x会在第一个位置，而物件y会在第二个位置，以此类推。当我们要取用物件x时，则需要指定我们要取用的清单位置，而使定位置的方法是使用 [] ，如 intlist[1]。

虽然说，Add()这个函式目的是将物件放入清单中，可它实际上放入清单的只有物件的 “值”。若在程式中输入 intlist[1]，则会得到 整数 “1” 这个结果，以无法得知该物件的名称 x。