LogStore Construtores

Definição

Inicializa uma nova instância da classe LogStore.

Sobrecargas

Nome Description
LogStore(SafeFileHandle)

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

LogStore(String, FileMode)

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

LogStore(String, FileMode, FileAccess)

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

LogStore(String, FileMode, FileAccess, FileShare)

Inicializa uma nova instância da classe LogStore.

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

Inicializa uma nova instância da classe LogStore.

LogStore(SafeFileHandle)

Inicializa uma nova instância da LogStore classe para o identificador 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 identificador de arquivo para o arquivo de log que o objeto atual LogStore encapsula.

Exceções

handle é null.

O identificador de log não pôde ser associado ao pool de threads.

O acesso ao repositório de logs especificado é negado pelo sistema operacional.

O método foi chamado depois que a sequência foi descartada.

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 o 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 que o arquivo base do repositório de logs seja aberto.

mode
FileMode

Um dos FileMode valores que determina como abrir ou criar o repositório.

Exceções

path é null.

path é uma cadeia de caracteres 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 arquivo não pode ser encontrado.

Ocorre um erro de E/S ao abrir o repositório de logs.

O acesso ao repositório de logs especificado é negado pelo sistema operacional.

LogStore não pode ser usado porque o componente CLFS (Common Log File System) necessário não está instalado. Instale o componente CLFS se ele estiver disponível para sua plataforma ou usar a FileRecordSequence classe.

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

Comentários

Use este construtor para abrir um repositório de logs com o caminho e o modo especificados. O repositório é aberto com acesso de leitura/gravação e compartilha 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 arquivo de log e <log client name> é um identificador de cliente exclusivo. Um repositório de logs deve ser um repositório de log físico ou um repositório de logs virtual, mas não ambos. Depois que um repositório de logs tiver sido criado física ou virtualmente, ele permanecerá assim por seu tempo de vida. Um repositório de log físico é criado especificando apenas o nome do log físico. Um repositório de logs virtual é criado especificando o nome do log físico e o nome do cliente de log.

Os clientes que compartilham o mesmo nome de log físico compartilham a mesma coleção e política de extensões.

Aplica-se a

LogStore(String, FileMode, FileAccess)

Inicializa uma nova instância da LogStore classe com o caminho, o modo e o 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 que o arquivo base do repositório de logs seja aberto.

mode
FileMode

Um dos FileMode valores que determina como abrir ou criar o repositório.

access
FileAccess

Um dos FileAccess valores que determina como o arquivo pode ser acessado pelo LogStore.

Exceções

path é null.

path é uma cadeia de caracteres 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.

-or

access contém um valor inválido.

O arquivo não pode ser encontrado.

Ocorre um erro de E/S ao abrir o repositório de logs.

O acesso ao repositório de logs especificado é negado pelo sistema operacional.

LogStore não pode ser usado porque o componente CLFS (Common Log File System) necessário não está instalado. Instale o componente CLFS se ele estiver disponível para sua plataforma ou usar a FileRecordSequence classe.

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

Comentários

Use esse construtor para abrir um novo repositório de logs com o caminho, o modo e o acesso especificados. O repositório é aberto compartilhando 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 arquivo de log e <log client name> é um identificador de cliente exclusivo. Um repositório de logs deve ser um repositório de log físico ou um repositório de logs virtual, mas não ambos. Depois que um repositório de logs tiver sido criado física ou virtualmente, ele permanecerá assim por seu tempo de vida. Um repositório de log físico é criado especificando apenas o nome do log físico. Um repositório de logs virtual é criado especificando o nome do log físico e o nome do cliente de log.

Os clientes que compartilham o mesmo nome de log físico compartilham a mesma coleção e política de extensões.

Aplica-se a

LogStore(String, FileMode, FileAccess, FileShare)

Inicializa uma nova instância da 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)

Parâmetros

path
String

Um caminho relativo ou absoluto para que o arquivo base do repositório de logs seja aberto.

mode
FileMode

Um dos FileMode valores que determina como abrir ou criar o repositório.

access
FileAccess

Um dos FileAccess valores que determina como o arquivo pode ser acessado pelo LogStore.

share
FileShare

Um dos FileShare valores que determina como o repositório de logs será compartilhado entre os processos.

Exceções

path é null.

path é uma cadeia de caracteres 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.

-or

access contém um valor inválido.

- ou -

share contém um valor inválido.

O arquivo não pode ser encontrado.

Ocorre um erro de E/S ao abrir o repositório de logs.

O acesso ao repositório de logs especificado é negado pelo sistema operacional.

LogStore não pode ser usado porque o componente CLFS (Common Log File System) necessário não está instalado. Instale o componente CLFS se ele estiver disponível para sua plataforma ou usar a FileRecordSequence classe.

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

Comentários

Esse construtor inicializa um novo LogStore objeto que ele abre com o caminho, o modo e o acesso especificados. O repositório é aberto compartilhando 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 arquivo de log e <log client name> é um identificador de cliente exclusivo. Um repositório de logs deve ser um repositório de log físico ou um repositório de logs virtual, mas não ambos. Depois que um repositório de logs tiver sido criado física ou virtualmente, ele permanecerá assim por seu tempo de vida. Um repositório de log físico é criado especificando apenas o nome do log físico. Um repositório de logs virtual é criado especificando o nome do log físico e o nome do cliente de log.

Os clientes que compartilham o mesmo nome de log físico compartilham a mesma coleção e política de extensões.

Aplica-se a

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

Inicializa uma nova instância da 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)

Parâmetros

path
String

Um caminho relativo ou absoluto para que o arquivo base do repositório de logs seja aberto.

mode
FileMode

Um dos FileMode valores que determina como abrir ou criar o repositório.

access
FileAccess

Um dos FileAccess valores que determina como o arquivo pode ser acessado pelo LogStore.

share
FileShare

Um dos FileShare valores que determina como o repositório de logs será compartilhado entre os processos.

fileSecurity
FileSecurity

Um dos FileSecurity valores que especifica a segurança a ser definida no repositório recém-criado se o repositório precisar ser criado.

Exceções

path é null.

O nome do arquivo do repositório de logs especificado por path não é válido.

- ou -

mode é CreateNew, que não pode ser usado sem acesso de gravação.

- ou -

mode é OpenOrCreate, que não pode ser usado sem acesso de gravação.

mode contém um valor inválido.

-or

access contém um valor inválido.

- ou -

share contém um valor inválido.

O arquivo não pode ser encontrado.

Ocorre um erro de E/S ao abrir o repositório de logs.

O arquivo especificado por path não pode ser acessado porque está em uso por outro processo.

- ou -

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

- ou -

O identificador de log não pôde ser associado ao pool de threads.

- ou -

O formato ou a versão do arquivo de log especificado é inválido.

LogStore não pode ser usado porque o componente CLFS (Common Log File System) necessário não está instalado. Instale o componente CLFS se ele estiver disponível para sua plataforma ou usar a FileRecordSequence classe.

O método foi chamado depois que a sequência foi descartada.

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

A sequência de registros está cheia.

O acesso ao repositório de logs especificado é negado pelo sistema operacional.

Comentários

Esse construtor inicializa um novo LogStore objeto que ele abre com o caminho, o modo e o acesso especificados. O repositório é aberto compartilhando 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 arquivo de log e <log client name> é um identificador de cliente exclusivo. Um repositório de logs deve ser um repositório de log físico ou um repositório de logs virtual, mas não ambos. Depois que um repositório de logs tiver sido criado física ou virtualmente, ele permanecerá assim por seu tempo de vida. Um repositório de log físico é criado especificando apenas o nome do log físico. Um repositório de logs virtual é criado especificando o nome do log físico e o nome do cliente de log.

Os clientes que compartilham o mesmo nome de log físico compartilham a mesma coleção e política de extensões.

Aplica-se a