EventSourceCreationData.Source プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

EventSourceCreationData.Source プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

イベントソースとしてイベントログに登録する名前を取得または設定します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Property Source As
 String

Visual Basic (使用法)

Dim instance As EventSourceCreationData
Dim value As String

value = instance.Source

instance.Source = value

public string Source { get;
 set; }

C++

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

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

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

JScript

public function get Source
 () : String

public function set Source
 (value : String)

プロパティ値
エントリのソースとしてイベントログに登録する名前。既定値は空の文字列 ("") です。

解説

ソース名には、通常はアプリケーションの名前か、アプリケーションが大規模な場合はコンポーネントの名前を指定します。EventLog.CreateEventSource(EventSourceCreationData) メソッドは、Source、LogName、および MachineName の各プロパティを使用して、新しいソースおよび関連するイベントログの登録先のコンピュータでレジストリ値を作成します。新しいソース名は、登録先のコンピュータの既存のソース名または既存のイベントログ名と異なっている必要があります。

ソースのレジストリ値が作成されると、アプリケーションはそのソースを使用して、エントリを構成済みのイベントログに書き込むことができます。

各ソースは、同時に 1 つのイベントログだけに書き込むことができます。ただし、アプリケーションは複数のソースを使用して、複数のイベントログに書き込むことができます。たとえば、アプリケーションには、異なるイベントログまたは異なるリソースファイル用に構成された複数のソースが必要になる場合があります。

使用例

コマンドライン引数からイベントソースの構成プロパティを設定するコード例を次に示します。入力引数は、イベントソース名、イベントログ名、コンピュータ名、およびイベントメッセージリソースファイルを指定します。このコード例は、EventSourceCreationData クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Dim mySourceData As EventSourceCreationData
 = new EventSourceCreationData("",
 "")
Dim registerSource As Boolean
 = True

' Process input parameters.
If args.Length > 0
    ' Require at least the source name.

    mySourceData.Source = args(0)

    If args.Length > 1
   
        mySourceData.LogName = args(1)
    
    End If
    If args.Length > 2
   
        mySourceData.MachineName = args(2)
    
    End If
    If args.Length > 3 AndAlso args(3).Length
 > 0
   
        mySourceData.MessageResourceFile = args(3)
    
    End If

Else 
    ' Display a syntax help message.
    Console.WriteLine("Input:")
    Console.WriteLine(" source [event log] [machine name] [resource
 file]")

    registerSource = False
End If

' Set defaults for parameters missing input.
If mySourceData.MachineName.Length = 0

    ' Default to the local computer.
    mySourceData.MachineName = "."
End If
If mySourceData.LogName.Length = 0
    ' Default to the Application log.
    mySourceData.LogName = "Application"
End If

EventSourceCreationData mySourceData = new EventSourceCreationData("",
 "");
bool registerSource = true;

// Process input parameters.
if (args.Length > 0)
{
    // Require at least the source name.

    mySourceData.Source = args[0];

    if (args.Length > 1)
    {
        mySourceData.LogName = args[1];
    }

    if (args.Length > 2)
    {
        mySourceData.MachineName = args[2];
    }
    if ((args.Length > 3) && (args[3].Length > 0))
    {
        mySourceData.MessageResourceFile = args[3];
    }
}
else 
{
    // Display a syntax help message.
    Console.WriteLine("Input:");
    Console.WriteLine(" source [event log] [machine name] [resource file]");

    registerSource = false;
}

// Set defaults for parameters missing input.
if (mySourceData.MachineName.Length == 0)
{
    // Default to the local computer.
    mySourceData.MachineName = ".";
}
if (mySourceData.LogName.Length == 0)
{
    // Default to the Application log.
    mySourceData.LogName = "Application";
}

C++

EventSourceCreationData ^ mySourceData = gcnew EventSourceCreationData( "",""
 );
bool registerSource = true;

// Process input parameters.
if ( args->Length > 1 )
{
   
   // Require at least the source name.
   mySourceData->Source = args[ 1 ];
   if ( args->Length > 2 )
   {
      mySourceData->LogName = args[ 2 ];
   }

   if ( args->Length > 3 )
   {
      mySourceData->MachineName = args[ 3 ];
   }

   if ( (args->Length > 4) && (args[ 4 ]->Length
 > 0) )
   {
      mySourceData->MessageResourceFile = args[ 4 ];
   }
}
else
{
   
   // Display a syntax help message.
   Console::WriteLine( "Input:" );
   Console::WriteLine( " source [event log] [machine name] [resource file]"
 );
   registerSource = false;
}


// Set defaults for parameters missing input.
if ( mySourceData->MachineName->Length == 0 )
{
   
   // Default to the local computer.
   mySourceData->MachineName = ".";
}

if ( mySourceData->LogName->Length == 0 )
{
   
   // Default to the Application log.
   mySourceData->LogName = "Application";
}