LogStore Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe LogStore.
Sobrecargas
| LogStore(SafeFileHandle) |
Inicializa uma nova instância da classe LogStore para o identificador especificado. |
| LogStore(String, FileMode) |
Inicializa uma nova instância da classe LogStore com o caminho e o modo especificados. |
| LogStore(String, FileMode, FileAccess) |
Inicializa uma nova instância da classe LogStore 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 classe LogStore 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.LogStorePublic Sub New (handle As SafeFileHandle)Parâmetros
- handle
- SafeFileHandle
Um identificador de arquivo de log para o arquivo que o objeto LogStore atual encapsula.
Exceções
handle é null.
Não foi possível vincular o identificador de log ao pool de threads.
O acesso ao repositório de log 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 classe LogStore 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.LogStorePublic Sub New (path As String, mode As FileMode)Parâmetros
- path
- String
Um caminho relativo ou absoluto para o arquivo de base do repositório de log a abrir.
Exceções
path é null.
path é uma cadeia de caracteres vazia ("").
- ou -
path contém somente espaços 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.
Ocorrerá um erro de E/S ao abrir o repositório de log.
O acesso ao repositório de log especificado é negado pelo sistema operacional.
LogStore não pode ser usado porque o componente CLFS (Sistema de Arquivos de Log Comum) necessário não está instalado. Instale o componente CLFS se ele estiver disponível para sua plataforma ou use a classe FileRecordSequence em vez disso.
Não há memória suficiente para continuar a execução de um programa.
Comentários
Use esse 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>]
em que <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 log virtual, mas não ambos. Depois que um repositório de logs tiver sido criado física ou virtualmente, ele permanecerá assim durante 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 classe LogStore 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.LogStorePublic Sub New (path As String, mode As FileMode, access As FileAccess)Parâmetros
- path
- String
Um caminho relativo ou absoluto para o arquivo de base do repositório de log a abrir.
- access
- FileAccess
Uma dos valores de FileAccess que determina como o arquivo pode ser acessado pelo LogStore.
Exceções
path é null.
path é uma cadeia de caracteres vazia ("").
- ou -
path contém somente espaços em branco.
- ou -
path contém um ou mais caracteres inválidos.
O arquivo não pode ser encontrado.
Ocorrerá um erro de E/S ao abrir o repositório de log.
O acesso ao repositório de log especificado é negado pelo sistema operacional.
LogStore não pode ser usado porque o componente CLFS (Sistema de Arquivos de Log Comum) necessário não está instalado. Instale o componente CLFS se ele estiver disponível para sua plataforma ou use a classe FileRecordSequence em vez disso.
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>]
em que <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 log virtual, mas não ambos. Depois que um repositório de logs tiver sido criado física ou virtualmente, ele permanecerá assim durante 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.LogStorePublic 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 arquivo de base do repositório de log a abrir.
- access
- FileAccess
Uma dos valores de FileAccess que determina como o arquivo pode ser acessado pelo LogStore.
- share
- FileShare
Um dos valores FileShare que determina como o repositório de log será compartilhado entre processos.
Exceções
path é null.
path é uma cadeia de caracteres vazia ("").
- ou -
path contém somente espaços 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 arquivo não pode ser encontrado.
Ocorrerá um erro de E/S ao abrir o repositório de log.
O acesso ao repositório de log especificado é negado pelo sistema operacional.
LogStore não pode ser usado porque o componente CLFS (Sistema de Arquivos de Log Comum) necessário não está instalado. Instale o componente CLFS se ele estiver disponível para sua plataforma ou use a classe FileRecordSequence em vez disso.
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>]
em que <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 log virtual, mas não ambos. Depois que um repositório de logs tiver sido criado física ou virtualmente, ele permanecerá assim durante 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.LogStorePublic 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 arquivo de base do repositório de log a abrir.
- access
- FileAccess
Uma dos valores de FileAccess que determina como o arquivo pode ser acessado pelo LogStore.
- share
- FileShare
Um dos valores FileShare que determina como o repositório de log será compartilhado entre processos.
- fileSecurity
- FileSecurity
Um dos valores FileSecurity que especifica a segurança a definir no repositório recém-criado, caso o repositório deva ser criado.
Exceções
path é null.
O nome do arquivo de repositório de log especificado pelo 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.
-ou
access contém um valor inválido.
- ou -
share contém um valor inválido.
O arquivo não pode ser encontrado.
Ocorrerá um erro de E/S ao abrir o repositório de log.
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 -
Não foi possível vincular o identificador de log ao pool de threads.
- ou -
A versão ou o formato de arquivo de log especificado é inválido.
LogStore não pode ser usado porque o componente CLFS (Sistema de Arquivos de Log Comum) necessário não está instalado. Instale o componente CLFS se ele estiver disponível para sua plataforma ou use a classe FileRecordSequence em vez disso.
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 log 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>]
em que <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 log virtual, mas não ambos. Depois que um repositório de logs tiver sido criado física ou virtualmente, ele permanecerá assim durante 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.
