Retrieves an object of the
class by the specified class identity. This method always makes a round-trip to the server. You can optionally include a filter to control which properties to return with the object. If you pass in
for the
parameter, this method returns values for all non-object properties and returns placeholders for all object-valued properties. For more information, see the description of the
parameter.
Namespace: FileNet.Api.Core
Assembly: FileNet.Api (in filenet.api.dll)
Syntax
Visual Basic (Declaration) |
---|
Public Shared Function FetchInstance( _ ByVal scope As IScope, _ ByVal classIdentity As String, _ ByVal filter As PropertyFilter _ ) As IClassDescription |
C# |
---|
public static IClassDescription FetchInstance( IScope scope, string classIdentity, PropertyFilter filter ) |
C++ |
---|
public: static IClassDescription FetchInstance( IScope scope, String classIdentity, PropertyFilter filter ) |
J# |
---|
public static IClassDescription FetchInstance( IScope scope, string classIdentity, PropertyFilter filter ) |
JScript |
---|
public static
function FetchInstance( scope : IScope, classIdentity : String, filter : PropertyFilter ) : IClassDescription |
Parameters
- scope
- The object to which this
is scoped. For more information, see theClassDescription IScope interface description.
- classIdentity
- A
that identifies the class. The value can be a class ID (in GUID format) or class symbolic name.String
- filter
- A
object that represents information for controlling which property values (and with what level of detail and recursion) to return. IfPropertyFilter
, this method returns values for all non-object properties and returns placeholders for all object-valued properties (null
properties with a state ofPropertyEngineObject
orPropertyState.UNEVALUATED
); any subsequent attempts to access an object-valued property will cause an automatic round-trip to the server to fetch its value.PropertyState.REFERENCE
Return Value
The requested
object.