LogStore Konstruktory

Definice

Obor názvů:
System.IO.Log
Sestavení:
System.IO.Log.dll

Inicializuje novou instanci LogStore třídy.

Přetížení

Name Description
LogStore(SafeFileHandle)

Inicializuje novou instanci LogStore třídy pro zadaný popisovač.
LogStore(String, FileMode)

Inicializuje novou instanci LogStore třídy se zadanou cestou a režimem.
LogStore(String, FileMode, FileAccess)

Inicializuje novou instanci LogStore třídy se zadanou cestou, režimem a přístupem.
LogStore(String, FileMode, FileAccess, FileShare)

Inicializuje novou instanci LogStore třídy.
LogStore(String, FileMode, FileAccess, FileShare, FileSecurity)

Inicializuje novou instanci LogStore třídy.

LogStore(SafeFileHandle)

Inicializuje novou instanci LogStore třídy pro zadaný popisovač.

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)

Parametry

handle
SafeFileHandle

Popisovač souboru protokolu, který aktuální LogStore objekt zapouzdřuje.

Výjimky

ArgumentNullException

handle je null.

IOException

Popisovač protokolu nelze svázat s fondem vláken.

UnauthorizedAccessException

Operační systém odepře přístup k zadanému úložišti protokolů.

ObjectDisposedException

Metoda byla volána po odstranění sekvence.

OutOfMemoryException

Pro pokračování v provádění programu není dostatek paměti.

Platí pro

LogStore(String, FileMode)

Inicializuje novou instanci LogStore třídy se zadanou cestou a režimem.

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)

Parametry

path
String

Relativní nebo absolutní cesta pro otevření základního souboru úložiště protokolů.

mode
FileMode

Jedna z FileMode hodnot, které určují, jak otevřít nebo vytvořit úložiště.

Výjimky

ArgumentNullException

path je null.

ArgumentException

path je prázdný řetězec ("").

nebo

path obsahuje pouze prázdné znaky.

nebo

path obsahuje jeden nebo více neplatných znaků.

ArgumentOutOfRangeException

mode obsahuje neplatnou hodnotu.

FileNotFoundException

Soubor nebyl nalezen.

IOException

Při otevírání úložiště protokolů dojde k chybě vstupně-výstupní operace.

UnauthorizedAccessException

Operační systém odepře přístup k zadanému úložišti protokolů.

PlatformNotSupportedException

LogStore nelze použít, protože požadovaná součást CLFS (Common Log File System) není nainstalována. Nainstalujte komponentu CLFS, pokud je k dispozici pro vaši platformu FileRecordSequence , nebo místo toho použijte třídu.

OutOfMemoryException

Pro pokračování v provádění programu není dostatek paměti.

Poznámky

Pomocí tohoto konstruktoru otevřete úložiště protokolů se zadanou cestou a režimem. Úložiště se otevře s přístupem pro čtení a zápis a sdílí přístup pro čtení.

Parametr path by měl používat následující syntaxi:

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

kde <physical log name> je platná cesta k souboru protokolu a <log client name> je jedinečným identifikátorem klienta. Úložiště protokolů by mělo být fyzické úložiště protokolů nebo virtuální úložiště protokolů, ale ne obojí. Jakmile se úložiště protokolů vytvoří fyzicky nebo virtuálně, zůstane tak i po celou dobu jeho života. Fyzické úložiště protokolů se vytvoří zadáním pouze názvu fyzického protokolu. Virtuální úložiště protokolů se vytvoří zadáním názvu fyzického protokolu i názvu klienta protokolu.

Klienti, kteří sdílejí stejný název fyzického protokolu, sdílejí stejnou kolekci a zásady.

Platí pro

LogStore(String, FileMode, FileAccess)

Inicializuje novou instanci LogStore třídy se zadanou cestou, režimem a přístupem.

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)

Parametry

path
String

Relativní nebo absolutní cesta pro otevření základního souboru úložiště protokolů.

mode
FileMode

Jedna z FileMode hodnot, které určují, jak otevřít nebo vytvořit úložiště.

access
FileAccess

Jedna z FileAccess hodnot, která určuje, jak lze k souboru přistupovat LogStorepomocí .

Výjimky

ArgumentNullException

path je null.

ArgumentException

path je prázdný řetězec ("").

nebo

path obsahuje pouze prázdné znaky.

nebo

path obsahuje jeden nebo více neplatných znaků.

ArgumentOutOfRangeException

mode obsahuje neplatnou hodnotu.

-nebo

access obsahuje neplatnou hodnotu.

FileNotFoundException

Soubor nebyl nalezen.

IOException

Při otevírání úložiště protokolů dojde k chybě vstupně-výstupní operace.

UnauthorizedAccessException

Operační systém odepře přístup k zadanému úložišti protokolů.

PlatformNotSupportedException

LogStore nelze použít, protože požadovaná součást CLFS (Common Log File System) není nainstalována. Nainstalujte komponentu CLFS, pokud je k dispozici pro vaši platformu FileRecordSequence , nebo místo toho použijte třídu.

OutOfMemoryException

Pro pokračování v provádění programu není dostatek paměti.

Poznámky

Pomocí tohoto konstruktoru otevřete nové úložiště protokolů se zadanou cestou, režimem a přístupem. Úložiště se otevře se sdílením přístupu pro čtení.

Parametr path by měl používat následující syntaxi:

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

kde <physical log name> je platná cesta k souboru protokolu a <log client name> je jedinečným identifikátorem klienta. Úložiště protokolů by mělo být fyzické úložiště protokolů nebo virtuální úložiště protokolů, ale ne obojí. Jakmile se úložiště protokolů vytvoří fyzicky nebo virtuálně, zůstane tak i po celou dobu jeho života. Fyzické úložiště protokolů se vytvoří zadáním pouze názvu fyzického protokolu. Virtuální úložiště protokolů se vytvoří zadáním názvu fyzického protokolu i názvu klienta protokolu.

Klienti, kteří sdílejí stejný název fyzického protokolu, sdílejí stejnou kolekci a zásady.

Platí pro

LogStore(String, FileMode, FileAccess, FileShare)

Inicializuje novou instanci LogStore třídy.

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)

Parametry

path
String

Relativní nebo absolutní cesta pro otevření základního souboru úložiště protokolů.

mode
FileMode

Jedna z FileMode hodnot, které určují, jak otevřít nebo vytvořit úložiště.

access
FileAccess

Jedna z FileAccess hodnot, která určuje, jak lze k souboru přistupovat LogStorepomocí .

share
FileShare

Jedna z FileShare hodnot, které určují způsob sdílení úložiště protokolů mezi procesy.

Výjimky

ArgumentNullException

path je null.

ArgumentException

path je prázdný řetězec ("").

nebo

path obsahuje pouze prázdné znaky.

nebo

path obsahuje jeden nebo více neplatných znaků.

ArgumentOutOfRangeException

mode obsahuje neplatnou hodnotu.

-nebo

access obsahuje neplatnou hodnotu.

nebo

share obsahuje neplatnou hodnotu.

FileNotFoundException

Soubor nebyl nalezen.

IOException

Při otevírání úložiště protokolů dojde k chybě vstupně-výstupní operace.

UnauthorizedAccessException

Operační systém odepře přístup k zadanému úložišti protokolů.

PlatformNotSupportedException

LogStore nelze použít, protože požadovaná součást CLFS (Common Log File System) není nainstalována. Nainstalujte komponentu CLFS, pokud je k dispozici pro vaši platformu FileRecordSequence , nebo místo toho použijte třídu.

OutOfMemoryException

Pro pokračování v provádění programu není dostatek paměti.

Poznámky

Tento konstruktor inicializuje nový LogStore objekt, který se otevře se zadanou cestou, režimem a přístupem. Úložiště se otevře se sdílením zadaného přístupu.

Parametr path by měl používat následující syntaxi:

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

kde <physical log name> je platná cesta k souboru protokolu a <log client name> je jedinečným identifikátorem klienta. Úložiště protokolů by mělo být fyzické úložiště protokolů nebo virtuální úložiště protokolů, ale ne obojí. Jakmile se úložiště protokolů vytvoří fyzicky nebo virtuálně, zůstane tak i po celou dobu jeho života. Fyzické úložiště protokolů se vytvoří zadáním pouze názvu fyzického protokolu. Virtuální úložiště protokolů se vytvoří zadáním názvu fyzického protokolu i názvu klienta protokolu.

Klienti, kteří sdílejí stejný název fyzického protokolu, sdílejí stejnou kolekci a zásady.

Platí pro

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

Inicializuje novou instanci LogStore třídy.

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)

Parametry

path
String

Relativní nebo absolutní cesta pro otevření základního souboru úložiště protokolů.

mode
FileMode

Jedna z FileMode hodnot, které určují, jak otevřít nebo vytvořit úložiště.

access
FileAccess

Jedna z FileAccess hodnot, která určuje, jak lze k souboru přistupovat LogStorepomocí .

share
FileShare

Jedna z FileShare hodnot, které určují způsob sdílení úložiště protokolů mezi procesy.

fileSecurity
FileSecurity

Jedna z FileSecurity hodnot, která určuje zabezpečení, které se má nastavit v nově vytvořeném úložišti, pokud se má úložiště vytvořit.

Výjimky

ArgumentNullException

path je null.

ArgumentException

Název souboru úložiště protokolů zadaný path pomocí není platný.

nebo

mode je CreateNew, který nelze použít bez přístupu k zápisu.

nebo

mode je OpenOrCreate, který nelze použít bez přístupu k zápisu.

ArgumentOutOfRangeException

mode obsahuje neplatnou hodnotu.

-nebo

access obsahuje neplatnou hodnotu.

nebo

share obsahuje neplatnou hodnotu.

FileNotFoundException

Soubor nebyl nalezen.

IOException

Při otevírání úložiště protokolů dojde k chybě vstupně-výstupní operace.

K souboru určenému pomocí path nelze získat přístup, protože ho používá jiný proces.

nebo

Soubor zadaný pomocí path nelze vytvořit, protože soubor nebo adresář již existuje.

nebo

Popisovač protokolu nelze svázat s fondem vláken.

nebo

Zadaný formát souboru protokolu nebo verze je neplatný.

PlatformNotSupportedException

LogStore nelze použít, protože požadovaná součást CLFS (Common Log File System) není nainstalována. Nainstalujte komponentu CLFS, pokud je k dispozici pro vaši platformu FileRecordSequence , nebo místo toho použijte třídu.

ObjectDisposedException

Metoda byla volána po odstranění sekvence.

OutOfMemoryException

Pro pokračování v provádění programu není dostatek paměti.

SequenceFullException

Posloupnost záznamů je plná.

UnauthorizedAccessException

Operační systém odepře přístup k zadanému úložišti protokolů.

Poznámky

Tento konstruktor inicializuje nový LogStore objekt, který se otevře se zadanou cestou, režimem a přístupem. Úložiště se otevře se sdílením zadaného přístupu. Parametr path by měl dodržovat následující syntaxi:

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

kde <physical log name> je platná cesta k souboru protokolu a <log client name> je jedinečným identifikátorem klienta. Úložiště protokolů by mělo být fyzické úložiště protokolů nebo virtuální úložiště protokolů, ale ne obojí. Jakmile se úložiště protokolů vytvoří fyzicky nebo virtuálně, zůstane tak i po celou dobu jeho života. Fyzické úložiště protokolů se vytvoří zadáním pouze názvu fyzického protokolu. Virtuální úložiště protokolů se vytvoří zadáním názvu fyzického protokolu i názvu klienta protokolu.

Klienti, kteří sdílejí stejný název fyzického protokolu, sdílejí stejnou kolekci a zásady.

Platí pro