SqlMetadataStore.CreateStore 方法 (String, CultureInfo)

创建一个具有指定名称和位置的元数据存储区文件,然后返回表示该文件的元数据存储区对象。

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

语法

声明
Public Shared Function CreateStore ( _
    fileName As String, _
    locale As CultureInfo _
) As SqlMetadataStore
用法
Dim fileName As String
Dim locale As CultureInfo
Dim returnValue As SqlMetadataStore

returnValue = SqlMetadataStore.CreateStore(fileName, locale)
public static SqlMetadataStore CreateStore (
    string fileName,
    CultureInfo locale
)
public:
static SqlMetadataStore^ CreateStore (
    String^ fileName, 
    CultureInfo^ locale
)
public static SqlMetadataStore CreateStore (
    String fileName, 
    CultureInfo locale
)
public static function CreateStore (
    fileName : String, 
    locale : CultureInfo
) : SqlMetadataStore

参数

  • fileName
    数据库文件的文件路径和文件名。文件路径必须存在才能调用此方法。该文件路径可以是相对路径。在这种情况下,该值为相对于当前目录的路径。
  • locale
    用于创建数据库的区域设置。

返回值

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

异常

异常类型 条件

ArgumentNullException

fileName 或 locale 为 null 引用(在 Visual Basic 中为 Nothing)。

ArgumentException

fileName 的长度为 0。

PathTooLongException

fileName 的长度超过 260 个字符。

DirectoryNotFoundException

fileName 中指定的目录不存在。

MetadataStorageEngineException

无法创建元数据存储区。

备注

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

Security note安全性注意

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

Security note安全性注意

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

请参阅

参考

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