ICustomDataSet.CreatesReferences Property
Gets a value that indicates if features returned by the dataset are read-only references.
Syntax
public System.Boolean CreatesReferences { get; }Property Value
True if the features are read-only references; False if they are writable.
Remarks
This property has an unfortunate name that does not accurately reflect its purpose but has been kept for backwards compatibility.
The semantics for the possible values are as follows:
True - The CustomDataSetProxy will assume that the features returned by the custom dataset implementation will not be modified. The proxy can therefore safely mark them as read-only (which means any attempt to modify them afterwards will raise an exception) and pass them into an operator chain without cloning them first. A common use case for this scenario is a custom dataset that reads static data stored in an otherwise unsupported data format and maintains its own internal cache of features.
False - The CustomDataSetProxy will always clone the features returned by the custom dataset implementation.
The CreatesReferences property also interacts with how the proxy decides whether features returned by the custom dataset should be disposed automatically or not. Specifically, a custom dataset that implements IMinimizeGarbageCollection will only dispose features if CreatesReferences is False.
Platforms
Windows, Linux, Android