Interface IGeneratorUserDataDescriptor
An interface for type descriptors having the ability to generate other descriptors on the fly.
Inherited Members
Namespace: System.Dynamic.ExpandoObject
Assembly: cs.temp.dll.dll
Syntax
public interface IGeneratorUserDataDescriptor : IUserDataDescriptorMethods
Generate(Type)
Generates a new descriptor for the specified type.
The purpose is to allow a mechanism by which a type descriptor can replace itself with another descriptor for a specific type. For example, descriptors can be created on the fly to support generic types through this mechanism.
The return value should be: null - if this descriptor is simply skipped for the specified type this - acts as if the descriptor was a vanilla descriptor a new descriptor - if a new descriptor should be used in place of this one
It's recommended that instances of descriptors are cached for future references. One possible way, to do the caching is to have the generator register the descriptor through RegisterType(Type, InteropAccessMode, String). In that case, it should query whether the type is exactly registered, through IsTypeRegistered(Type)
NOTE-1 : the search for descriptors does NOT stop with the descriptor returned by this type, but other descriptors (e.g. for interfaces) might still be added.
NOTE-2 : the descriptor generation mechanism is not triggered on an exact match of types.
NOTE-3 : the method is called in the context of a lock over the descriptors registry so no unpredictable changes to the registry can come from other threads during the execution of this method. However this method should not take other locks, to avoid deadlocks.
Declaration
IUserDataDescriptor Generate(Type type)Parameters
|
Type
type
The type. |
Returns
|
IUserDataDescriptor
Null, this object instance or a new descriptor. |