EventLog.Log Propriedade

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Pacote:

System.Diagnostics.EventLog v8.0.0

Origem:

EventLog.cs

Obtém ou define o nome do log a ser lido ou gravado.

public:
 property System::String ^ Log { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.SettingsBindable(true)]
public string Log { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.Log : string with get, set

Public Property Log As String

Valor da propriedade

String

O nome do log. Pode ser o log de Aplicativo, Sistema, Segurança ou um nome de log personalizado. O padrão é uma cadeia de caracteres vazia ("").

Atributos

SettingsBindableAttribute

Exemplos

O exemplo a seguir lê entradas no log de eventos, "NewEventLog", no computador local.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
int main()
{
   EventLog^ myNewLog = gcnew EventLog;
   myNewLog->Log = "NewEventLog";
   System::Collections::IEnumerator^ myEnum = myNewLog->Entries->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      EventLogEntry^ entry = safe_cast<EventLogEntry^>(myEnum->Current);
      Console::WriteLine( "\tEntry: {0}", entry->Message );
   }
}

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

Comentários

Três arquivos de log existem por padrão no servidor: Aplicativo, Sistema e Segurança. Aplicativos e serviços usam o arquivo de log do aplicativo. Os drivers de dispositivo usam o arquivo de log do sistema. O sistema gera eventos de auditoria de êxito e falha no log de segurança quando a auditoria é ativada. Se você tiver outros aplicativos instalados, como o Active Directory em servidores Windows, poderá haver outros arquivos de log padrão. Além disso, você pode criar arquivos de log personalizados em um computador local ou remoto. Os logs personalizados ajudam a organizar suas entradas de maneira mais detalhada do que o permitido quando os componentes gravam eventos no log de aplicativo padrão.

Observação

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

Se você gravar em um log de eventos, não será suficiente especificar a Log propriedade . Você deve associar uma Source propriedade ao recurso de log de eventos para conectá-la a um log específico. Não é necessário especificar um Source ao ler apenas de um log, mas uma origem do evento deve ser associada ao recurso de log de eventos no registro do servidor. Você pode especificar apenas o Log nome e MachineName (nome do computador do servidor) para ler dele.

Observação

Você não precisará especificar o MachineName se estiver se conectando a um log. Se você não especificar o MachineName, o computador local (".") será assumido.

Se a Source propriedade não tiver sido especificada, uma chamada para Log retornará uma cadeia de caracteres vazia se Log não tiver sido definida explicitamente (definindo a Log propriedade ou por meio do construtor). Se o Source tiver sido especificado, Log retornará o nome do log ao qual essa origem foi registrada.

Uma fonte só pode ser registrada em um log por vez. Se a Source propriedade foi definida para uma instância do EventLog, você não poderá alterar a Log propriedade para isso EventLog sem alterar o valor de Source ou chamar DeleteEventSource primeiro. Se você alterar a Log propriedade depois que a Source propriedade tiver sido definida, gravar uma entrada de log gerará uma exceção.

O sistema operacional armazena os logs de eventos como arquivos. Quando você usa EventLogInstaller ou CreateEventSource para criar um novo log de eventos, o arquivo associado é armazenado no diretório %SystemRoot%\System32\Config no computador especificado. O nome do arquivo é definido acrescentando os primeiros 8 caracteres da Log propriedade com a extensão de nome de arquivo ".evt".

Você não pode criar um novo log usando a Log propriedade sozinho (sem especificar uma origem para o log). Você pode chamar CreateEventSource, passando um novo nome de log como um parâmetro e, em seguida, chamar DeleteEventSource. No entanto, a intenção geralmente é criar (e gravar entradas em) novos logs específicos do aplicativo ou ler de logs existentes.

Se o Log valor for alterado, o log de eventos será fechado e todos os identificadores de evento serão liberados.

Cuidado

Se você definir a Log propriedade como o nome de um log que não existe, o sistema anexará o EventLog ao log do aplicativo, mas não avisará que ele está usando um log diferente daquele especificado.

Confira também

• MachineName
• Source
• Entries
• Exists(String)
• Delete(String)
• CreateEventSource
• EventLogEntryCollection