EntityCollection

每個實體具有唯一ID的Entity實例的可觀察集合。

new EntityCollection(owner)

Parameters:

owner ((DataSource | CompositeEntityCollection)) 創建此集合的數據源（或復合實體集合）。

Members

(readonly) collectionChanged : Event

獲取在從集合中添加或刪除實體時觸發的事件。生成的事件是aEntityCollection.collectionChangedEventCallback。

(readonly) id : String

獲取此集合的全局唯一標識符。

(readonly) owner : (DataSource|CompositeEntityCollection)

獲取此實體集合的所有者，即創建它的數據源或復合實體集合。

show : Boolean

獲取是否應顯示此實體集合。如果為真，則僅當每個實體自身的Show屬性也為真時才顯示該實體。

(readonly) values : Array.<Entity>

獲取集合中實體實例的數組。不應直接修改此數組。

Methods

(static) collectionChangedEventCallback(collection, added, removed, changed)

由EntityCollection#collectionChanged生成的事件的簽名。

Parameters:

collection (EntityCollection) 觸發事件的集合。

added (Array.<Entity>) 已添加到集合中的Entity實例的數組。

removed (Array.<Entity>) 已從集合中刪除的Entity實例的數組。

changed (Array.<Entity>) 已修改的Entity實例數組。

add(entity) → {Entity}

向集合中添加實體。

Parameters:

entity (Entity) 要添加的實體。

Throws

DeveloperError : 此集合中已存在的實體。

computeAvailability() → {TimeInterval}

計算集合中實體的最大可用性。如果集合包含無限可用數據和非無限數據的組合，則它將僅返回與非無限數據相關的間隔。如果所有數據都是無限的，則返回無限間隔。

contains(entity) → {Boolean}

如果提供的實體在此集合中，則返回true，否則返回false。

Parameters:

entity (Entity) 實體。

getById(id) → {Entity}

獲取具有指定ID的實體。

Parameters:

id (String) 要檢索的實體的ID。

getOrCreateEntity(id) → {Entity}

獲取具有指定ID的實體，或者創建該實體，如果該實體不存在，則將其添加到集合中。

Parameters:

id (String) 要檢索或創建的實體的ID。

remove(entity) → {Boolean}

從集合中移除實體。

Parameters:

entity (Entity) 要刪除的實體。

removeAll()

從集合中移除所有實體。

removeById(id) → {Boolean}

從集合中刪除具有提供的ID的實體。

Parameters:

id (String) 要刪除的實體的ID。

resumeEvents()

添加或刪除項目時立即恢復引發EntityCollection#collectionChanged事件。當事件被掛起時所做的任何修改都將在調用此函數時作為單個事件觸發。此函數是引用計數的，只要對EntityCollection#resumeEvents有相應的調用，就可以安全地多次調用。

Throws

DeveloperError : Suspendevents之前不能調用ResumeEvents。

suspendEvents()

防止EntityCollection#collectionChanged事件被引發，直到對EntityCollection#resumeEvents進行相應的調用，此時將引發涵蓋所有掛起操作的單個事件。這樣可以有效地添加和刪除許多項目。只要對EntityCollection#resumeEvents有相應的調用，就可以安全地多次調用此函數。