EventSourceCreationData.LogName プロパティ

.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

C#

public string LogName { get;
 set; }

C++

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

J#

/** @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

C#

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";
}

.NET Framework のセキュリティ

• SecurityPermission  (完全信頼を指定して EventSourceCreationData のメンバを呼び出すために必要なアクセス許可) PermissionState.Unrestricted (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
EventSourceCreationData クラス
EventSourceCreationData メンバ
System.Diagnostics 名前空間
EventLogInstaller.Log プロパティ
EventLog.Exists