Thread.Name Vlastnost

Definice

Získá nebo nastaví název vlákna.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

Hodnota vlastnosti

Řetězec obsahující název vlákna nebo null, pokud nebyl nastaven žádný název.A string containing the name of the thread, or null if no name was set.

Výjimky

Byla požadována operace set, ale vlastnost Name již byla nastavena.A set operation was requested, but the Name property has already been set.

Příklady

Následující příklad ukazuje, jak pojmenovat vlákno.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

Poznámky

Tato vlastnost je jen pro zápis.This property is write-once. Vzhledem k tomu, že výchozí hodnota vlastnosti Name vlákna je null, můžete určit, zda byl název již explicitně přiřazen k vláknu porovnáním s 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.

Řetězec přiřazený k vlastnosti Name může obsahovat libovolný znak Unicode.The string assigned to the Name property can include any Unicode character.

Platí pro