EventSourceCreationData コンストラクタとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

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

EventSourceCreationData コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定したイベントソースおよびイベントログ名を使用して、EventSourceCreationData クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    source As String, _
    logName As String _
)

Visual Basic (使用法)

Dim source As String
Dim logName As String

Dim instance As New EventSourceCreationData(source,
 logName)

public EventSourceCreationData (
    string source,
    string logName
)

C++

public:
EventSourceCreationData (
    String^ source, 
    String^ logName
)

public EventSourceCreationData (
    String source, 
    String logName
)

JScript

public function EventSourceCreationData (
    source : String, 
    logName : String
)

パラメータ

source: エントリのソースとしてイベントログに登録する名前。

logName: ソースのエントリが書き込まれるログの名前。

解説

エントリをイベントログに書き込むには、イベントログのイベントソースを作成する必要があります。新しいソースを登録するには、EventSourceCreationData インスタンスを初期化して、アプリケーションのインスタンスプロパティを構成し、EventLog.CreateEventSource(EventSourceCreationData) メソッドを呼び出します。ソースが登録されると、WriteEvent または WriteEntry メソッドを使用してソースからエントリを書き込むことができます。

イベントカテゴリおよびメッセージ文字列のローカライズされたリソースにイベントソースを登録できます。アプリケーションは、実際の文字列を指定するのではなく、リソース識別子を使用してイベントログエントリを書き込むことができます。イベントビューアでは、リソース識別子を使用して、ローカライズされたリソースファイルから、現在の言語設定に基づく対応する文字列を検索して表示させることができます。イベントカテゴリ、メッセージ、およびパラメータ挿入文字列に個別のファイルを登録することも、この 3 種類の文字列に同じリソースファイルを登録することもできます。ローカライズされたエントリをイベントログに書き込むようにソースを構成するには、CategoryCount、CategoryResourceFile、MessageResourceFile、および ParameterResourceFile の各プロパティを使用します。アプリケーションが文字列値を直接イベントログに書き込む場合、これらのプロパティを設定する必要はありません。

ソースは、ローカライズされたエントリを書き込むか、または直接の文字列を書き込むように構成されている必要があります。アプリケーションがリソース識別子と文字列値の両方を使用してエントリを書き込む場合、2 つの異なるソースを登録する必要があります。たとえば、複数のリソースファイルを持つ 1 つのソースを構成してから、WriteEvent メソッドでこのソースを使用し、リソース識別子によってエントリをイベントログに書き込みます。次に、リソースファイルを使わずに作成した別のソースを WriteEntry メソッドで使用し、文字列を直接イベントログに書き込みます。

EventSourceCreationData の初期プロパティ値を次の表に示します。

プロパティ	初期値
Source	source パラメータ。
LogName	logName パラメータ。
MachineName	ローカルコンピュータ (".")。
CategoryCount	0
CategoryResourceFile	null 参照 (Visual Basic では Nothing) (Visual Basic の場合は Nothing)。
MessageResourceFile	null 参照 (Visual Basic では Nothing) (Visual Basic の場合は Nothing)。
ParameterResourceFile	null 参照 (Visual Basic では Nothing) (Visual Basic の場合は Nothing)。

使用例

SampleApplicationSource という名前のイベントソースがローカルコンピュータに登録されているかどうかを確認するコード例を次に示します。この例では、イベントソースが存在しない場合、ソースに対応するメッセージリソースファイルを設定し、新しいイベントソースを作成します。最後にコード例は、DisplayNameMsgId のリソース識別子の値と messageFile のリソースファイルパスを使用し、イベントログに対してローカライズされた表示名を設定します。

Visual Basic

Dim myLogName As String
Dim sourceName As String
 = "SampleApplicationSource"

' Create the event source if it does not exist.
If Not EventLog.SourceExists(sourceName)

    ' Create a new event source for the custom event log
    ' named "myNewLog."  

    myLogName = "myNewLog"
    Dim mySourceData As EventSourceCreationData
 = New EventSourceCreationData(sourceName, myLogName)

    ' Set the message resource file that the event source references.
    ' All event resource identifiers correspond to text in this file.
    If Not System.IO.File.Exists(messageFile)

        Console.WriteLine("Input message resource file does not
 exist - {0}", _
            messageFile)
        messageFile = ""
    Else 
        ' Set the specified file as the resource
        ' file for message text, category text and 
        ' message parameters strings.

        mySourceData.MessageResourceFile = messageFile
        mySourceData.CategoryResourceFile = messageFile
        mySourceData.CategoryCount = CategoryCount
        mySourceData.ParameterResourceFile = messageFile

        Console.WriteLine("Event source message resource file
 set to {0}", _
            messageFile)
    End If

    Console.WriteLine("Registering new source for event log.")
    EventLog.CreateEventSource(mySourceData)
Else
    ' Get the event log corresponding to the existing source.
    myLogName = EventLog.LogNameFromSourceName(sourceName,".")
End If

' Register the localized name of the event log.
' For example, the actual name of the event log is "myNewLog,"
 but
' the event log name displayed in the Event Viewer might be
' "Sample Application Log" or some other application-specific
' text.
Dim myEventLog As EventLog = New
 EventLog(myLogName, ".", sourceName)

If messageFile.Length > 0
    myEventLog.RegisterDisplayName(messageFile, DisplayNameMsgId)
End If

string myLogName;
string sourceName = "SampleApplicationSource";

// Create the event source if it does not exist.
if(!EventLog.SourceExists(sourceName))
{
    // Create a new event source for the custom event log
    // named "myNewLog."  

    myLogName = "myNewLog";
    EventSourceCreationData mySourceData = new EventSourceCreationData(sourceName,
 myLogName);

    // Set the message resource file that the event source references.
    // All event resource identifiers correspond to text in this file.
    if (!System.IO.File.Exists(messageFile))
    {
        Console.WriteLine("Input message resource file does not exist - {0}",
 
            messageFile);
        messageFile = "";
    }
    else 
    {
        // Set the specified file as the resource
        // file for message text, category text, and 
        // message parameter strings.  

        mySourceData.MessageResourceFile = messageFile;
        mySourceData.CategoryResourceFile = messageFile;
        mySourceData.CategoryCount = CategoryCount;
        mySourceData.ParameterResourceFile = messageFile;

        Console.WriteLine("Event source message resource file set
 to {0}", 
            messageFile);
    }

    Console.WriteLine("Registering new source for
 event log.");
    EventLog.CreateEventSource(mySourceData);
}
else
{
    // Get the event log corresponding to the existing source.
    myLogName = EventLog.LogNameFromSourceName(sourceName,".");
}

// Register the localized name of the event log.
// For example, the actual name of the event log is "myNewLog,"
 but
// the event log name displayed in the Event Viewer might be
// "Sample Application Log" or some other application-specific
// text.
EventLog myEventLog = new EventLog(myLogName, ".", sourceName);

if (messageFile.Length > 0)
{
    myEventLog.RegisterDisplayName(messageFile, DisplayNameMsgId);
}

C++

String^ myLogName;
String^ sourceName = "SampleApplicationSource";

// Create the event source if it does not exist.
if (  !EventLog::SourceExists( sourceName ) )
{
   
   // Create a new event source for the custom event log
   // named "myNewLog."  
   myLogName = "myNewLog";
   EventSourceCreationData ^ mySourceData = gcnew EventSourceCreationData( sourceName,myLogName
 );
   
   // Set the message resource file that the event source references.
   // All event resource identifiers correspond to text in this file.
   if (  !System::IO::File::Exists( messageFile ) )
   {
      Console::WriteLine( "Input message resource file does not exist - {0}",
 messageFile );
      messageFile = "";
   }
   else
   {
      
      // Set the specified file as the resource
      // file for message text, category text, and 
      // message parameter strings.  
      mySourceData->MessageResourceFile = messageFile;
      mySourceData->CategoryResourceFile = messageFile;
      mySourceData->CategoryCount = CategoryCount;
      mySourceData->ParameterResourceFile = messageFile;
      Console::WriteLine( "Event source message resource file set
 to {0}", messageFile );
   }

   Console::WriteLine( "Registering new source for
 event log." );
   EventLog::CreateEventSource( mySourceData );
}
else
{
   
   // Get the event log corresponding to the existing source.
   myLogName = EventLog::LogNameFromSourceName( sourceName, "." );
}


// Register the localized name of the event log.
// For example, the actual name of the event log is "myNewLog,"
 but
// the event log name displayed in the Event Viewer might be
// "Sample Application Log" or some other application-specific
// text.
EventLog^ myEventLog = gcnew EventLog( myLogName,".",sourceName );
if ( messageFile->Length > 0 )
{
   myEventLog->RegisterDisplayName( messageFile, DisplayNameMsgId );
}

コード例では、リソースライブラリ EventLogMsgs.dll に組み込まれた、次のメッセージテキストファイルが使用されています。メッセージリソースファイルは、メッセージテキストファイルから生成されます。メッセージテキストファイルでは、リソース識別子の他、カテゴリ、イベントメッセージ、およびパラメータ挿入文字列のテキストが定義されます。

; // EventLogMsgs.mc
; // ********************************************************

; // Use the following commands to build this file:

; //   mc -s EventLogMsgs.mc
; //   rc EventLogMsgs.rc
; //   link /DLL /SUBSYSTEM:WINDOWS /NOENTRY /MACHINE:x86 EventLogMsgs.Res 
; // ********************************************************

; // - Event categories -
; // Categories must be numbered consecutively starting at 1.
; // ********************************************************

MessageId=0x1
Severity=Success
SymbolicName=INSTALL_CATEGORY
Language=English
Installation
.

MessageId=0x2
Severity=Success
SymbolicName=QUERY_CATEGORY
Language=English
Database Query
.

MessageId=0x3
Severity=Success
SymbolicName=REFRESH_CATEGORY
Language=English
Data Refresh
.

; // - Event messages -
; // *********************************

MessageId = 1000
Severity = Success
Facility = Application
SymbolicName = AUDIT_SUCCESS_MESSAGE_ID_1000
Language=English
My application message text, in English, for message id 1000, called from %1.
.

MessageId = 1001
Severity = Warning
Facility = Application
SymbolicName = AUDIT_FAILED_MESSAGE_ID_1001
Language=English
My application message text, in English, for message id 1001, called from %1.
.


MessageId = 1002
Severity = Success
Facility = Application
SymbolicName = GENERIC_INFO_MESSAGE_ID_1002
Language=English
My generic information message in English, for message id 1002.
.


MessageId = 1003
Severity = Warning
Facility = Application
SymbolicName = GENERIC_WARNING_MESSAGE_ID_1003
Language=English
My generic warning message in English, for message id 1003, called from %1.
.


MessageId = 1004
Severity = Success
Facility = Application
SymbolicName = UPDATE_CYCLE_COMPLETE_MESSAGE_ID_1004
Language=English
The update cycle is complete for %%5002.
.


MessageId = 1005
Severity = Warning
Facility = Application
SymbolicName = SERVER_CONNECTION_DOWN_MESSAGE_ID_1005
Language=English
The refresh operation did not complete because the connection to server %1 could
 not be established.
.


; // - Event log display name -
; // ********************************************************


MessageId = 5001
Severity = Success
Facility = Application
SymbolicName = EVENT_LOG_DISPLAY_NAME_MSGID
Language=English
Sample Event Log
.



; // - Event message parameters -
; //   Language independent insertion strings
; // ********************************************************


MessageId = 5002
Severity = Success
Facility = Application
SymbolicName = EVENT_LOG_SERVICE_NAME_MSGID
Language=English
SVC_UPDATE.EXE
.

.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 名前空間
Source
LogName

このページでは「.NET Framework クラスライブラリリファレンス」からEventSourceCreationData コンストラクタを検索した結果を表示しています。
Weblioに収録されているすべての辞書からEventSourceCreationData コンストラクタを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からEventSourceCreationData コンストラクタを検索

>> 「EventSourceCreationData コンストラクタ」を含む用語の索引
EventSourceCreationData コンストラクタのページへのリンク

EventSourceCreationData コンストラクタとは？わかりやすく解説

EventSourceCreationData コンストラクタ

「EventSourceCreationData コンストラクタ」の関連用語


	© 2025 Microsoft.All rights reserved.

EventSourceCreationData コンストラクタとは？ わかりやすく解説

EventSourceCreationData コンストラクタ

急上昇のことば

「EventSourceCreationData コンストラクタ」の関連用語

EventSourceCreationData コンストラクタとは？わかりやすく解説