EventSourceCreationDataとは？わかりやすく解説

辞書 類語・対義語辞典 英和・和英辞典 日中中日辞典 日韓韓日辞典 古語辞典

その他の辞書▼
- フランス語辞典
- インドネシア語辞典
- タイ語辞典
- ベトナム語辞典

Weblio 辞書ヘルプ

556の専門辞書や国語辞典百科事典から一度に検索!

無料の翻訳ならWeblio翻訳！

初めての方へ参加元一覧

Weblio 辞書 > コンピュータ > .NET Framework クラスライブラリリファレンス > EventSourceCreationDataの意味・解説

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

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

EventSourceCreationData クラス

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

ローカルコンピュータまたはリモートコンピュータでイベントログソースを作成するために使用される構成設定を表します。

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

Visual Basic (宣言)

Public Class EventSourceCreationData

Visual Basic (使用法)

Dim instance As EventSourceCreationData

public class EventSourceCreationData

public ref class EventSourceCreationData

public class EventSourceCreationData

public class EventSourceCreationData

ローカライズされたエントリをイベントログに書き込むために新しいソースを構成するには、EventSourceCreationData クラスを使用します。イベントログから読み込む場合、このクラスを使用する必要はありません。

このクラスは、新しいイベントソースおよび関連するイベントログの構成設定を定義します。関連するイベントログは、ローカルコンピュータまたはリモートコンピュータに配置できます。ローカルコンピュータに新規または既存のイベントログの新しいソースを作成するには、EventSourceCreationData の LogName プロパティおよび Source プロパティを設定して、EventLog.CreateEventSource(EventSourceCreationData) メソッドを呼び出します。このメソッドは、Source プロパティで指定したイベントソースを作成して、LogName で指定されたイベントログのイベントソースとして登録します。この動作は、EventLogInstaller クラスを使用してイベントログのイベントソースを登録することに似ています。

イベントをイベントログに書き込むには、WriteEvent メソッドおよび WriteEntry メソッドを使用します。イベントを書き込むには、イベントソースを指定することが必要です。イベントソースは、そのソースを持つ最初のエントリを書き込む前に作成および構成しておく必要があります。

アプリケーションのインストール時に新しいイベントソースを作成します。これにより、オペレーティングシステムが、登録されたイベントソースとその構成の一覧を更新するための時間的余裕が生まれます。イベントソースの一覧がオペレーティングシステムにより更新されていないとき、新しいソースでイベントを書き込もうとすると、書き込み操作が失敗します。新しいソースは、EventLogInstaller または CreateEventSource メソッドを使用して構成できます。新しいイベントソースを作成するには、コンピュータの管理者権限が必要です。

既存のイベントログまたは新しいイベントログのイベントソースを作成できます。新規イベントログに対して新しいソースを作成すると、システムは、そのログのソースを登録しますが、ログは最初のエントリが書き込まれるまで作成されません。

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

既存のソースの構成情報を変更するには、一度ソースを削除してから、新しい構成で作成し直す必要があります。他のアプリケーションまたはコンポーネントが既存のソースを使用している場合、既存のソースを削除するのではなく、更新された構成で新しいソースを作成します。

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

ソースは、ローカライズされたエントリを書き込むか、または直接の文字列を書き込むように構成されている必要があります。WriteEntry メソッドは、指定された文字列をイベントログに直接書き込みます。ローカライズされたメッセージリソースファイルは使用しません。ローカライズされたメッセージリソースファイルを使用してイベントを書き込むには、WriteEvent メソッドを使用します。

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

Windows 98 プラットフォームメモ : イベントログは、Windows 98 または Windows Millennium Edition (Me) ではサポートされていません。

使用例

コマンドライン引数からイベントソースの構成プロパティを設定するコード例を次に示します。入力引数は、イベントソース名、イベントログ名、コンピュータ名、およびイベントメッセージリソースファイルを指定します。このコード例は、ソースが既存のイベントソースと競合していないことを確認してから、指定されたイベントログの新しいイベントソースを作成します。

Imports System
Imports System.Globalization
Imports System.Diagnostics

Namespace EventLogSamples
    Class CreateSourceSample

        Public Shared Sub
 Main(ByVal args() As String)
        
            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

            ' Determine if the source exists on the specified computer.
            If Not EventLog.SourceExists(mySourceData.Source,
 _
                                       mySourceData.MachineName)
                ' The source does not exist.  

                ' Verify that the message file exists
                ' and the event log is local.
                If mySourceData.MessageResourceFile <> Nothing
 AndAlso _
                   mySourceData.MessageResourceFile.Length > 0
                   
                    If mySourceData.MachineName = "."
                        If Not System.IO.File.Exists(mySourceData.MessageResourceFile)

                            Console.WriteLine("File {0} not found
 - message file not set for source.", _
                                mySourceData.MessageResourceFile)
                            registerSource = False
                        End If
                    Else
                        ' For simplicity, do not allow setting the message
                        ' file for a remote event log.  To set the message
                        ' for a remote event log, and for source registration
,
                        ' the file path should be specified with system-wide
                        ' environment variables that are valid on the
 remote
                        ' computer, such as
                        ' "%SystemRoot%\system32\myresource.dll".

                        Console.WriteLine("Message resource file
 ignored for remote event log.")
                        registerSource = False

                    End If
                End If
            Else 
                ' Do not register the source, it already exists.
                registerSource = False

                ' Get the event log corresponding to the existing source.
                Dim sourceLog As string
                sourceLog = EventLog.LogNameFromSourceName(mySourceData.Source, _
                                mySourceData.MachineName)

                ' Determine if the event source is registered for the
 
                ' specified log.

                If sourceLog.ToUpper(CultureInfo.InvariantCulture)
 <> mySourceData.LogName.ToUpper(CultureInfo.InvariantCulture)

                    ' An existing source is registered 
                    ' to write to a different event log.

                    Console.WriteLine("Warning: source {0} is
 already registered to write to event log {1}", _
                        mySourceData.Source, sourceLog)
                Else 
                    ' The source is already registered 
                    ' to write to the specified event log.

                    Console.WriteLine("Source {0} already registered
 to write to event log {1}", _
                        mySourceData.Source, sourceLog)

                End If
            End If

            If registerSource
                ' Register the new event source for the specified event
 log.

                Console.WriteLine("Registering new source {0}
 for event log {1}.", _
                    mySourceData.Source, mySourceData.LogName)
                EventLog.CreateEventSource(mySourceData)
                Console.WriteLine("Event source was registered
 successfully!")
            End If

        End Sub 'Main
    End Class 'CreateSourceSample
End Namespace 'EventLogSamples

using System;
using System.Globalization;
using System.Diagnostics;

namespace EventLogSamples
{
    class CreateSourceSample
    {
        [STAThread]
        static void Main(string[]
 args)
        {
            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";
            }

            // Determine if the source exists on the specified computer.
            if (!EventLog.SourceExists(mySourceData.Source, 
                                       mySourceData.MachineName))
            {
                // The source does not exist.  

                // Verify that the message file exists
                // and the event log is local.

                if ((mySourceData.MessageResourceFile != null)
 &&
                    (mySourceData.MessageResourceFile.Length > 0))
                {
                    if (mySourceData.MachineName == ".")
 
                    {
                        if (!System.IO.File.Exists(mySourceData.MessageResourceFile))
                        {
                            Console.WriteLine("File {0} not found - message
 file not set for source.",
                                mySourceData.MessageResourceFile);
                            registerSource = false;
                        }
                    }
                    else 
                    {
                        // For simplicity, do not allow setting the
 message
                        // file for a remote event log.  To set the
 message
                        // for a remote event log, and for source registration
,
                        // the file path should be specified with system-wide
                        // environment variables that are valid on the
 remote
                        // computer, such as
                        // "%SystemRoot%\system32\myresource.dll".

                        Console.WriteLine("Message resource file ignored for
 remote event log.");
                        registerSource = false;
                    }
                }
            }
            else
            {
                // Do not register the source, it already exists.
                registerSource = false;

                // Get the event log corresponding to the existing source.
                string sourceLog;
                sourceLog = EventLog.LogNameFromSourceName(mySourceData.Source,
                                mySourceData.MachineName);

                // Determine if the event source is registered for the
 
                // specified log.

                if (sourceLog.ToUpper(CultureInfo.InvariantCulture)
 != mySourceData.LogName.ToUpper(CultureInfo.InvariantCulture)) 
                {
                    // An existing source is registered 
                    // to write to a different event log.
                    Console.WriteLine("Warning: source {0} is already registered
 to write to event log {1}",
                        mySourceData.Source, sourceLog);
                }
                else 
                {
                    // The source is already registered 
                    // to write to the specified event log.

                    Console.WriteLine("Source {0} already registered to write
 to event log {1}",
                        mySourceData.Source, sourceLog);
                }
            }
        

            if (registerSource)
            {
                // Register the new event source for the specified event
 log.

                Console.WriteLine("Registering new source
 {0} for event log {1}.",
                    mySourceData.Source, mySourceData.LogName);
                EventLog.CreateEventSource(mySourceData);
                Console.WriteLine("Event source was registered successfully!");
            }
        }
    }
}

#using <System.dll>

using namespace System;
using namespace System::Globalization;
using namespace System::Diagnostics;

[STAThread]
int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   
   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";
   }

   
   // Determine if the source exists on the specified computer.
   if (  !EventLog::SourceExists( mySourceData->Source, mySourceData->MachineName
 ) )
   {
      
      // The source does not exist.  
      // Verify that the message file exists
      // and the event log is local.
      if ( (mySourceData->MessageResourceFile != nullptr) &&
 (mySourceData->MessageResourceFile->Length > 0) )
      {
         if ( mySourceData->MachineName->Equals( "."
 ) )
         {
            if (  !System::IO::File::Exists( mySourceData->MessageResourceFile
 ) )
            {
               Console::WriteLine( "File {0} not found - message file not set
 for source.", mySourceData->MessageResourceFile );
               registerSource = false;
            }
         }
         else
         {
            
            // For simplicity, do not allow setting the message
            // file for a remote event log.  To set the message
            // for a remote event log, and for source registration,
            // the file path should be specified with system-wide
            // environment variables that are valid on the remote
            // computer, such as
            // "%SystemRoot%\system32\myresource.dll".
            Console::WriteLine( "Message resource file ignored for
 remote event log." );
            registerSource = false;
         }
      }
   }
   else
   {
      
      // Do not register the source, it already exists.
      registerSource = false;
      
      // Get the event log corresponding to the existing source.
      String^ sourceLog;
      sourceLog = EventLog::LogNameFromSourceName( mySourceData->Source, mySourceData->MachineName
 );
      
      // Determine if the event source is registered for the 
      // specified log.
      if ( sourceLog->ToUpper( CultureInfo::InvariantCulture
 ) != mySourceData->LogName->ToUpper( CultureInfo::InvariantCulture ) )
      {
         
         // An existing source is registered 
         // to write to a different event log.
         Console::WriteLine( "Warning: source {0} is already registered to write
 to event log {1}", mySourceData->Source, sourceLog );
      }
      else
      {
         
         // The source is already registered 
         // to write to the specified event log.
         Console::WriteLine( "Source {0} already registered to write to event
 log {1}", mySourceData->Source, sourceLog );
      }
   }

   if ( registerSource )
   {
      
      // Register the new event source for the specified event log.
      Console::WriteLine( "Registering new source {0} for
 event log {1}.", mySourceData->Source, mySourceData->LogName );
      EventLog::CreateEventSource( mySourceData );
      Console::WriteLine( "Event source was registered successfully!" );
   }
}

.NET Framework のセキュリティ

.NET Framework のセキュリティ

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

継承階層

System.Object
System.Diagnostics.EventSourceCreationData

スレッドセーフ

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

プラットフォーム

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 メンバ
System.Diagnostics 名前空間
EventLog クラス
EventLogInstaller クラス

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
)

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

public EventSourceCreationData (
    String source, 
    String logName
)

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 のリソースファイルパスを使用し、イベントログに対してローカライズされた表示名を設定します。

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

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 のセキュリティ

.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

EventSourceCreationData プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	CategoryCount	カテゴリリソースファイル内のカテゴリの数を取得または設定します。
	CategoryResourceFile	ソースのカテゴリ文字列が格納されたリソースファイルのパスを取得または設定します。
	LogName	ソースがエントリを書き込むイベントログの名前を取得または設定します。
	MachineName	イベントソースを登録するコンピュータの名前を取得または設定します。
	MessageResourceFile	ソースのメッセージ書式指定文字列が格納されたメッセージリソースファイルのパスを取得または設定します。
	ParameterResourceFile	ソースのメッセージパラメータ文字列が格納されたリソースファイルのパスを取得または設定します。
	Source	イベントソースとしてイベントログに登録する名前を取得または設定します。

関連項目

EventSourceCreationData クラス
System.Diagnostics 名前空間
EventLog クラス
EventLogInstaller クラス

EventSourceCreationData メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

関連項目

EventSourceCreationData クラス
System.Diagnostics 名前空間
EventLog クラス
EventLogInstaller クラス

EventSourceCreationData メンバ

ローカルコンピュータまたはリモートコンピュータでイベントログソースを作成するために使用される構成設定を表します。

EventSourceCreationData データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

パブリックコンストラクタ

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

パブリックプロパティ

パブリックプロパティ

	名前	説明
	CategoryCount	カテゴリリソースファイル内のカテゴリの数を取得または設定します。
	CategoryResourceFile	ソースのカテゴリ文字列が格納されたリソースファイルのパスを取得または設定します。
	LogName	ソースがエントリを書き込むイベントログの名前を取得または設定します。
	MachineName	イベントソースを登録するコンピュータの名前を取得または設定します。
	MessageResourceFile	ソースのメッセージ書式指定文字列が格納されたメッセージリソースファイルのパスを取得または設定します。
	ParameterResourceFile	ソースのメッセージパラメータ文字列が格納されたリソースファイルのパスを取得または設定します。
	Source	イベントソースとしてイベントログに登録する名前を取得または設定します。

パブリックメソッド

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

関連項目

EventSourceCreationData クラス
System.Diagnostics 名前空間
EventLog クラス
EventLogInstaller クラス

>> 「EventSourceCreationData」を含む用語の索引
EventSourceCreationDataのページへのリンク

辞書ショートカット

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

カテゴリ一覧

＋ビジネス

＋業界用語

＋コンピュータ

＋自動車・バイク

＋船

＋建築・不動産

＋ヘルスケア

＋スポーツ

＋辞書・百科事典

すべての辞書の索引

Weblioのサービス

「EventSourceCreationData」の関連用語

1

EventSourceCreationData.MachineName プロパティ

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

56% |||||

2

EventSourceCreationData.Source プロパティ

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

50% |||||

3

EventSourceCreationData.LogName プロパティ

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

38% |||||

4

EventSourceCreationData コンストラクタ

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

38% |||||

5

EventSourceCreationData メンバ

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

36% |||||

6

EventSourceCreationData.CategoryResourceFile プロパティ

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

34% |||||

7

EventLog.CreateEventSource メソッド

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

34% |||||

8

EventSourceCreationData.CategoryCount プロパティ

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

34% |||||

9

EventSourceCreationData.MessageResourceFile プロパティ

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

34% |||||

10

EventSourceCreationData クラス

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

32% |||||

EventSourceCreationDataのお隣キーワード

EventQuery コンストラクタ

EventQuery プロパティ

EventQuery メソッド

EventQuery メンバ

EventQuery.Clone メソッド

EventResetMode 列挙体

EventSourceCreationData

EventSourceCreationData クラス

EventSourceCreationData コンストラクタ

EventSourceCreationData プロパティ

EventSourceCreationData メソッド

EventSourceCreationData メンバ

EventSourceCreationData.CategoryCount プロパティ

検索ランキング

EventSourceCreationDataのページの著作権
Weblio 辞書情報提供元は参加元一覧にて確認できます。


	© 2025 Microsoft.All rights reserved.

ビジネス｜業界用語｜コンピュータ｜電車｜自動車・バイク｜船｜工学｜建築・不動産｜学問
 文化｜生活｜ヘルスケア｜趣味｜スポーツ｜生物｜食品｜人名｜方言｜辞書・百科事典

ご利用にあたって

・Weblio辞書とは

・検索の仕方

・利用規約

・プライバシーポリシー

・サイトマップ

便利な機能

・ウェブリオのアプリ

・画像から探す

お問合せ・ご要望

・お問い合わせ

会社概要

・公式企業ページ

・会社情報

・採用情報

ウェブリオのサービス

・Weblio 辞書

・類語・対義語辞典

・英和辞典・和英辞典

・Weblio翻訳

・日中中日辞典

・日韓韓日辞典

・フランス語辞典

・インドネシア語辞典

・タイ語辞典

・ベトナム語辞典

・古語辞典

・おすすめのプログラミングスクール情報「Livifun」

©2025 GRAS Group, Inc.RSS