LogStore Construtores

Definição

Inicializa uma nova instância da LogStore classe.

Sobrecargas

Name Description
LogStore(SafeFileHandle)

Inicializa uma nova instância da LogStore classe para o handle especificado.

LogStore(String, FileMode)

Inicializa uma nova instância da LogStore classe com o caminho e modo especificados.

LogStore(String, FileMode, FileAccess)

Inicializa uma nova instância da LogStore classe com o caminho, modo e acesso especificados.

LogStore(String, FileMode, FileAccess, FileShare)

Inicializa uma nova instância da LogStore classe.

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

Inicializa uma nova instância da LogStore classe.

LogStore(SafeFileHandle)

Inicializa uma nova instância da LogStore classe para o handle especificado.

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)

Parâmetros

handle
SafeFileHandle

Um handle de ficheiro para o ficheiro de log que o objeto atual LogStore encapsula.

Exceções

handle é null.

A alavanca do log não podia ser ligada ao pool de threads.

O acesso ao armazenamento de registos especificado é negado pelo sistema operativo.

O método era chamado depois de a sequência ter sido eliminada.

Não há memória suficiente para continuar a execução de um programa.

Aplica-se a

LogStore(String, FileMode)

Inicializa uma nova instância da LogStore classe com o caminho e modo especificados.

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)

Parâmetros

path
String

Um caminho relativo ou absoluto para o ficheiro base do armazenamento de logs se abrir.

mode
FileMode

Um dos FileMode valores que determina como abrir ou criar a loja.

Exceções

path é null.

path é uma cadeia vazia ("").

-ou-

path contém apenas espaço em branco.

-ou-

path contém um ou mais caracteres inválidos.

mode contém um valor inválido.

O ficheiro não pode ser encontrado.

Ocorre um erro de I/O ao abrir a loja de logs.

O acesso ao armazenamento de registos especificado é negado pelo sistema operativo.

LogStore não pode ser usado porque o componente necessário do Sistema de Ficheiros de Registo Comum (CLFS) não está instalado. Instala o componente CLFS se estiver disponível para a tua plataforma ou usa a FileRecordSequence classe em vez disso.

Não há memória suficiente para continuar a execução de um programa.

Observações

Use este construtor para abrir um armazenamento de logs com o caminho e modo especificados. A loja é aberta com acesso de leitura/escrita e partilha o acesso de leitura.

O path parâmetro deve usar a seguinte sintaxe:

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

onde <physical log name> é um caminho válido para um ficheiro de log, e <log client name> é um identificador único do cliente. Um log store deve ser ou físico ou virtual, mas não ambos. Uma vez que um armazenamento de logs foi criado física ou virtualmente, mantém-se assim durante toda a sua vida. Um armazenamento físico de logs é criado especificando apenas o nome físico do log. Um armazenamento virtual de registos é criado especificando tanto o nome físico do registo como o nome do cliente de log.

Clientes que partilham o mesmo nome físico de registo partilham a mesma extensão de recolha e política.

Aplica-se a

LogStore(String, FileMode, FileAccess)

Inicializa uma nova instância da LogStore classe com o caminho, modo e acesso especificados.

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)

Parâmetros

path
String

Um caminho relativo ou absoluto para o ficheiro base do armazenamento de logs se abrir.

mode
FileMode

Um dos FileMode valores que determina como abrir ou criar a loja.

access
FileAccess

Um dos FileAccess valores que determina como o ficheiro pode ser acedido pelo LogStore.

Exceções

path é null.

path é uma cadeia vazia ("").

-ou-

path contém apenas espaço em branco.

-ou-

path contém um ou mais caracteres inválidos.

mode contém um valor inválido.

-ou

access contém um valor inválido.

O ficheiro não pode ser encontrado.

Ocorre um erro de I/O ao abrir a loja de logs.

O acesso ao armazenamento de registos especificado é negado pelo sistema operativo.

LogStore não pode ser usado porque o componente necessário do Sistema de Ficheiros de Registo Comum (CLFS) não está instalado. Instala o componente CLFS se estiver disponível para a tua plataforma ou usa a FileRecordSequence classe em vez disso.

Não há memória suficiente para continuar a execução de um programa.

Observações

Use este construtor para abrir um novo armazenamento de logs com o caminho, modo e acesso especificados. A loja é aberta partilhando o acesso à leitura.

O path parâmetro deve usar a seguinte sintaxe:

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

onde <physical log name> é um caminho válido para um ficheiro de log, e <log client name> é um identificador único do cliente. Um log store deve ser ou físico ou virtual, mas não ambos. Uma vez que um armazenamento de logs foi criado física ou virtualmente, mantém-se assim durante toda a sua vida. Um armazenamento físico de logs é criado especificando apenas o nome físico do log. Um armazenamento virtual de registos é criado especificando tanto o nome físico do registo como o nome do cliente de log.

Clientes que partilham o mesmo nome físico de registo partilham a mesma extensão de recolha e política.

Aplica-se a

LogStore(String, FileMode, FileAccess, FileShare)

Inicializa uma nova instância da LogStore classe.

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)

Parâmetros

path
String

Um caminho relativo ou absoluto para o ficheiro base do armazenamento de logs se abrir.

mode
FileMode

Um dos FileMode valores que determina como abrir ou criar a loja.

access
FileAccess

Um dos FileAccess valores que determina como o ficheiro pode ser acedido pelo LogStore.

share
FileShare

Um dos FileShare valores que determina como o armazenamento de logs será partilhado entre os processos.

Exceções

path é null.

path é uma cadeia vazia ("").

-ou-

path contém apenas espaço em branco.

-ou-

path contém um ou mais caracteres inválidos.

mode contém um valor inválido.

-ou

access contém um valor inválido.

-ou-

share contém um valor inválido.

O ficheiro não pode ser encontrado.

Ocorre um erro de I/O ao abrir a loja de logs.

O acesso ao armazenamento de registos especificado é negado pelo sistema operativo.

LogStore não pode ser usado porque o componente necessário do Sistema de Ficheiros de Registo Comum (CLFS) não está instalado. Instala o componente CLFS se estiver disponível para a tua plataforma ou usa a FileRecordSequence classe em vez disso.

Não há memória suficiente para continuar a execução de um programa.

Observações

Este construtor inicializa um novo LogStore objeto que abre com o caminho, modo e acesso especificados. A loja é aberta partilhando o acesso especificado.

O path parâmetro deve usar a seguinte sintaxe:

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

onde <physical log name> é um caminho válido para um ficheiro de log, e <log client name> é um identificador único do cliente. Um log store deve ser ou físico ou virtual, mas não ambos. Uma vez que um armazenamento de logs foi criado física ou virtualmente, mantém-se assim durante toda a sua vida. Um armazenamento físico de logs é criado especificando apenas o nome físico do log. Um armazenamento virtual de registos é criado especificando tanto o nome físico do registo como o nome do cliente de log.

Clientes que partilham o mesmo nome físico de registo partilham a mesma extensão de recolha e política.

Aplica-se a

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

Inicializa uma nova instância da LogStore classe.

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)

Parâmetros

path
String

Um caminho relativo ou absoluto para o ficheiro base do armazenamento de logs se abrir.

mode
FileMode

Um dos FileMode valores que determina como abrir ou criar a loja.

access
FileAccess

Um dos FileAccess valores que determina como o ficheiro pode ser acedido pelo LogStore.

share
FileShare

Um dos FileShare valores que determina como o armazenamento de logs será partilhado entre os processos.

fileSecurity
FileSecurity

Um dos FileSecurity valores que especifica a segurança a definir na nova loja criada caso a loja tenha de ser criada.

Exceções

path é null.

O nome do ficheiro de armazenamento de log especificado por path não é válido.

-ou-

mode é CreateNew, que não pode ser usada sem acesso por escrita.

-ou-

mode é OpenOrCreate, que não pode ser usada sem acesso por escrita.

mode contém um valor inválido.

-ou

access contém um valor inválido.

-ou-

share contém um valor inválido.

O ficheiro não pode ser encontrado.

Ocorre um erro de I/O ao abrir a loja de logs.

O ficheiro especificado por path não pode ser acedido porque está a ser utilizado por outro processo.

-ou-

O ficheiro especificado por path não pode ser criado porque o ficheiro ou diretório já existe.

-ou-

A alavanca do log não podia ser ligada ao pool de threads.

-ou-

O formato ou versão do ficheiro de registo especificado é inválido.

LogStore não pode ser usado porque o componente necessário do Sistema de Ficheiros de Registo Comum (CLFS) não está instalado. Instala o componente CLFS se estiver disponível para a tua plataforma ou usa a FileRecordSequence classe em vez disso.

O método era chamado depois de a sequência ter sido eliminada.

Não há memória suficiente para continuar a execução de um programa.

A sequência de discos está cheia.

O acesso ao armazenamento de registos especificado é negado pelo sistema operativo.

Observações

Este construtor inicializa um novo LogStore objeto que abre com o caminho, modo e acesso especificados. A loja é aberta partilhando o acesso especificado. O path parâmetro deve seguir a seguinte sintaxe:

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

onde <physical log name> é um caminho válido para um ficheiro de log, e <log client name> é um identificador único do cliente. Um log store deve ser ou físico ou virtual, mas não ambos. Uma vez que um armazenamento de logs foi criado física ou virtualmente, mantém-se assim durante toda a sua vida. Um armazenamento físico de logs é criado especificando apenas o nome físico do log. Um armazenamento virtual de registos é criado especificando tanto o nome físico do registo como o nome do cliente de log.

Clientes que partilham o mesmo nome físico de registo partilham a mesma extensão de recolha e política.

Aplica-se a