EventLog.LogNameFromSourceName メソッドとは何？わかりやすく解説 Weblio辞書

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

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

EventLog.LogNameFromSourceName メソッド

指定したソースが登録されているログの名前を取得します。

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

Visual Basic (宣言)

Public Shared Function LogNameFromSourceName
 ( _
    source As String, _
    machineName As String _
) As String

Visual Basic (使用法)

Dim source As String
Dim machineName As String
Dim returnValue As String

returnValue = EventLog.LogNameFromSourceName(source, machineName)

public static string LogNameFromSourceName
 (
    string source,
    string machineName
)

C++

public:
static String^ LogNameFromSourceName (
    String^ source, 
    String^ machineName
)

public static String LogNameFromSourceName
 (
    String source, 
    String machineName
)

JScript

public static function LogNameFromSourceName
 (
    source : String, 
    machineName : String
) : String

パラメータ

source: イベントソースの名前。

machineName: 検索対象のコンピュータの名前。ローカルコンピュータの場合は "."。

戻り値
レジストリ内で指定したソースに関連付けられているログの名前。

解説

イベントソースは、何によってイベントがログに記録されるかを示します。通常はアプリケーションの名前か、アプリケーションのサブコンポーネントの名前 (アプリケーションが大きい場合) を指定します。アプリケーションおよびサービスは、アプリケーションログまたはカスタムログに書き込みます。デバイスドライバは、システムログに書き込みます。

同時に 1 つのログだけに書き込むことができる新しいソースを作成すると、有効なエントリソースとしてアプリケーションがイベントログに登録されます。Source プロパティには任意の文字列を設定できますが、指定した名前はコンピュータ上の他のソースでは使用できません。重複する Source 値を作成しようとすると、例外がスローされます。ただし、1 つのイベントログに複数の異なるソースが書き込みを行うことは可能です。

使用例

ソースをローカルコンピュータから削除する例を次に示します。この例は、ソースからログの内容を判断してから、そのログを削除します。

メモ
イベントログには複数のソースが書き込むことがあります。カスタムログを削除する前に、そのログに書き込んでいるソースが他に存在しないことを確認してください。

Visual Basic

Option Explicit
Option Strict

Imports System
Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        Dim logName As String
        
        If EventLog.SourceExists("MyOldSource")
 Then
            ' Find the log associated with this source.    
            logName = EventLog.LogNameFromSourceName("MyOldSource",
 ".")
            
            ' Delete the source and the log.
            EventLog.DeleteEventSource("MyOldSource")
            EventLog.Delete(logName)
            
            Console.WriteLine((logName & " deleted."))
        End If
    End Sub 'Main
End Class 'MySample

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

    public static void Main(){

         string logName;
       
        if(EventLog.SourceExists("MyOldSource")){
        // Find the log associated with this source.    
            logName = EventLog.LogNameFromSourceName("MyOldSource", ".");

        // Delete the source and the log.
            EventLog.DeleteEventSource("MyOldSource");
            EventLog.Delete(logName);
            
            Console.WriteLine(logName + " deleted.");    
        }                                                                       
 
    } 
}

C++

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   String^ logName;
   if ( EventLog::SourceExists( "MyOldSource" ) )
   {
      
      // Find the log associated with this source.    
      logName = EventLog::LogNameFromSourceName( "MyOldSource", "."
 );
      
      // Delete the source and the log.
      EventLog::DeleteEventSource( "MyOldSource" );
      EventLog::Delete( logName );
      Console::WriteLine( "{0} deleted.", logName );
   }
}

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

class MySample
{
    public static void main(String[]
 args)
    {
        String logName;
        if (EventLog.SourceExists("MyOldSource")) {
            // Find the log associated with this source.    
            logName = EventLog.LogNameFromSourceName("MyOldSource", ".");

            // Delete the source and the log.
            EventLog.DeleteEventSource("MyOldSource");
            EventLog.Delete(logName);
            Console.WriteLine(logName + " deleted.");
        }
    } //main
} //MySample