一个
Entity
实例的可观察的集合，其中每个实体都有唯一的ID。
| Name | Type | Description |
|---|---|---|
owner
|
DataSource | CompositeEntityCollection | 可选 创建此集合的数据源（或复合实体集合）。 |
Members
readonly collectionChanged : Event
获取在集合中添加或删除实体时触发的事件。生成的事件是
EntityCollection.collectionChangedEventCallback
。
获取此集合的全局唯一标识符。
readonly owner : DataSource | CompositeEntityCollection
获取此实体集合的所有者，即。创建它的数据源或复合实体集合。
获取此实体集合是否应为显示。如果为true，则仅在以下情况下显示每个实体它自己的show属性也是如此。
readonly values : Array.< Entity >
获取集合中的Entity实例的数组。此数组不应直接修改。
Methods
由
EntityCollection＃collectionChanged
生成的事件的签名。
| Name | Type | Description |
|---|---|---|
collection
|
EntityCollection | 触发事件的集合。 |
added
|
Array.< Entity > |
已添加到集合中的
Entity
实例的数组。
|
removed
|
Array.< Entity > |
从集合中删除的
Entity
实例的数组。
|
changed
|
Array.< Entity > |
已修改的
Entity
实例的数组。
|
add (entity) → Entity
将实体添加到集合中。
| Name | Type | Description |
|---|---|---|
entity
|
Entity | 要添加的实体。 |
Returns:
添加的实体。
Throws:
-
DeveloperError :具有的实体
该集合中已经存在。
computeAvailability () → TimeInterval
计算集合中实体的最大可用性。如果集合包含无限可用数据和非无限数据的混合，它只会返回与非无限数据有关的时间间隔。我摔倒数据是无限的，将返回一个无限的时间间隔。
Returns:
集合中实体的可用性。
如果提供的实体在此集合中，则返回true，否则返回false。
| Name | Type | Description |
|---|---|---|
entity
|
Entity | 实体。 |
Returns:
如果提供的实体在此集合中，则为true，否则为false。
getById (id) → Entity
获取具有指定ID的实体。
| Name | Type | Description |
|---|---|---|
id
|
String | 要检索的实体的ID。 |
Returns:
具有提供的ID的实体；如果ID在集合中不存在，则为未定义。
getOrCreateEntity (id) → Entity
获取具有指定ID的实体或创建它，如果不存在，则将其添加到集合中。
| Name | Type | Description |
|---|---|---|
id
|
String | 要检索或创建的实体的ID。 |
Returns:
新的或现有的对象。
从集合中删除实体。
| Name | Type | Description |
|---|---|---|
entity
|
Entity | 要删除的实体。 |
Returns:
如果已删除该项目，则为true；如果该集合中不存在该项目，则为false。
从集合中删除所有实体。
从集合中删除具有提供的ID的实体。
| Name | Type | Description |
|---|---|---|
id
|
String | 要删除的实体的ID。 |
Returns:
如果已删除项目，则为true；如果集合中不存在具有提供的ID的项目，则为false。
恢复立即引发
EntityCollection＃collectionChanged
事件添加或删除项目时。事件暂停时进行的任何修改调用此函数时，将作为单个事件触发。该函数是引用计数的，并且可以安全地多次调用是
EntityCollection＃resumeEvents
的相应调用。
Throws:
-
DeveloperError :不能在suspendEvents之前调用resumeEvents。
防止引发
EntityCollection＃collectionChanged
事件直到对
EntityCollection＃resumeEvents
进行相应的调用为止这将引发一个涵盖所有已暂停操作的事件。这允许有效地添加和删除许多项目。只要存在，就可以安全地多次调用此函数是
EntityCollection＃resumeEvents
的相应调用。