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 命名空间