EventLog コンストラクタ ()

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

EventLog コンストラクタ ()

EventLog クラスの新しいインスタンスを初期化します。このインスタンスは、ログとは関連付けられません。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New EventLog

C#

public EventLog ()

C++

public:
EventLog ()

J#

public EventLog ()

JScript

public function EventLog ()

解説

WriteEntry を呼び出す前に、EventLog インスタンスの Source プロパティを指定します。ログから Entries だけを読み取る場合は、Log プロパティと MachineName プロパティだけを指定する方法もあります。

メモ
MachineName を指定しなかった場合は、ローカル コンピュータ (".") が想定されます。

EventLog のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	初期値
Source	空の文字列 ("")。
Log	空の文字列 ("")。
MachineName	ローカル コンピュータ (".")。

使用例

ソースが存在しない場合は MySource を作成し、イベント ログ MyNewLog にエントリを書き込む例を次に示します。

Visual Basic

Option Explicit
Option Strict

Imports System
Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        ' Create the source, if it does not already exist.
        If Not EventLog.SourceExists("MySource")
 Then
            EventLog.CreateEventSource("MySource",
 "MyNewLog")
            Console.WriteLine("CreatingEventSource")
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New
 EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
    End Sub 'Main 
End Class 'MySample

C#

using System;
using System.Diagnostics;
using System.Threading;
              
class MySample{

    public static void Main(){
    
        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource")){
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatingEventSource");
        }
                
        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "MySource";
        
        // Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.");
        
    }
}
   

C++

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create the source, if it does not already exist.
   if (  !EventLog::SourceExists( "MySource" ) )
   {
      EventLog::CreateEventSource( "MySource", "MyNewLog" );
      Console::WriteLine( "CreatingEventSource" );
   }

   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog;
   myLog->Source = "MySource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing to event log." );
}

J#

import System.*;
import System.Diagnostics.*;
import System.Threading.*;

class MySample
{
    public static void main(String[]
 args)
    {
        // Create the source, if it does not already exist.
        if (!(EventLog.SourceExists("MySource"))) {
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatingEventSource");
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.set_Source("MySource");

        // Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.");
    } //main 
} //MySample

.NET Framework のセキュリティ

• EventLogPermission  (コンピュータのイベント ログ情報の書き込み) EventLogPermissionAccess.Write (関連する列挙体)

プラットフォーム

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、1.1、1.0

参照

関連項目
EventLog クラス
EventLog メンバ
System.Diagnostics 名前空間
Source
Log
MachineName
Entries
WriteEntry
WriteEvent
EventLogEntry

EventLog コンストラクタ (String, String)

EventLog クラスの新しいインスタンスを初期化します。指定したコンピュータ上のログにインスタンスを関連付けます。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim logName As String
Dim machineName As String

Dim instance As New EventLog(logName,
 machineName)

C#

public EventLog (
    string logName,
    string machineName
)

C++

public:
EventLog (
    String^ logName, 
    String^ machineName
)

J#

public EventLog (
    String logName, 
    String machineName
)

JScript

public function EventLog (
    logName : String, 
    machineName : String
)

パラメータ

logName

指定したコンピュータ上のログの名前。

machineName

ログが存在するコンピュータ。

例外

例外の種類	条件
ArgumentNullException	ログ名が null 参照 (Visual Basic では Nothing) です。
ArgumentException	ログ名が無効です。 または コンピュータ名が無効です。

解説

このオーバーロードは、Log プロパティにlogName パラメータを設定し、MachineName プロパティに machineName パラメータを設定します。WriteEntry を呼び出す前に、EventLog の Source プロパティを指定します。ログから Entries だけを読み取る場合は、Log プロパティと MachineName プロパティだけを指定する方法もあります。

メモ
このコンストラクタのオーバーロードで Log プロパティおよび MachineName プロパティが指定されますが、どちらも Entries プロパティを読み取る前に変更できます。

EventLog のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	初期値
Source	空の文字列 ("")。
Log	logName パラメータ。
MachineName	machineName パラメータ。

使用例

コンピュータ "myServer" 上のイベント ログ "myNewLog" のエントリを読み取る例を次に示します。

Visual Basic

Option Explicit
Option Strict

Imports System
Imports System.Diagnostics
Imports System.Threading
Imports Microsoft.VisualBasic

Class MySample
    Public Shared Sub Main()
        
        ' Create an EventLog instance and assign its log name.
        Dim myLog As New
 EventLog("myNewLog", "myServer")
        
        ' Read the event log entries.
        Dim entry As EventLogEntry
        For Each entry In
  myLog.Entries
            Console.WriteLine((ControlChars.Tab & "Entry:
 " & entry.Message))
        Next entry
    End Sub ' Main
End Class ' MySample

C#

using System;
using System.Diagnostics;
using System.Threading;
              
class MySample{

    public static void Main(){
         
        // Create an EventLog instance and assign its log name.
        EventLog myLog = new EventLog("myNewLog", "myServer");

        // Read the event log entries.
        foreach(EventLogEntry entry in myLog.Entries){
            Console.WriteLine("\tEntry: " + entry.Message);
        }                                                                     
    } 
}
   

C++

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create an EventLog instance and assign its log name.
   EventLog^ myLog = gcnew EventLog( "myNewLog","myServer" );
   
   // Read the event log entries.
   System::Collections::IEnumerator^ myEnum = myLog->Entries->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      EventLogEntry^ entry = safe_cast<EventLogEntry^>(myEnum->Current);
      Console::WriteLine( "\tEntry: {0}", entry->Message );
   }
}

J#

import System.*;
import System.Diagnostics.*;
import System.Threading.*;

class MySample
{
    public static void main(String[]
 args)
    {
        // Create an EventLog instance and assign its log name.
        EventLog myLog = new EventLog("myNewLog", "myServer");
        // Read the event log entries.
        for (int iCtr = 0; iCtr < myLog.get_Entries().get_Count();
 iCtr++) {
            EventLogEntry entry = myLog.get_Entries().get_Item(iCtr);
            Console.WriteLine("\tEntry: " + entry.get_Message());
        }
    } //main
} //MySample

.NET Framework のセキュリティ

• EventLogPermission  (コンピュータのイベント ログ情報の書き込み) EventLogPermissionAccess.Write (関連する列挙体)

プラットフォーム

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、1.1、1.0

参照

関連項目
EventLog クラス
EventLog メンバ
System.Diagnostics 名前空間
Source
Log
MachineName
Entries
WriteEntry
WriteEvent
EventLogEntry

EventLog コンストラクタ (String)

EventLog クラスの新しいインスタンスを初期化します。ローカル コンピュータ上のログにインスタンスを関連付けます。

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

Visual Basic (宣言)

Public Sub New ( _
    logName As String _
)

Visual Basic (使用法)

Dim logName As String

Dim instance As New EventLog(logName)

C#

public EventLog (
    string logName
)

C++

public:
EventLog (
    String^ logName
)

J#

public EventLog (
    String logName
)

JScript

public function EventLog (
    logName : String
)

パラメータ

logName

ローカル コンピュータ上のログの名前。

例外

例外の種類	条件
ArgumentNullException	ログ名が null 参照 (Visual Basic では Nothing) です。
ArgumentException	ログ名が無効です。

解説

このオーバーロードは、Log プロパティに logName パラメータを設定します。WriteEntry を呼び出す前に、EventLog インスタンスの Source プロパティを指定します。ログから Entries だけを読み取る場合は、Log プロパティと MachineName プロパティだけを指定する方法もあります。

メモ
MachineName を指定しなかった場合は、ローカル コンピュータ (".") が想定されます。このコンストラクタのオーバーロードで Log プロパティが指定されますが、このプロパティは Entries プロパティを読み取る前に変更できます。

Source プロパティに指定したソースがコンピュータ上の他のソースとは異なる一意のソースである場合、後続の WriteEntry 呼び出しで、指定した名前のログが作成されます (ログがまだ存在しない場合)。

EventLog のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	初期値
Source	空の文字列 ("")。
Log	logName パラメータ。
MachineName	ローカル コンピュータ (".")。

使用例

ローカル コンピュータ上のイベント ログ "myNewLog" のエントリを読み取る例を次に示します。

Visual Basic

Option Explicit
Option Strict

Imports System
Imports System.Diagnostics
Imports System.Threading
Imports Microsoft.VisualBasic

Class MySample
    Public Shared Sub Main()
        
        ' Create an EventLog instance and assign its log name.
        Dim myLog As New
 EventLog("myNewLog")
        
        ' Read the event log entries.
        Dim entry As EventLogEntry
        For Each entry In
  myLog.Entries
            Console.WriteLine((ControlChars.Tab & "Entry:
 " & entry.Message))
        Next entry
    End Sub ' Main
End Class ' MySample

C#

using System;
using System.Diagnostics;
using System.Threading;
              
class MySample{


    public static void Main(){
           
                        
        // Create an EventLog instance and assign its log name.
        EventLog myLog = new EventLog("myNewLog");

        // Read the event log entries.
        foreach(EventLogEntry entry in myLog.Entries){
            Console.WriteLine("\tEntry: " + entry.Message);
        }                                                                     
    }
}
   

C++

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create an EventLog instance and assign its log name.
   EventLog^ myLog = gcnew EventLog( "myNewLog" );
   
   // Read the event log entries.
   System::Collections::IEnumerator^ myEnum = myLog->Entries->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      EventLogEntry^ entry = safe_cast<EventLogEntry^>(myEnum->Current);
      Console::WriteLine( "\tEntry: {0}", entry->Message );
   }
}

J#

import System.*;
import System.Diagnostics.*;
import System.Threading.*;

class MySample
{
    public static void main(String[]
 args)
    {
        // Create an EventLog instance and assign its log name.
        EventLog myLog = new EventLog("myNewLog");

        // Read the event log entries.
        for (int iCtr = 0; iCtr < myLog.get_Entries().get_Count();
 iCtr++) {
            EventLogEntry entry = myLog.get_Entries().get_Item(iCtr);
            Console.WriteLine("\tEntry: " + entry.get_Message());
        }
    } //main
} //MySample

.NET Framework のセキュリティ

• EventLogPermission  (コンピュータのイベント ログ情報の書き込み) EventLogPermissionAccess.Write (関連する列挙体)

プラットフォーム

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、1.1、1.0

参照

関連項目
EventLog クラス
EventLog メンバ
System.Diagnostics 名前空間
Source
Log
MachineName
Entries
WriteEntry
WriteEvent
EventLogEntry

EventLog コンストラクタ

EventLog クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
EventLog ()	EventLog クラスの新しいインスタンスを初期化します。このインスタンスは、ログとは関連付けられません。
EventLog (String)	EventLog クラスの新しいインスタンスを初期化します。ローカル コンピュータ上のログにインスタンスを関連付けます。
EventLog (String, String)	EventLog クラスの新しいインスタンスを初期化します。指定したコンピュータ上のログにインスタンスを関連付けます。
EventLog (String, String, String)	EventLog クラスの新しいインスタンスを初期化します。指定したコンピュータ上のログにインスタンスを関連付け、指定したソースを作成するか、または EventLog に割り当てます。

参照

関連項目

EventLog クラス
EventLog メンバ
System.Diagnostics 名前空間
Source
Log
MachineName
Entries
WriteEntry
WriteEvent
EventLogEntry

EventLog コンストラクタ (String, String, String)

EventLog クラスの新しいインスタンスを初期化します。指定したコンピュータ上のログにインスタンスを関連付け、指定したソースを作成するか、または EventLog に割り当てます。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim logName As String
Dim machineName As String
Dim source As String

Dim instance As New EventLog(logName,
 machineName, source)

C#

public EventLog (
    string logName,
    string machineName,
    string source
)

C++

public:
EventLog (
    String^ logName, 
    String^ machineName, 
    String^ source
)

J#

public EventLog (
    String logName, 
    String machineName, 
    String source
)

JScript

public function EventLog (
    logName : String, 
    machineName : String, 
    source : String
)

パラメータ

logName

指定したコンピュータ上のログの名前。

machineName

ログが存在するコンピュータ。

source

イベント ログ エントリのソース。

例外

例外の種類	条件
ArgumentNullException	ログ名が null 参照 (Visual Basic では Nothing) です。
ArgumentException	ログ名が無効です。 または コンピュータ名が無効です。

解説

このコンストラクタは、Log プロパティに logName パラメータを設定し、MachineName プロパティに machineName パラメータを設定し、Source プロパティに source を設定します。Source プロパティは、イベント ログに書き込むときに必要です。しかし、イベント ログを読み取るだけの場合は、Log プロパティと MachineName プロパティだけが必要です (サーバー上のイベント ログに、そのログに関連付けられているソースが既に存在する場合)。イベント ログを読み取るだけの場合は、コンストラクタのもう 1 つのオーバーロードを使用するだけで十分です。

EventLog のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	初期値
Source	source パラメータ。
Log	logName パラメータ。
MachineName	machineName パラメータ。

使用例

ソース "MySource" を使用して、ローカル コンピュータ上のイベント ログ "MyNewLog" にエントリを書き込む例を次に示します。

Visual Basic

Option Strict
Option Explicit

Imports System
Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New
 EventLog("myNewLog", ".",
 "MySource")
        
        ' Write an entry to the log.        
        myLog.WriteEntry(("Writing to event log on "
 & myLog.MachineName))
    End Sub ' Main 
End Class ' MySample

C#

using System;
using System.Diagnostics;
using System.Threading;
              
class MySample{

    public static void Main(){
         
        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog("myNewLog", ".",
 "MySource");

        // Write an entry to the log.        
        myLog.WriteEntry("Writing to event log on " + myLog.MachineName);

    }
}
   

C++

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog( "myNewLog",".","MySource"
 );
   
   // Write an entry to the log.        
   myLog->WriteEntry( String::Format( "Writing to event log on {0}",
 myLog->MachineName ) );
}

J#

import System.*;
import System.Diagnostics.*;
import System.Threading.*;

class MySample
{
    public static void main(String[]
 args)
    {
        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog("myNewLog", ".",
 "MySource");
        // Write an entry to the log.        
        myLog.WriteEntry("Writing to event log on " 
            + myLog.get_MachineName());
    } //main 
} //MySample

.NET Framework のセキュリティ

• EventLogPermission  (コンピュータのイベント ログ情報の書き込み) EventLogPermissionAccess.Write (関連する列挙体)

プラットフォーム

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、1.1、1.0

参照

関連項目
EventLog クラス
EventLog メンバ
System.Diagnostics 名前空間
Source
Log
MachineName
Entries
WriteEntry
WriteEvent
EventLogEntry