Метод SqlMetadataStore.CreateStore (String)

Создает файл хранилища метаданных с заданным именем и местоположением, а также представляющий его объект в хранилище метаданных.

Пространство имен: Microsoft.Synchronization.MetadataStorage
Сборка: Microsoft.Synchronization.MetadataStorage (в microsoft.synchronization.metadatastorage.dll)

Синтаксис

'Декларация
Public Shared Function CreateStore ( _
    fileName As String _
) As SqlMetadataStore
'Применение
Dim fileName As String
Dim returnValue As SqlMetadataStore

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

Параметры

  • fileName
    Путь к файлу и имя файла базы данных. Путь к файлу должен существовать на момент вызова этого метода. Путь к файлу может быть относительным. В этом случае путь задан относительно текущего каталога.

Возвращаемое значение

Объект хранилища метаданных, представляющий базу данных.

Исключения

Тип исключения Условие

ArgumentNullException

Параметр fileName равен пустая ссылка (Nothing в Visual Basic).

ArgumentException

Параметр fileName имеет нулевую длину.

PathTooLongException

Длина параметра fileName превышает 260 символов.

DirectoryNotFoundException

Каталог, указанный в параметре fileName, не существует.

MetadataStorageEngineException

Не удалось создать хранилище метаданных.

Замечания

Этот метод создает новое хранилище метаданных. Чтобы открыть существующее хранилище метаданных, используйте метод OpenStore.

Этот метод использует CurrentCulture в качестве локаля для файла базы данных.

Security noteБезопасность Примечание.

Файл метаданных не защищен от несанкционированного доступа. Чтобы защитить файл метаданных, необходимо соответствующим образом защитить папку, в которой он находится, например, с помощью списка управления доступом на уровне пользователей (DACL). Чтобы пользователь мог удалить файл метаданных, поставщик должен при создании файла разместить его в месте, куда пользователь имеет доступ. Поставщик, создавший файл метаданных, должен удалить его при собственном удалении.

Security noteБезопасность Примечание.

Если платформа Sync Framework открывает файл метаданных с использованием удаленного механизма, такого как путь в формате UNC, одновременный доступ к нему не может быть получен ни одним приложением ни на одном компьютере, включая приложение на компьютере, где хранится файл метаданных.

См. также

Справочник

Класс SqlMetadataStore
Элементы SqlMetadataStore
Пространство имен Microsoft.Synchronization.MetadataStorage