Sdílet prostřednictvím

LogStore Konstruktory

  • Reference

Definice

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

Inicializuje novou instanci LogStore třídy .

Přetížení

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 pro soubor 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 základní soubor úložiště protokolů, který se má otevřít.

mode
FileMode

Jedna z FileMode hodnot, která určuje, 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ření úložiště protokolů dojde k vstupně-výstupní chybě.

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á komponenta CLFS (Common Log File System) není nainstalována. Nainstalujte komponentu CLFS, pokud je pro vaši platformu FileRecordSequence dostupná, nebo místo ní 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í i 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ý identifikátor klienta. Úložiště protokolů by mělo být buď fyzické, nebo virtuální úložiště protokolů, ale ne obojí. Jakmile je úložiště protokolů vytvořeno fyzicky nebo virtuálně, zůstane tak 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 fyzického názvu protokolu i názvu klienta protokolu.

Klienti, kteří sdílejí stejný název fyzického protokolu, sdílejí stejnou kolekci rozsahů 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 základní soubor úložiště protokolů, který se má otevřít.

mode
FileMode

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

access
FileAccess

Jedna z FileAccess hodnot, která určuje, jak může být soubor přístupný pomocí LogStore.

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ření úložiště protokolů dojde k vstupně-výstupní chybě.

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á komponenta CLFS (Common Log File System) není nainstalována. Nainstalujte komponentu CLFS, pokud je pro vaši platformu FileRecordSequence dostupná, nebo místo ní 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. Otevře se úložiště, které 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ý identifikátor klienta. Úložiště protokolů by mělo být buď fyzické, nebo virtuální úložiště protokolů, ale ne obojí. Jakmile je úložiště protokolů vytvořeno fyzicky nebo virtuálně, zůstane tak 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 fyzického názvu protokolu i názvu klienta protokolu.

Klienti, kteří sdílejí stejný název fyzického protokolu, sdílejí stejnou kolekci rozsahů 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 základní soubor úložiště protokolů, který se má otevřít.

mode
FileMode

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

access
FileAccess

Jedna z FileAccess hodnot, která určuje, jak může být soubor přístupný pomocí LogStore.

share
FileShare

Jedna z FileShare hodnot, která určuje 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ření úložiště protokolů dojde k vstupně-výstupní chybě.

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á komponenta CLFS (Common Log File System) není nainstalována. Nainstalujte komponentu CLFS, pokud je pro vaši platformu FileRecordSequence dostupná, nebo místo ní 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. Otevře se úložiště, které sdílí zadaný přístup.

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ý identifikátor klienta. Úložiště protokolů by mělo být buď fyzické, nebo virtuální úložiště protokolů, ale ne obojí. Jakmile je úložiště protokolů vytvořeno fyzicky nebo virtuálně, zůstane tak 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 fyzického názvu protokolu i názvu klienta protokolu.

Klienti, kteří sdílejí stejný název fyzického protokolu, sdílejí stejnou kolekci rozsahů 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 základní soubor úložiště protokolů, který se má otevřít.

mode
FileMode

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

access
FileAccess

Jedna z FileAccess hodnot, která určuje, jak může být soubor přístupný pomocí LogStore.

share
FileShare

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

fileSecurity
FileSecurity

Jedna z FileSecurity hodnot, která určuje zabezpečení nastavené v nově vytvořeném úložišti, pokud musí být vytvořeno úložiště.

Výjimky

ArgumentNullException

path je null.

ArgumentException

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

-nebo-

Mode je CreateNew, který nelze použít bez přístupu pro zápis.

-nebo-

Mode je OpenOrCreate, který nelze použít bez přístupu pro zápis.

ArgumentOutOfRangeException

mode obsahuje neplatnou hodnotu.

-Nebo

access obsahuje neplatnou hodnotu.

-nebo-

share obsahuje neplatnou hodnotu.

FileNotFoundException

Soubor nebyl nalezen.

IOException

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

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

-nebo-

Soubor určený nástrojem path nelze vytvořit, protože soubor nebo adresář již existují.

-nebo-

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

-nebo-

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

PlatformNotSupportedException

LogStore nelze použít, protože požadovaná komponenta CLFS (Common Log File System) není nainstalována. Nainstalujte komponentu CLFS, pokud je pro vaši platformu FileRecordSequence dostupná, nebo místo ní 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. Otevře se úložiště, které sdílí zadaný přístup. Parametr path by měl mít 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ý identifikátor klienta. Úložiště protokolů by mělo být buď fyzické, nebo virtuální úložiště protokolů, ale ne obojí. Jakmile je úložiště protokolů vytvořeno fyzicky nebo virtuálně, zůstane tak 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 fyzického názvu protokolu i názvu klienta protokolu.

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

Platí pro