Indicates objects that are independent.

An IndependentObject represents an EngineObject that has its own independent identity. Contrast this with a DependentObject, which is an EngineObject that can only exist within the scope of another object. (An example of this dependency is ContentElement; content elements are scoped to a particular Document object and cannot exist independently.) An IndependentObject can be retrieved from the server with a call to InstantiatingScope.FetchObject or Factory.<classname>.FetchInstance, whereas a DependentObject can only be fetched as a property of an IndependentObject.

An IndependentObject always has an ObjectReference, which can be obtained by calling GetObjectReference. An ObjectReference provides identity information for the object.

When calling the Refresh methods, note that the behavior differs from that of fetch-related methods (FetchProperty and FetchProperties). The fetch-related methods retrieve the object and merge retrieved property information into the current contents of the property cache. The Refresh methods retrieve the object and replace the current contents of the property cache with the retrieved property information.


The following tables list the members exposed by IIndependentObject.

Public Methods

 NameDescription
Public methodFetchPropertiesOverloaded. Retrieves this object from the server and replaces existing information in the property cache with the retrieved information for the properties specified by the filter.

If this object has changed on the server since it was last retrieved, you should call a Refresh method first; otherwise, an error will be thrown.

Public methodFetchPropertyOverloaded. Refreshes this object and retrieves from the server the object referenced by the object-valued property specified by the propertyName parameter and populates its properties according to the filter.
Public methodGetObjectReferenceReturns an object reference that represents the object's identity.

The ID of an independent object is the class name and ID of the object. The ID can be a path, GUID, or name of the object.

Public methodRefreshOverloaded. Retrieves this object from the server and replaces existing information in the property cache with the retrieved property information.
Top

See Also