FileBackedMetadataCatalog Class
Implements the IMetadataCatalog interface and provides an in-memory metadata store.
Inheritance Hierarchy
System.Object
System.MarshalByRefObject
Microsoft.Office.BusinessData.MetadataModel.FileBackedMetadataCatalog
Namespace: Microsoft.Office.BusinessData.MetadataModel
Assembly: Microsoft.Office.BusinessData (in Microsoft.Office.BusinessData.dll)
Syntax
'Declaration
Public NotInheritable Class FileBackedMetadataCatalog _
Inherits MarshalByRefObject _
Implements IMetadataCatalog, IDisposable
'Usage
Dim instance As FileBackedMetadataCatalog
public sealed class FileBackedMetadataCatalog : MarshalByRefObject,
IMetadataCatalog, IDisposable
Remarks
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.
Note
FileBackedMetadataCatalog does not work on the client with external systems that use claims-based authentication to authenticate users.
Warning
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.
Examples
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.