Partager via

LogStore Constructeurs

  • Référence

Définition

Espace de noms:
System.IO.Log
Assembly:
System.IO.Log.dll

Initialise une nouvelle instance de la classe LogStore.

Surcharges

LogStore(SafeFileHandle)

Initialise une nouvelle instance de la classe LogStore pour le handle spécifié.
LogStore(String, FileMode)

Initialise une nouvelle instance de la classe LogStore avec le chemin d'accès et le mode spécifiés.
LogStore(String, FileMode, FileAccess)

Initialise une nouvelle instance de la classe LogStore avec le chemin d'accès, le mode et l'accès spécifiés.
LogStore(String, FileMode, FileAccess, FileShare)

Initialise une nouvelle instance de la classe LogStore.
LogStore(String, FileMode, FileAccess, FileShare, FileSecurity)

Initialise une nouvelle instance de la classe LogStore.

LogStore(SafeFileHandle)

Initialise une nouvelle instance de la classe LogStore pour le handle spécifié.

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)

Paramètres

handle
SafeFileHandle

Un handle de fichier pour le fichier journal encapsulé par l'objet LogStore actif.

Exceptions

ArgumentNullException

handle a la valeur null.

IOException

Le handle de journal n'a pas pu être lié au pool de threads.

UnauthorizedAccessException

L'accès pour le magasin de journaux spécifié est refusé par le système d'exploitation.

ObjectDisposedException

La méthode a été appelée après la suppression de la séquence.

OutOfMemoryException

La mémoire disponible n'est pas suffisante pour continuer l'exécution d'un programme.

S’applique à

LogStore(String, FileMode)

Initialise une nouvelle instance de la classe LogStore avec le chemin d'accès et le mode spécifiés.

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)

Paramètres

path
String

Chemin d’accès relatif ou absolu au fichier de base du magasin de journaux à ouvrir.

mode
FileMode

L'une des valeurs FileMode déterminant le mode d'ouverture ou de création du magasin.

Exceptions

ArgumentNullException

path a la valeur null.

ArgumentException

Le path est une chaîne vide ("").

- ou -

path contient l'espace blanc uniquement.

- ou -

Le path contient un ou plusieurs caractères non valides.

ArgumentOutOfRangeException

mode contient une valeur non valide.

FileNotFoundException

Impossible de trouver le fichier.

IOException

Une erreur d'E/S se produit lors de l'ouverture du magasin de journaux.

UnauthorizedAccessException

L'accès pour le magasin de journaux spécifié est refusé par le système d'exploitation.

PlatformNotSupportedException

LogStore ne peut pas être utilisé parce que le composant CLFS (Common Log File System) requis n'est pas installé. Installez le composant CLFS s'il est disponible pour votre plateforme ou utilisez à la place la classe FileRecordSequence.

OutOfMemoryException

La mémoire disponible n'est pas suffisante pour continuer l'exécution d'un programme.

Remarques

Utilisez ce constructeur pour ouvrir un magasin de journaux avec le chemin d’accès et le mode spécifiés. Le magasin est ouvert avec l'accès en lecture/écriture et il partage l'accès en lecture.

Le paramètre path doit utiliser la syntaxe suivante :

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

où <physical log name> est un chemin d’accès valide à un fichier journal et <log client name> est un identificateur client unique. Un magasin de journaux doit être un magasin de journaux physique ou virtuel, mais pas les deux à la fois. Une fois qu'un magasin de journaux a été créé physiquement ou virtuellement, il reste ainsi pour sa durée de vie. Un magasin de journaux physique est créé en spécifiant uniquement le nom de journal physique. Un magasin de journaux virtuel est créé en spécifiant à la fois le nom de journal physique et le nom de journal client.

Les clients qui partagent le même nom de journal physique partagent la même collection et stratégie d'étendues.

S’applique à

LogStore(String, FileMode, FileAccess)

Initialise une nouvelle instance de la classe LogStore avec le chemin d'accès, le mode et l'accès spécifiés.

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)

Paramètres

path
String

Chemin d’accès relatif ou absolu au fichier de base du magasin de journaux à ouvrir.

mode
FileMode

L'une des valeurs FileMode déterminant le mode d'ouverture ou de création du magasin.

access
FileAccess

L'une des valeurs FileAccess déterminant le mode d'accès au fichier par le LogStore.

Exceptions

ArgumentNullException

path a la valeur null.

ArgumentException

Le path est une chaîne vide ("").

- ou -

path contient l'espace blanc uniquement.

- ou -

Le path contient un ou plusieurs caractères non valides.

ArgumentOutOfRangeException

mode contient une valeur non valide.

- ou -

access contient une valeur non valide.

FileNotFoundException

Impossible de trouver le fichier.

IOException

Une erreur d'E/S se produit lors de l'ouverture du magasin de journaux.

UnauthorizedAccessException

L'accès pour le magasin de journaux spécifié est refusé par le système d'exploitation.

PlatformNotSupportedException

LogStore ne peut pas être utilisé parce que le composant CLFS (Common Log File System) requis n'est pas installé. Installez le composant CLFS s'il est disponible pour votre plateforme ou utilisez à la place la classe FileRecordSequence.

OutOfMemoryException

La mémoire disponible n'est pas suffisante pour continuer l'exécution d'un programme.

Remarques

Utilisez ce constructeur pour ouvrir un nouveau magasin de journaux avec le chemin d’accès, le mode et l’accès spécifiés. Le magasin est ouvert avec le partage d'accès en lecture.

Le paramètre path doit utiliser la syntaxe suivante :

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

où <physical log name> est un chemin d’accès valide à un fichier journal et <log client name> est un identificateur client unique. Un magasin de journaux doit être un magasin de journaux physique ou virtuel, mais pas les deux à la fois. Une fois qu'un magasin de journaux a été créé physiquement ou virtuellement, il reste ainsi pour sa durée de vie. Un magasin de journaux physique est créé en spécifiant uniquement le nom de journal physique. Un magasin de journaux virtuel est créé en spécifiant à la fois le nom de journal physique et le nom de journal client.

Les clients qui partagent le même nom de journal physique partagent la même collection et stratégie d'étendues.

S’applique à

LogStore(String, FileMode, FileAccess, FileShare)

Initialise une nouvelle instance de la classe LogStore.

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)

Paramètres

path
String

Chemin d’accès relatif ou absolu au fichier de base du magasin de journaux à ouvrir.

mode
FileMode

L'une des valeurs FileMode déterminant le mode d'ouverture ou de création du magasin.

access
FileAccess

L'une des valeurs FileAccess déterminant le mode d'accès au fichier par le LogStore.

share
FileShare

L'une des valeurs FileShare qui détermine comment le magasin de journaux sera partagé parmi les processus.

Exceptions

ArgumentNullException

path a la valeur null.

ArgumentException

Le path est une chaîne vide ("").

- ou -

path contient l'espace blanc uniquement.

- ou -

Le path contient un ou plusieurs caractères non valides.

ArgumentOutOfRangeException

mode contient une valeur non valide.

- ou -

access contient une valeur non valide.

- ou -

share contient une valeur non valide.

FileNotFoundException

Impossible de trouver le fichier.

IOException

Une erreur d'E/S se produit lors de l'ouverture du magasin de journaux.

UnauthorizedAccessException

L'accès pour le magasin de journaux spécifié est refusé par le système d'exploitation.

PlatformNotSupportedException

LogStore ne peut pas être utilisé parce que le composant CLFS (Common Log File System) requis n'est pas installé. Installez le composant CLFS s'il est disponible pour votre plateforme ou utilisez à la place la classe FileRecordSequence.

OutOfMemoryException

La mémoire disponible n'est pas suffisante pour continuer l'exécution d'un programme.

Remarques

Ce constructeur initialise un nouvel objet LogStore qu’il ouvre avec le chemin d’accès, le mode et l’accès spécifiés. Le magasin est ouvert avec le partage d'accès spécifié.

Le paramètre path doit utiliser la syntaxe suivante :

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

où <physical log name> est un chemin d’accès valide à un fichier journal et <log client name> est un identificateur client unique. Un magasin de journaux doit être un magasin de journaux physique ou virtuel, mais pas les deux à la fois. Une fois qu'un magasin de journaux a été créé physiquement ou virtuellement, il reste ainsi pour sa durée de vie. Un magasin de journaux physique est créé en spécifiant uniquement le nom de journal physique. Un magasin de journaux virtuel est créé en spécifiant à la fois le nom de journal physique et le nom de journal client.

Les clients qui partagent le même nom de journal physique partagent la même collection et stratégie d'étendues.

S’applique à

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

Initialise une nouvelle instance de la classe LogStore.

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)

Paramètres

path
String

Chemin d’accès relatif ou absolu au fichier de base du magasin de journaux à ouvrir.

mode
FileMode

L'une des valeurs FileMode déterminant le mode d'ouverture ou de création du magasin.

access
FileAccess

L'une des valeurs FileAccess déterminant le mode d'accès au fichier par le LogStore.

share
FileShare

L'une des valeurs FileShare qui détermine comment le magasin de journaux sera partagé parmi les processus.

fileSecurity
FileSecurity

Une des valeurs de FileSecurity qui spécifie la sécurité à définir sur le magasin créé récemment si le magasin doit être créé.

Exceptions

ArgumentNullException

path a la valeur null.

ArgumentException

Le nom de fichier du magasin de journaux spécifié par le path n'est pas valide.

- ou -

Le Mode a la valeur CreateNew, celui-ci ne peut pas être utilisé sans accès en écriture.

- ou -

Le Mode a la valeur OpenOrCreate, celui-ci ne peut pas être utilisé sans accès en écriture.

ArgumentOutOfRangeException

mode contient une valeur non valide.

- ou -

access contient une valeur non valide.

- ou -

share contient une valeur non valide.

FileNotFoundException

Impossible de trouver le fichier.

IOException

Une erreur d'E/S se produit lors de l'ouverture du magasin de journaux.

Impossible d'accéder au fichier spécifié par le path parce qu'il est utilisé par un autre processus.

- ou -

Le fichier spécifié par le path ne peut pas être créé parce que le fichier ou le répertoire existe déjà.

- ou -

Le handle de journal n'a pas pu être lié au pool de threads.

- ou -

Le format ou la version de fichier journal spécifié n'est pas valide.

PlatformNotSupportedException

LogStore ne peut pas être utilisé parce que le composant CLFS (Common Log File System) requis n'est pas installé. Installez le composant CLFS s'il est disponible pour votre plateforme ou utilisez à la place la classe FileRecordSequence.

ObjectDisposedException

La méthode a été appelée après la suppression de la séquence.

OutOfMemoryException

La mémoire disponible n'est pas suffisante pour continuer l'exécution d'un programme.

SequenceFullException

La séquence d'enregistrement est complète.

UnauthorizedAccessException

L'accès pour le magasin de journaux spécifié est refusé par le système d'exploitation.

Remarques

Ce constructeur initialise un nouvel objet LogStore qu’il ouvre avec le chemin d’accès, le mode et l’accès spécifiés. Le magasin est ouvert avec le partage d'accès spécifié. Le paramètre path doit respecter la syntaxe suivante :

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

où <physical log name> est un chemin d’accès valide à un fichier journal et <log client name> est un identificateur client unique. Un magasin de journaux doit être un magasin de journaux physique ou virtuel, mais pas les deux à la fois. Une fois qu'un magasin de journaux a été créé physiquement ou virtuellement, il reste ainsi pour sa durée de vie. Un magasin de journaux physique est créé en spécifiant uniquement le nom de journal physique. Un magasin de journaux virtuel est créé en spécifiant à la fois le nom de journal physique et le nom de journal client.

Les clients qui partagent le même nom de journal physique partagent la même collection et stratégie d'étendues.

S’applique à