Freigeben über


SqlMetadataStore.CreateStore-Methode (String)

Erstellt eine Metadaten-Speicherdatei mit dem angegebenen Namen und Speicherort und gibt ein Metadatenspeicherobjekt zurück, das sie darstellt.

Namespace: Microsoft.Synchronization.MetadataStorage
Assembly: Microsoft.Synchronization.MetadataStorage (in microsoft.synchronization.metadatastorage.dll)

Syntax

'Declaration
Public Shared Function CreateStore ( _
    fileName As String _
) As SqlMetadataStore
'Usage
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

Parameter

  • fileName
    Pfad und Dateiname der Datenbankdatei. Der Dateipfad muss vorhanden sein, bevor diese Methode aufgerufen wird. Der Dateipfad kann ein relativer Pfad sein. In diesem Fall ist er relativ zum aktuellen Verzeichnis.

Rückgabewert

Das Metadatenspeicherobjekt, das die Datenbank darstellt.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

fileName ist NULL.

ArgumentException

fileName hat die Länge 0.

PathTooLongException

fileName ist länger als 260 Zeichen.

DirectoryNotFoundException

Das in fileName angegebene Verzeichnis ist nicht vorhanden.

MetadataStorageEngineException

Der Metadatenspeicher konnte nicht erstellt werden.

Hinweise

Diese Methode erstellt einen neuen Metadatenspeicher. Um einen vorhandenen Metadatenspeicher zu öffnen, verwenden Sie OpenStore.

Diese Methode verwendet CurrentCulture als Gebietsschema für die Datenbankdatei.

Security noteSicherheit Hinweis

Die Metadatendatei ist nicht gegen nicht autorisierten Zugriff gesichert. Um die Metadatendatei zu schützen, muss der Ordner, in dem sie enthalten ist, ordnungsgemäß gesichert werden, beispielsweise mithilfe einer DACL (Discretionary Access Control List). Damit der Benutzer die Metadatendatei löschen kann, sollte der Anbieter, der die Metadatendatei erstellt, sie an einem Ort speichern, auf den der Benutzer zugreifen kann. Wenn der Anbieter, der die Metadatendatei erstellt, deinstalliert wird, muss er die Metadatendatei löschen.

Security noteSicherheit Hinweis

Wenn Sync Framework die Metadatendatei über einen Remotemechanismus, z. B. einen UNC-Pfad, öffnet, kann nicht gleichzeitig von einer anderen Anwendung auf einem Computer auf die Metadatendatei zugegriffen werden, auch nicht von einer Anwendung auf dem Computer, auf dem die Metadatendatei gespeichert ist.

Siehe auch

Verweis

SqlMetadataStore-Klasse
SqlMetadataStore-Member
Microsoft.Synchronization.MetadataStorage-Namespace