FileBackedMetadataCatalog class

Implements the IMetadataCatalog interface and provides a location in memory to store the metadata.


Namespace:  Microsoft.SharePoint.BusinessData.MetadataModel
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

[SharePointPermissionAttribute(SecurityAction.Demand, ObjectModel = true)]
public sealed class FileBackedMetadataCatalog : MarshalByRefObject, 
	IMetadataCatalog, IDisposable

FileBackedMetadataCatalog provides methods to import BDC models. The loaded metadata will not be persisted and will be lost when the catalog is disposed. FileBackedMetadataCatalog allows applications to use BDC without the need for SharePoint Foundation infrastructure or Office add-ins. The application should maintain the permanent storage for the BDC models, as FileBackedMetadataCatalog is transient.

FileBackedMetadataCatalog allows only a single version of an external content type to be present at any given time, and will retain only the latest version.

FileBackedMetadataCatalog does not offer external item caching or metadata administration capabilities.

BDC will only perform a minimal set of validations when importing BDC models into this catalog for performance reasons. Therefore, the models to be imported into this catalog should be verified by other means. To ensure maximum validation and compatibility with the BDC models that will be imported into this catalog, it is recommended that you export these models first from the AdministrationMetadataCatalog, which validates the imported models and metadata that was modified through its administration capabilities. Exporting models from the AdministrationMetadataCatalog will also generate models that are more compatible with other catalogs by removing unnecessary attributes and adding information about the assumptions made by the AdministrationMetadataCatalog to ensure consistent experience with other catalogs.

Caution noteCaution

Object instances obtained from an instance of FileBackedMetadataCatalog can only be used with object instances obtained from the same instance of FileBackedMetadataCatalog. Using incompatible object instances with each other causes data corruption and other unexpected behavior.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.