EventLog.MachineName Eigenschaft

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Paket:

System.Diagnostics.EventLog v8.0.0

Quelle:

EventLog.cs

Ruft den Namen des Computers ab, auf dem Ereignisse gelesen oder geschrieben werden sollen, oder legt diesen fest.

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

Eigenschaftswert

String

Der Name des Servers, auf dem das Ereignisprotokoll gespeichert ist. Der Standardwert ist der lokale Computer („.“).

Attribute

SettingsBindableAttribute

Ausnahmen

ArgumentException

Der Computername ist ungültig.

Beispiele

Im folgenden Beispiel werden Einträge im Ereignisprotokoll "NewEventLog" auf einem angegebenen Computer gelesen.

#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

Hinweise

Wenn Sie in ein Ereignisprotokoll schreiben, müssen Sie ihrem Ereignisprotokollobjekt einen Source zuordnen, um es mit einem bestimmten Protokoll zu verbinden. Es ist nicht erforderlich, die Source -Eigenschaft anzugeben, wenn nur aus einem Protokoll gelesen wird. Sie können nur den Log Namen und MachineName (Servercomputername) angeben.

Hinweis

Sie müssen nicht MachineName angeben, wenn Sie eine Verbindung mit einem Protokoll herstellen. Wenn Sie nicht angeben MachineName, wird der lokale Computer (".") angenommen.

Eine Quelle kann jeweils nur für ein Protokoll registriert werden. Wenn die Source -Eigenschaft für eine instance von EventLogfestgelegt wurde, können Sie die MachineName -Eigenschaft nicht ändern, EventLog ohne den Wert von Source zu ändern oder zuerst aufzurufenDeleteEventSource. Wenn Sie die MachineName -Eigenschaft ändern, EventLog werden alle Handles geschlossen und das Protokoll und die Quelle auf dem neuen Computer erneut angefügt.

Der MachineName Wert darf keine leere Zeichenfolge sein. Wenn sie nicht explizit festgelegt ist, wird standardmäßig der lokale Computer (".") verwendet.

Weitere Informationen

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