FileBackedMetadataCatalog Class

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

Inheritance Hierarchy


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


<SharePointPermissionAttribute(SecurityAction.Demand, ObjectModel := True)> _
Public NotInheritable Class FileBackedMetadataCatalog _
    Inherits MarshalByRefObject _
    Implements IMetadataCatalog, IDisposable
Dim instance As FileBackedMetadataCatalog
[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.


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.


Code Snippet: Get the FileBackedMetadataCatalog on the Server or Client

Thread Safety

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

See Also


FileBackedMetadataCatalog Members

Microsoft.SharePoint.BusinessData.MetadataModel Namespace