Freigeben über


LogStore Konstruktoren

Definition

Initialisiert eine neue Instanz der LogStore-Klasse.

Überlädt

LogStore(SafeFileHandle)

Initialisiert eine neue Instanz der LogStore-Klasse für das angegebene Handle.

LogStore(String, FileMode)

Initialisiert eine neue Instanz der LogStore-Klasse mit dem angegebenen Pfad und Modus.

LogStore(String, FileMode, FileAccess)

Initialisiert eine neue Instanz der LogStore-Klasse mit dem angegebenen Pfad, Modus und Zugriff.

LogStore(String, FileMode, FileAccess, FileShare)

Initialisiert eine neue Instanz der LogStore-Klasse.

LogStore(String, FileMode, FileAccess, FileShare, FileSecurity)

Initialisiert eine neue Instanz der LogStore-Klasse.

LogStore(SafeFileHandle)

Initialisiert eine neue Instanz der LogStore-Klasse für das angegebene Handle.

public:
 LogStore(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle);
public LogStore (Microsoft.Win32.SafeHandles.SafeFileHandle handle);
new System.IO.Log.LogStore : Microsoft.Win32.SafeHandles.SafeFileHandle -> System.IO.Log.LogStore
Public Sub New (handle As SafeFileHandle)

Parameter

handle
SafeFileHandle

Ein Dateihandle für die Protokolldatei, die vom aktuellen LogStore-Objekt eingekapselt wird.

Ausnahmen

handle ist null.

Das Protokollhandle konnte nicht an den Threadpool gebunden werden.

Der Zugriff auf den angegebenen Protokollspeicher wird vom Betriebssystem verweigert.

Die Methode wurde aufgerufen, nachdem die Sequenz verworfen wurde.

Der Arbeitsspeicher reicht nicht aus, um die Ausführung eines Programms fortzusetzen.

Gilt für:

LogStore(String, FileMode)

Initialisiert eine neue Instanz der LogStore-Klasse mit dem angegebenen Pfad und Modus.

public:
 LogStore(System::String ^ path, System::IO::FileMode mode);
public LogStore (string path, System.IO.FileMode mode);
new System.IO.Log.LogStore : string * System.IO.FileMode -> System.IO.Log.LogStore
Public Sub New (path As String, mode As FileMode)

Parameter

path
String

Ein relativer oder absoluter Pfad für die Basisdatei des Protokollspeichers, die geöffnet werden soll.

mode
FileMode

Einer der FileMode-Werte, der bestimmt, wie der Speicher geöffnet oder erstellt wird.

Ausnahmen

path ist null.

path ist eine leere Zeichenfolge ("").

- oder -

path enthält nur Leerraum.

- oder -

path enthält mindestens ein ungültiges Zeichen.

mode enthält einen ungültigen Wert.

Die Datei kann nicht gefunden werden.

Ein E/A-Fehler tritt auf, wenn der Protokollspeicher geöffnet wird.

Der Zugriff auf den angegebenen Protokollspeicher wird vom Betriebssystem verweigert.

LogStore kann nicht verwendet werden, da die erforderliche CLFS-Komponente (gemeinsames Protokolldateisystem) nicht installiert ist. Installieren Sie die CLFS-Komponente, wenn sie für Ihre Plattform verfügbar ist, oder verwenden Sie stattdessen die FileRecordSequence-Klasse.

Der Arbeitsspeicher reicht nicht aus, um die Ausführung eines Programms fortzusetzen.

Hinweise

Verwenden Sie diesen Konstruktor, um einen Protokollspeicher mit dem angegebenen Pfad und Modus zu öffnen. Der Speicher wird mit Lese-/Schreibzugriff geöffnet und für den Lesezugriff freigegeben.

Der path-Parameter sollte die folgende Syntax verwenden:

log:<physical log name>[::<log client name>]

wobei <physical log name> ein gültiger Pfad zu einer Protokolldatei und <log client name> ein eindeutiger Clientbezeichner ist. Ein Protokollspeicher kann entweder ein physischer oder ein virtueller Protokollspeicher sein, nicht jedoch beides. Sobald ein Protokollspeicher physisch oder virtuell erstellt wurde, kann dies nicht mehr geändert werden. Ein physischer Protokollspeicher wird erstellt, indem man nur den physischen Protokollnamen angibt. Ein virtueller Protokollspeicher wird erstellt, indem man sowohl den physischen Protokollnamen als auch den Namen des Protokollclients angibt.

Clients, die der gleichen physischen Protokollnamen verwenden, verwenden auch dieselbe Wertebereichauflistung und Richtlinie.

Gilt für:

LogStore(String, FileMode, FileAccess)

Initialisiert eine neue Instanz der LogStore-Klasse mit dem angegebenen Pfad, Modus und Zugriff.

public:
 LogStore(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access);
public LogStore (string path, System.IO.FileMode mode, System.IO.FileAccess access);
new System.IO.Log.LogStore : string * System.IO.FileMode * System.IO.FileAccess -> System.IO.Log.LogStore
Public Sub New (path As String, mode As FileMode, access As FileAccess)

Parameter

path
String

Ein relativer oder absoluter Pfad für die Basisdatei des Protokollspeichers, die geöffnet werden soll.

mode
FileMode

Einer der FileMode-Werte, der bestimmt, wie der Speicher geöffnet oder erstellt wird.

access
FileAccess

Einer der FileAccess-Werte, der festlegt, wie der LogStore auf die Datei zugreifen kann.

Ausnahmen

path ist null.

path ist eine leere Zeichenfolge ("").

- oder -

path enthält nur Leerraum.

- oder -

path enthält mindestens ein ungültiges Zeichen.

mode enthält einen ungültigen Wert.

– oder –

access enthält einen ungültigen Wert.

Die Datei kann nicht gefunden werden.

Ein E/A-Fehler tritt auf, wenn der Protokollspeicher geöffnet wird.

Der Zugriff auf den angegebenen Protokollspeicher wird vom Betriebssystem verweigert.

LogStore kann nicht verwendet werden, da die erforderliche CLFS-Komponente (gemeinsames Protokolldateisystem) nicht installiert ist. Installieren Sie die CLFS-Komponente, wenn sie für Ihre Plattform verfügbar ist, oder verwenden Sie stattdessen die FileRecordSequence-Klasse.

Der Arbeitsspeicher reicht nicht aus, um die Ausführung eines Programms fortzusetzen.

Hinweise

Verwenden Sie diesen Konstruktor, um einen neuen Protokollspeicher mit dem angegebenen Pfad, Modus und Zugriff zu öffnen. Der Speicher wird geöffnet und der Lesezugriff freigegeben.

Der path-Parameter sollte die folgende Syntax verwenden:

log:<physical log name>[::<log client name>]

wobei <physical log name> ein gültiger Pfad zu einer Protokolldatei und <log client name> ein eindeutiger Clientbezeichner ist. Ein Protokollspeicher kann entweder ein physischer oder ein virtueller Protokollspeicher sein, nicht jedoch beides. Sobald ein Protokollspeicher physisch oder virtuell erstellt wurde, kann dies nicht mehr geändert werden. Ein physischer Protokollspeicher wird erstellt, indem man nur den physischen Protokollnamen angibt. Ein virtueller Protokollspeicher wird erstellt, indem man sowohl den physischen Protokollnamen als auch den Namen des Protokollclients angibt.

Clients, die der gleichen physischen Protokollnamen verwenden, verwenden auch dieselbe Wertebereichauflistung und Richtlinie.

Gilt für:

LogStore(String, FileMode, FileAccess, FileShare)

Initialisiert eine neue Instanz der LogStore-Klasse.

public:
 LogStore(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share);
public LogStore (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share);
new System.IO.Log.LogStore : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare -> System.IO.Log.LogStore
Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare)

Parameter

path
String

Ein relativer oder absoluter Pfad für die Basisdatei des Protokollspeichers, die geöffnet werden soll.

mode
FileMode

Einer der FileMode-Werte, der bestimmt, wie der Speicher geöffnet oder erstellt wird.

access
FileAccess

Einer der FileAccess-Werte, der festlegt, wie der LogStore auf die Datei zugreifen kann.

share
FileShare

Einer der FileShare-Werte, der bestimmt, wie der Protokollspeicher für Prozesse freigegeben wird.

Ausnahmen

path ist null.

path ist eine leere Zeichenfolge ("").

- oder -

path enthält nur Leerraum.

- oder -

path enthält mindestens ein ungültiges Zeichen.

mode enthält einen ungültigen Wert.

– oder –

access enthält einen ungültigen Wert.

- oder -

share enthält einen ungültigen Wert.

Die Datei kann nicht gefunden werden.

Ein E/A-Fehler tritt auf, wenn der Protokollspeicher geöffnet wird.

Der Zugriff auf den angegebenen Protokollspeicher wird vom Betriebssystem verweigert.

LogStore kann nicht verwendet werden, da die erforderliche CLFS-Komponente (gemeinsames Protokolldateisystem) nicht installiert ist. Installieren Sie die CLFS-Komponente, wenn sie für Ihre Plattform verfügbar ist, oder verwenden Sie stattdessen die FileRecordSequence-Klasse.

Der Arbeitsspeicher reicht nicht aus, um die Ausführung eines Programms fortzusetzen.

Hinweise

Dieser Konstruktor initialisiert ein neues LogStore-Objekt, das er mit dem angegebenen Pfad, Modus und Zugriff öffnet. Der Speicher wird geöffnet und der angegebene Zugriff freigegeben.

Der path-Parameter sollte die folgende Syntax verwenden:

log:<physical log name>[::<log client name>]

wobei <physical log name> ein gültiger Pfad zu einer Protokolldatei und <log client name> ein eindeutiger Clientbezeichner ist. Ein Protokollspeicher kann entweder ein physischer oder ein virtueller Protokollspeicher sein, nicht jedoch beides. Sobald ein Protokollspeicher physisch oder virtuell erstellt wurde, kann dies nicht mehr geändert werden. Ein physischer Protokollspeicher wird erstellt, indem man nur den physischen Protokollnamen angibt. Ein virtueller Protokollspeicher wird erstellt, indem man sowohl den physischen Protokollnamen als auch den Namen des Protokollclients angibt.

Clients, die der gleichen physischen Protokollnamen verwenden, verwenden auch dieselbe Wertebereichauflistung und Richtlinie.

Gilt für:

LogStore(String, FileMode, FileAccess, FileShare, FileSecurity)

Initialisiert eine neue Instanz der LogStore-Klasse.

public:
 LogStore(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, System::Security::AccessControl::FileSecurity ^ fileSecurity);
public LogStore (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, System.Security.AccessControl.FileSecurity fileSecurity);
new System.IO.Log.LogStore : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * System.Security.AccessControl.FileSecurity -> System.IO.Log.LogStore
Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, fileSecurity As FileSecurity)

Parameter

path
String

Ein relativer oder absoluter Pfad für die Basisdatei des Protokollspeichers, die geöffnet werden soll.

mode
FileMode

Einer der FileMode-Werte, der bestimmt, wie der Speicher geöffnet oder erstellt wird.

access
FileAccess

Einer der FileAccess-Werte, der festlegt, wie der LogStore auf die Datei zugreifen kann.

share
FileShare

Einer der FileShare-Werte, der bestimmt, wie der Protokollspeicher für Prozesse freigegeben wird.

fileSecurity
FileSecurity

Einer der FileSecurity-Werte, der die Sicherheit für den neu erstellten Speicher festlegt, sofern der Speicher erstellt werden muss.

Ausnahmen

path ist null.

Der Dateiname des Protokollspeichers, der von path angegeben wird, ist ungültig.

- oder -

Mode ist CreateNew, der nicht ohne Schreibzugriff verwendet werden kann.

- oder -

Mode ist OpenOrCreate, der nicht ohne Schreibzugriff verwendet werden kann.

mode enthält einen ungültigen Wert.

– oder –

access enthält einen ungültigen Wert.

- oder -

share enthält einen ungültigen Wert.

Die Datei kann nicht gefunden werden.

Ein E/A-Fehler tritt auf, wenn der Protokollspeicher geöffnet wird.

Auf die von path angegebene Datei kann nicht zugegriffen werden, da sie von einem anderen Prozess verwendet wird.

- oder -

Die von path angegebene Datei kann nicht erstellt werden, da die Datei oder das Verzeichnis bereits vorhanden ist.

- oder -

Das Protokollhandle konnte nicht an den Threadpool gebunden werden.

- oder -

Das angegebene Protokolldateiformat oder die Version ist ungültig.

LogStore kann nicht verwendet werden, da die erforderliche CLFS-Komponente (gemeinsames Protokolldateisystem) nicht installiert ist. Installieren Sie die CLFS-Komponente, wenn sie für Ihre Plattform verfügbar ist, oder verwenden Sie stattdessen die FileRecordSequence-Klasse.

Die Methode wurde aufgerufen, nachdem die Sequenz verworfen wurde.

Der Arbeitsspeicher reicht nicht aus, um die Ausführung eines Programms fortzusetzen.

Die Datensatzsequenz ist voll.

Der Zugriff auf den angegebenen Protokollspeicher wird vom Betriebssystem verweigert.

Hinweise

Dieser Konstruktor initialisiert ein neues LogStore-Objekt, das er mit dem angegebenen Pfad, Modus und Zugriff öffnet. Der Speicher wird geöffnet und der angegebene Zugriff freigegeben. Der path-Parameter sollte die folgende Syntax verwenden:

log:<physical log name>[::<log client name>]

wobei <physical log name> ein gültiger Pfad zu einer Protokolldatei und <log client name> ein eindeutiger Clientbezeichner ist. Ein Protokollspeicher kann entweder ein physischer oder ein virtueller Protokollspeicher sein, nicht jedoch beides. Sobald ein Protokollspeicher physisch oder virtuell erstellt wurde, kann dies nicht mehr geändert werden. Ein physischer Protokollspeicher wird erstellt, indem man nur den physischen Protokollnamen angibt. Ein virtueller Protokollspeicher wird erstellt, indem man sowohl den physischen Protokollnamen als auch den Namen des Protokollclients angibt.

Clients, die der gleichen physischen Protokollnamen verwenden, verwenden auch dieselbe Wertebereichauflistung und Richtlinie.

Gilt für: