EventSourceCreationData.MachineName プロパティとは何？わかりやすく解説 Weblio辞書

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

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

EventSourceCreationData.MachineName プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

イベントソースを登録するコンピュータの名前を取得または設定します。

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

Visual Basic (宣言)

Public Property MachineName As
 String

Visual Basic (使用法)

Dim instance As EventSourceCreationData
Dim value As String

value = instance.MachineName

instance.MachineName = value

public string MachineName { get;
 set; }

C++

public:
property String^ MachineName {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_MachineName ()

/** @property */
public void set_MachineName (String value)

JScript

public function get MachineName
 () : String

public function set MachineName
 (value : String)

プロパティ値
イベントソースを登録するシステムの名前。既定値はローカルコンピュータ (".") です。

例外

例外の種類	条件
ArgumentException	コンピュータ名が無効です。

解説

MachineName 値を空の文字列にすることはできません。コンピュータ名を明示的に設定しなかった場合は、既定によりローカルコンピュータ (".") が設定されます。

ソースをリモートコンピュータに登録する場合、十分なアクセス許可を使用してレジストリ値を書き込むには、そのコンピュータの管理者権限が必要です。

使用例

コマンドライン引数からイベントソースの構成プロパティを設定するコード例を次に示します。入力引数は、イベントソース名、イベントログ名、コンピュータ名、およびイベントメッセージリソースファイルを指定します。このコード例は、EventSourceCreationData クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

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

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

C++

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