EventLog.Source 屬性

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.EventLog.dll

套件:

System.Diagnostics.EventLog v8.0.0

來源:

EventLog.cs

取得或設定寫入至事件記錄檔時登錄和使用的來源名稱。

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

[System.ComponentModel.SettingsBindable(true)]
public string Source { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.Source : string with get, set

Public Property Source As String

屬性值

String

這個名稱 (具有事件記錄檔)，被登錄為項目的來源。 預設為空字串 ("")。

屬性

SettingsBindableAttribute

例外狀況

ArgumentException

來源名稱產生的登錄機碼路徑長度超過 254 個字元。

範例

如果來源不存在，下列範例會建立來源 MySource ，並將專案寫入事件記錄檔 MyNewLog。

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create the source, if it does not already exist.
   if (  !EventLog::SourceExists( "MySource" ) )
   {
      EventLog::CreateEventSource( "MySource", "MyNewLog" );
      Console::WriteLine( "CreatingEventSource" );
   }

   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog;
   myLog->Source = "MySource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing to event log." );
   Console::WriteLine( "Message written to event log." );
}

using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource"))
        {
            // An event log source should not be created and immediately used.
            // There is a latency time to enable the source, it should be created
            // prior to executing the application that uses the source.
            // Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatingEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "MySource";

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing to event log.");

        Console.WriteLine("Message written to event log.");
    }
}

Option Explicit
Option Strict
Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create the source, if it does not already exist.
        If Not EventLog.SourceExists("MySource") Then
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
        
        Console.WriteLine("Message written to event log.")
    End Sub
End Class

備註

事件來源會指出記錄事件的內容。 如果應用程式很大，通常是應用程式的名稱，或應用程式的子元件名稱。 應用程式和服務應該寫入應用程式記錄檔或自定義記錄檔。 設備驅動器應該寫入系統記錄檔。

只有在寫入事件記錄檔時，才需要指定事件來源。 將專案寫入事件記錄檔之前，您必須將事件來源註冊為事件的有效來源。 當您寫入記錄專案時，系統會使用 Source 屬性來尋找要放置專案的適當記錄檔。 如果您要讀取事件記錄檔，您可以指定 Source或 與 。 LogMachineName

注意

如果您連線到本機電腦上的記錄檔，則不需要指定 MachineName 。 如果您未指定 MachineName，本機計算機 (“。”假設 ) 。

使用 WriteEvent 和 WriteEntry 將事件寫入事件記錄檔。 您必須指定事件來源來寫入事件;您必須先建立並設定事件來源，才能使用來源撰寫第一個專案。

在安裝應用程式期間 Create 新的事件來源。 這可讓操作系統重新整理其已註冊事件來源及其設定的清單。 如果操作系統尚未重新整理其事件來源清單，而且您嘗試使用新來源寫入事件，則寫入作業將會失敗。 您可以使用 來設定新的來源 EventLogInstaller，或使用 CreateEventSource 方法。 您必須擁有計算機上的系統管理許可權，才能建立新的事件來源。

您可以為現有的事件記錄檔或新的事件記錄檔建立事件來源。 當您為新的事件記錄檔建立新的來源時，系統會註冊該記錄檔的來源，但在寫入第一個專案之前，不會建立記錄檔。

來源在本機計算機上必須是唯一的;新的來源名稱不符合現有的來源名稱或現有的事件記錄檔名稱。 每個來源一次只能寫入一個事件記錄檔;不過，您的應用程式可以使用多個來源來寫入多個事件記錄檔。 例如，您的應用程式可能需要針對不同的事件記錄檔或不同的資源檔案設定多個來源。

如果您變更 Source 值， EventLog 則會關閉其註冊的 ，並釋放所有事件句柄。

來源必須設定為撰寫本地化專案，或撰寫直接字串。 如果您的應用程式同時使用資源識別碼和字串值來寫入專案，您必須註冊兩個不同的來源。 例如，使用資源文件設定一個來源，然後在方法中使用 WriteEvent 該來源，使用資源標識符將專案寫入事件記錄檔。 然後建立不含資源檔的不同來源，並在方法中使用 WriteEntry 該來源直接將字串寫入事件記錄檔。

若要變更現有來源的組態詳細數據，您必須刪除來源，然後使用新的組態加以建立。 如果其他應用程式或元件使用現有的來源，請使用更新的組態建立新的來源，而不是刪除現有的來源。

注意

如果來源已經對應到記錄檔，而且您重新將它對應到新的記錄檔，您必須重新啟動計算機，變更才會生效。

另請參閱

• Log
• MachineName
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)