SqlMetadataStore.OpenStore 方法 (String)

  • 项目

打开现有的具有指定名称和位置的元数据存储区文件，并返回一个表示该文件的元数据存储区对象。

命名空间: Microsoft.Synchronization.MetadataStorage
程序集: Microsoft.Synchronization.MetadataStorage（在 microsoft.synchronization.metadatastorage.dll 中）

语法

声明
Public Shared Function OpenStore ( _
    fileName As String _
) As SqlMetadataStore
用法
Dim fileName As String
Dim returnValue As SqlMetadataStore

returnValue = SqlMetadataStore.OpenStore(fileName)

public static SqlMetadataStore OpenStore (
    string fileName
)

public:
static SqlMetadataStore^ OpenStore (
    String^ fileName
)

public static SqlMetadataStore OpenStore (
    String fileName
)

public static function OpenStore (
    fileName : String
) : SqlMetadataStore

参数

  • fileName
    数据库文件的文件路径和文件名。该文件路径可以是相对路径。在这种情况下，该值为相对于当前目录的路径。

返回值

表示数据库的元数据存储对象。

异常

异常类型 条件

ArgumentNullException

fileName 为 null 引用（在 Visual Basic 中为 Nothing）。

ArgumentException

fileName 的长度为 0。

PathTooLongException

fileName 的长度超过 260 个字符。

FileNotFoundException

fileName 中指定的文件不存在。

MetadataStorageEngineException

fileName 只是一个目录，不包含文件名，或者无法打开元数据存储区。

备注

此方法打开现有的元数据存储区。若要创建新的元数据存储区，请使用 CreateStore。

此方法使用 CurrentCulture 作为数据库文件的区域设置。

Security note安全性注意

元数据文件未受到保护，无法避免未经授权的访问。若要帮助保护元数据文件，必须对包含它的文件夹进行适当的安全设置，例如通过使用任意访问控制列表 (DACL) 来提供保护。若要允许用户删除元数据文件，创建元数据文件的提供程序应将该文件放置于用户可以访问的位置。在卸载创建元数据文件的提供程序时，该提供程序必须删除元数据文件。
Security note安全性注意

在 Sync Framework 通过远程机制（例如 UNC 路径）打开元数据文件时，元数据文件不能同时被任意计算机上的任何其他应用程序访问，包括存储了元数据文件的计算机上的应用程序。

请参阅

参考

SqlMetadataStore 类
SqlMetadataStore 成员
Microsoft.Synchronization.MetadataStorage 命名空间