Thread.Name Propiedad

Definición

Obtiene o establece el nombre del subproceso.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

Valor de propiedad

Cadena que contiene el nombre del subproceso o null si no se ha establecido ningún nombre.A string containing the name of the thread, or null if no name was set.

Excepciones

Se solicitó una operación Set, pero ya se ha establecido la propiedad Name.A set operation was requested, but the Name property has already been set.

Ejemplos

En el ejemplo siguiente se muestra cómo asignar un nombre a un subproceso.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

Comentarios

Esta propiedad es de solo escritura.This property is write-once. Dado que el valor predeterminado de la propiedad Name de un subproceso es null, puede determinar si ya se ha asignado explícitamente un nombre al subproceso comparándola con 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.

La cadena asignada a la propiedad Name puede incluir cualquier carácter Unicode.The string assigned to the Name property can include any Unicode character.

Se aplica a