Thread.Name プロパティ

定義

スレッドの名前を取得または設定します。Gets or sets the name of the thread.

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };
public string Name { get; set; }
member this.Name : string with get, set
Public Property Name As String

プロパティ値

スレッドの名前を含む文字列。名前が設定されていない場合は nullA string containing the name of the thread, or null if no name was set.

例外

設定操作が要求されましたが、Name プロパティは既に設定されています。A set operation was requested, but the Name property has already been set.

次の例は、スレッドに名前を指定する方法を示しています。The following example shows how to name a thread.

using namespace System;
using namespace System::Threading;
int main()
{
   
   // Check whether the thread has previously been named to
   // avoid a possible InvalidOperationException.
   if ( Thread::CurrentThread->Name == nullptr )
   {
      Thread::CurrentThread->Name =  "MainThread";
   }
   else
   {
      Console::WriteLine( "Unable to name a previously "
      "named thread." );
   }
}

using System;
using System.Threading;

class Name
{
    static void Main()
    {
        // Check whether the thread has previously been named
        // to avoid a possible InvalidOperationException.
        if(Thread.CurrentThread.Name == null)
        {
            Thread.CurrentThread.Name = "MainThread";
        }
        else
        {
            Console.WriteLine("Unable to name a previously " +
                "named thread.");
        }
    }
}
Imports System.Threading

Public Class Name

    <MTAThread> _
    Shared Sub Main()

        ' Check whether the thread has previously been named
        ' to avoid a possible InvalidOperationException.
        If Thread.CurrentThread.Name = Nothing Then
            Thread.CurrentThread.Name = "MainThread"
        Else
            Console.WriteLine("Unable to name a previously " & _
                "named thread.")
        End If

    End Sub
End Class

注釈

このプロパティは1回だけ書き込まれます。This property is write-once. スレッドの Name プロパティの既定値は nullので、nullと比較することによって、既に名前がスレッドに割り当てられているかどうかを確認できます。Because the default value of a thread's Name property is null, you can determine whether a name has already been explicitly assigned to the thread by comparing it with null.

Name プロパティに割り当てられた文字列には、任意の Unicode 文字を含めることができます。The string assigned to the Name property can include any Unicode character.

適用対象