EventLog.LogNameFromSourceName メソッド

2007-08-14

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

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

構文

'宣言
Public Shared Function LogNameFromSourceName ( _
    source As String, _
    machineName As String _
) As String
'使用
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
)

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

public static String LogNameFromSourceName (
    String source, 
    String machineName
)

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

パラメータ

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

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

戻り値

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

解説

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

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

使用例

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

注意

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

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

#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

.NET Framework のセキュリティ

EventLogPermission (コンピュータのイベントログ情報の管理) EventLogPermissionAccess.Administer (関連する列挙体)

プラットフォーム

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