EventLog コンストラクタ (String)

2007-08-14

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

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

構文

'宣言
Public Sub New ( _
    logName As String _
)
'使用
Dim logName As String

Dim instance As New EventLog(logName)

public EventLog (
    string logName
)

public:
EventLog (
    String^ logName
)

public EventLog (
    String logName
)

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" のエントリを読み取る例を次に示します。

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

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

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

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