EventLog.Log Propriedade

Definição

Espaço de Nomes:
System.Diagnostics
Assemblagem:
System.dll

Recebe ou define o nome do registo para ler ou escrever.

public:
 property System::String ^ Log { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set
Public Property Log As String

Valor de Propriedade

String

O nome do log. Isto pode ser Aplicação, Sistema, Segurança ou um nome de registo personalizado. O padrão é uma cadeia vazia ("").

Atributos
TypeConverterAttribute SettingsBindableAttribute

Exemplos

O exemplo seguinte lê entradas no registo de eventos, "NewEventLog", no computador local.

using System;
using System.Diagnostics;

class MySample{

    public static void Main(){

        EventLog myNewLog = new EventLog();
        myNewLog.Log = "NewEventLog";
        foreach(EventLogEntry entry in myNewLog.Entries){
            Console.WriteLine("\tEntry: " + entry.Message);
        }
    }
}

Imports System.Diagnostics

Class MySample
    Public Shared Sub Main()
        Dim myNewLog As New EventLog()
        myNewLog.Log = "NewEventLog"
        Dim entry As EventLogEntry
        For Each entry In  myNewLog.Entries
            Console.WriteLine((ControlChars.Tab & "Entry: " & entry.Message))
        Next entry
    End Sub
End Class

Observações

Existem três ficheiros de registo por defeito no servidor: Aplicação, Sistema e Segurança. Aplicações e serviços utilizam o ficheiro de registo de Aplicação. Os drivers de dispositivos utilizam o ficheiro de registo do Sistema. O sistema gera eventos de auditoria de sucesso e falha no registo de Segurança quando a auditoria está ativada. Se tiveres outras aplicações instaladas, como o Active Directory nos servidores Windows, pode haver outros ficheiros de registo por defeito. Além disso, pode criar ficheiros de registo personalizados num computador local ou remoto. Registos personalizados ajudam a organizar as suas entradas de forma mais detalhada do que é permitido quando os seus componentes escrevem eventos no registo de aplicação padrão.

Note

Os nomes dos registos estão limitados a oito caracteres. De acordo com o sistema, MyLogSample1 e MyLogSample2 são o mesmo log.

Se escrever num registo de eventos, não basta especificar a Log propriedade. Deve associar uma Source propriedade ao seu recurso de registo de eventos para a ligar a um registo específico. Não é necessário especificar um Source quando apenas se está a ler de um registo, mas uma fonte de evento deve estar associada ao recurso do registo do registo do servidor. Podes especificar apenas o Log nome e MachineName (nome do computador servidor) a ler dele.

Note

Não é obrigado a especificar se MachineName está a ligar a um registo. Se não especificar o MachineName, assume-se o computador local (".").

Se a Source propriedade não tiver sido especificada, uma chamada para Log devolve uma cadeia vazia se Log não tiver sido explicitamente definida (definindo a Log propriedade, ou através do construtor). Se o Source ha sido especificado, Log devolve o nome do registo onde essa fonte foi registada.

Uma fonte só pode ser registada num registo de cada vez. Se a Source propriedade foi definida para uma instância de EventLog, não pode alterar a Log propriedade para isso EventLog sem alterar o valor de Source ou chamar DeleteEventSource primeiro. Se alterar a Log propriedade depois de ela Source ter sido definida, escrever uma entrada de registo abre uma exceção.

O sistema operativo armazena registos de eventos como ficheiros. Quando usa EventLogInstaller ou CreateEventSource cria um novo registo de eventos, o ficheiro associado é armazenado na pasta %SystemRoot%\System32\Config no computador especificado. O nome do ficheiro é definido adicionando os primeiros 8 caracteres da Log propriedade com a extensão do nome do ficheiro ".evt".

Não podes criar um novo registo apenas usando a Log propriedade (sem especificar uma fonte para o registo). Pode chamar CreateEventSource, passando um novo nome de log como parâmetro, e depois chamar DeleteEventSource. No entanto, a intenção é geralmente criar (e escrever entradas para) novos registos específicos da aplicação, ou ler a partir de registos existentes.

Se o Log valor mudar, o registo de eventos é encerrado e todos os handles de eventos são libertados.

Caution

Se definir a Log propriedade para o nome de um registo que não existe, o sistema anexa-o EventLog ao registo da Aplicação, mas não o avisa de que está a usar um registo diferente daquele que especificou.

Aplica-se a

Ver também