EventLog.MachineName 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 computador em que os eventos devem ser lidos ou gravados.

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

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

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

Public Property MachineName As String

Valor da propriedade

String

O nome do servidor no qual reside o log de eventos. O padrão é o computador local (".").

Atributos

SettingsBindableAttribute

Exceções

ArgumentException

O nome do computador é inválido.

Exemplos

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

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
int main()
{
   EventLog^ myNewLog = gcnew EventLog;
   myNewLog->Log = "NewEventLog";
   myNewLog->MachineName = "MyServer";
   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";
        myNewLog.MachineName = "MyServer";
        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"
        myNewLog.MachineName = "MyServer"
        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

Se você gravar em um log de eventos, deverá associar um Source ao objeto de log de eventos para conectá-lo a um log específico. Não é necessário especificar a Source propriedade ao ler apenas de um log. Você pode especificar apenas o nome e MachineName (nome do Log computador do servidor).

Observação

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

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 MachineName propriedade para isso EventLog sem alterar o valor de Source ou chamar DeleteEventSource primeiro. Se você alterar a MachineName propriedade , o EventLog fechará todos os identificadores e reanexa ao log e à origem no novo computador.

O MachineName valor não pode ser uma cadeia de caracteres vazia. Se não estiver definido explicitamente, o padrão será o computador local (".").

Confira também

• Log
• Source
• CreateEventSource
• DeleteEventSource(String)
• Delete(String)
• SourceExists(String)
• Exists(String)
• GetEventLogs()