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

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

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

EventSourceCreationData.LogName プロパティ

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

ソースがエントリを書き込むイベントログの名前を取得または設定します。

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

Visual Basic (宣言)

Public Property LogName As
 String

Visual Basic (使用法)

Dim instance As EventSourceCreationData
Dim value As String

value = instance.LogName

instance.LogName = value

public string LogName { get;
 set; }

C++

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

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

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

JScript

public function get LogName
 () : String

public function set LogName
 (value : String)

プロパティ値
イベントログの名前。ログ名には、アプリケーションログ名、システムログ名、またはカスタムログ名を指定できます。既定値は "Application" です。

解説

新しいソースを使用して、アプリケーションがエントリを書き込むイベントログを識別するには、LogName プロパティを使用します。イベントログは、新規または既存のログを使用できます。アプリケーションおよびサービスは、アプリケーションログまたはカスタムログに書き込みます。デバイスドライバは、システムログに書き込みます。LogName プロパティを明示的に設定しなかった場合は、既定によりアプリケーションログに設定されます。

メモ
セキュリティログは読み取り専用です。

新しいソース用として既存のログをイベントログに指定するには、LogName プロパティを既存のイベントログ名に設定します。ソースの新しいイベントログを作成するには、LogName プロパティを設定する必要があります。イベントログ名は、印字可能な文字で構成されている必要があります。文字 '*'、'?'、または '\' を含めないでください。イベントログ名の最初の 8 文字は、指定されたコンピュータの既存のイベントログ名の最初の 8 文字と異なっている必要があります。

オペレーティングシステムでは、イベントのログがファイルとして保存されます。新しいイベントログの作成に EventLogInstaller または CreateEventSource メソッドを使用すると、関連するファイルは、指定されたコンピュータの %SystemRoot%\System32\Config ディレクトリに格納されます。ファイル名は、LogName プロパティの最初の 8 文字と ".evt" というファイル名拡張子を付け加えることによって設定されます。

使用例

コマンドライン引数からイベントソースの構成プロパティを設定するコード例を次に示します。入力引数は、イベントソース名、イベントログ名、コンピュータ名、およびイベントメッセージリソースファイルを指定します。このコード例は、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";
}