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 實體已設定 屬性，您就無法變更MachineName該 EventLog 實體EventLog的屬性，而不需要變更 或先呼叫 DeleteEventSource 的值Source。 如果您變更 MachineName 屬性，則會 EventLog 關閉所有句柄，並重新附加至新計算機上的記錄和來源。

值 MachineName 不能是空字串。 如果未明確設定，則會默認為本機計算機 (“。”) 。

另請參閱

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