Retrieves the value of a PropertyEngineObject property that holds an IndependentObject object by making a roundtrip to the server using an optional property filter. If this method is called by a property that holds a DependentObject, an error will be thrown.


Namespace: FileNet.Api.Property
Assembly: FileNet.Api (in filenet.api.dll)

Syntax

Visual Basic (Declaration)
Function FetchIndependentObject( _ 
   ByVal filter As PropertyFilter _ 
) As IIndependentObject
C#
IIndependentObject FetchIndependentObject(
   PropertyFilter filter
)
C++
IIndependentObject FetchIndependentObject(
   PropertyFilter filter
) abstract 
J#
IIndependentObject FetchIndependentObject(
   PropertyFilter filter
)
JScript
function FetchIndependentObject(
   filter : PropertyFilter
) : IIndependentObject

Parameters

filter
A PropertyFilter object that represents information for controlling which property values (and with what level of detail and recursion) to return. If null, this method returns values for all non-object properties and returns placeholders for all object-valued properties (PropertyEngineObject properties with a state of PropertyState.UNEVALUATED or PropertyState.REFERENCE); any subsequent attempts to access an object-valued property will cause an automatic round-trip to the server to fetch its value.

Return Value

An IndependentObject object.

Exceptions

Exception TypeCondition
API_METHOD_NO_DEPENDENT_SUPPORT Thrown if an attempt is made to retrieve a DependentObject object.

See Also