EventLog.MachineName-Eigenschaft

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

Namespace: System.Diagnostics
Assembly: System (in system.dll)

Syntax

'Declaration
Public Property MachineName As String
'Usage
Dim instance As EventLog
Dim value As String

value = instance.MachineName

instance.MachineName = value

public string MachineName { get; set; }

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

/** @property */
public String get_MachineName ()

/** @property */
public void set_MachineName (String value)

public function get MachineName () : String

public function set MachineName (value : String)

Eigenschaftenwert

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

Ausnahmen

Hinweise

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

Eine Quelle kann immer nur mit einem Protokoll registriert sein. Wenn die Source-Eigenschaft für eine Instanz von EventLog festgelegt wurde, können Sie die MachineName-Eigenschaft für dieses EventLog nicht ändern, ohne den Wert von Source zu ändern oder zuvor DeleteEventSource aufzurufen. Wenn Sie die MachineName-Eigenschaft ändern, schließt das EventLog alle Handles und stellt eine neue Verbindung zum Protokoll und der Quelle auf dem neuen Computer her.

Der MachineName-Wert kann keine leere Zeichenfolge sein. Wenn dieser Wert nicht explizit festgelegt wird, wird als Standardwert der lokale Computer verwendet (".").

Beispiel

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

Imports System
Imports System.Diagnostics
Imports Microsoft.VisualBasic

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 ' Main
End Class ' MySample

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);
        }    
    }       
}
   

#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 );
   }
}

import System.*;
import System.Diagnostics.*;
import System.Collections.*;

class MySample
{
    public static void main(String[] args)
    {
        EventLog myNewLog = new EventLog();
        myNewLog.set_Log("NewEventLog");
        myNewLog.set_MachineName("MyServer");        
        EventLogEntry entry;
        IEnumerator objEnum = myNewLog.get_Entries().GetEnumerator();
        while (objEnum.MoveNext()) {
            entry = (EventLogEntry)objEnum.get_Current();
            Console.WriteLine("\tEntry: " + entry.get_Message());
        }
    } //main
} //MySample

.NET Framework-Sicherheit

• EventLogPermission  zum Schreiben von Ereignisprotokollinformationen auf dem Computer. Zugeordnete Enumeration: EventLogPermissionAccess.Write

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

EventLog-Klasse
EventLog-Member
System.Diagnostics-Namespace
EventLog.Log-Eigenschaft
Source
CreateEventSource
DeleteEventSource
Delete
SourceExists
Exists
GetEventLogs