HOW TO：設定 EventLog 元件執行個體

更新：2007 年 11 月

設定 EventLog 元件執行個體會涉及三個主要屬性 (Property)：

• Log 屬性會指出您要與之互動的記錄檔。

• MachineName 屬性會指出您所用之記錄檔所在的電腦。

• Source 屬性會指出用來識別將項目寫入記錄檔之元件的來源字串。

設定 EventLog 元件執行個體的方式會根據您所規劃的使用情形而有所不同：

• 如果您要將項目寫入至記錄檔，您必須執行下列任一步驟。您必須使用 CreateEventSource 方法登錄來源，然後將 EventLog 元件的 Source 屬性設定為該相同來源，或者必須設定元件的 MachineName、Log 和 Source 屬性。

  注意事項：
  您可以直接在元件上設定 Log 屬性，或是在程式碼中設定將元件登錄為事件的來源。在將元件登錄為來源之後，伺服器登錄中已經設定好的連接會將您的元件與特定記錄檔連結在一起。

• 假如您計劃讀取記錄檔項目或是監看記錄檔，則必須設定 MachineName 和 Log 屬性，來指定所要監看的記錄檔。在此情況下，您不必設定 Source 屬性。

• 如果您想要元件能夠接收 EntryWritten 事件的告知，則必須將 EnableRaisingEvents 設定為 true。如需詳細資訊，請參閱 HOW TO：處理 EntryWritten 事件。

  下面的範例示範如何設定可讓您將項目寫入應用程式記錄檔的元件。在此情況下，來源尚未用記錄檔完成登錄，所以您必須指定來源字串、記錄檔及電腦名稱。您不需要明確呼叫 CreateEventSource 方法，因為若來源尚未登錄，則 WriteEntry 呼叫會將來源登錄在記錄檔中。

  Dim EventLog1 As New EventLog("Application", "myserver", "newsource")
  EventLog1.WriteEntry("Test")
  

       System.Diagnostics.EventLog EventLog1 = new
             System.Diagnostics.EventLog("Application", "myserver", "newsource");
          EventLog1.WriteEntry("Test");
  

  如果該來源已經登錄，則您只需設定 Source 屬性並寫入項目即可。例如，下面的程式碼示範如何使用一個已經登錄過的來源將項目寫入記錄檔。

  If Not EventLog.SourceExists("ExistingSourceString") Then
      EventLog.CreateEventSource("ExistingSourceString", "Application")
  End If
  Dim EventLog1 As New EventLog()
  EventLog1.Source = "ExistingSourceString"
  EventLog1.WriteEntry("TestEntry2")
  

       if (!System.Diagnostics.EventLog.SourceExists("ExistingSourceString"))
              System.Diagnostics.EventLog.CreateEventSource(
                 "ExistingSourceString", "Application");
  
          System.Diagnostics.EventLog EventLog1 =
             new System.Diagnostics.EventLog();
          EventLog1.Source = "ExistingSourceString";
          EventLog1.WriteEntry("TestEntry2");
  

  注意事項：
  如果您未在上述範例中設定 MachineName 屬性，則會假設為本機電腦。

  如需這些屬性的詳細資訊，請參閱事件記錄檔參考。

  您從事件記錄檔裡所擷取的項目可以用多個屬性加以分類。如需使用這些屬性的詳細資訊，請參閱 EventLog。

若要設定一個 EventLog 元件的執行個體

1. 建立 EventLog 元件的執行個體。如需詳細資訊，請參閱 HOW TO：建立 EventLog 元件執行個體。

2. 設定 Log、MachineName 和 Source 屬性的適當組合：

   假如您想要	請執行
   讀取或者監視事件記錄檔	設定 Log 和 MachineName
   用新的 Source 字串將項目寫入記錄檔	設定 Source、Log 和 MachineName
   為現有的 Source 將項目寫入至記錄檔	設定 Source 屬性給現有的來源，其他屬性則會自動設定

3. 若要讓元件執行個體能夠收到 EntryWritten 事件的告知，請將 EnableRaisingEvents 屬性設定為 true。

請參閱

工作

HOW TO：建立 EventLog 元件執行個體

HOW TO：加入應用程式做為事件記錄檔項目來源

HOW TO：將項目寫入事件記錄檔

概念

事件記錄檔參考