EventLog.MachineName Свойство

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.EventLog.dll

Пакет:

System.Diagnostics.EventLog v8.0.0

Исходный код:

EventLog.cs

Возвращает или задает имя компьютера, на котором производится чтение или запись событий.

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

Значение свойства

String

Имя сервера, на котором находится журнал событий. Значение по умолчанию — локальный компьютер (".").

Атрибуты

SettingsBindableAttribute

Исключения

ArgumentException

Недопустимое имя компьютера.

Примеры

В следующем примере считываются записи в журнале событий NewEventLog на указанном компьютере.

#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

Комментарии

При записи в журнал событий необходимо связать Source с объектом журнала событий, чтобы подключить его к определенному журналу. Необязательно указывать свойство при чтении Source только из журнала. Можно указать только Log имя и MachineName (имя компьютера сервера).

Примечание

При подключении к журналу MachineName указывать не нужно. Если не указать MachineName, предполагается локальный компьютер (".").

Источник может быть зарегистрирован только в одном журнале за раз. Source Если свойство было задано для экземпляра EventLog, нельзя изменить MachineName свойство для этогоEventLog, не изменив Source значение или вызвав DeleteEventSource первым. При изменении MachineName свойства EventLog закроется все дескрипторы и повторно присоединяется к журналу и источнику на новом компьютере.

Значение MachineName не может быть пустой строкой. Если он не задан явно, по умолчанию используется локальный компьютер (".").

См. также раздел

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