This documentation is archived and is not being maintained.

Thread.Name Property

Gets or sets the name of the thread.

Namespace: System.Threading
Assembly: mscorlib (in mscorlib.dll)

public string Name { get; set; }
/** @property */
public String get_Name ()

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

public function get Name () : String

public function set Name (value : String)

Not applicable.

Property Value

A string containing the name of the thread, or a null reference (Nothing in Visual Basic) if no name was set.

Exception typeCondition

InvalidOperationException

A set operation was requested, and the Name property has already been set.

This property is write-once.

The following code example shows how to name a 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.");
        }
    }
}

import System.*;
import System.Threading.*;
import System.Threading.Thread;

class Name
{
    public static void main(String[] args)
    {
        // Check whether the thread has previously been named
        // to avoid a possible InvalidOperationException.
        if (Thread.get_CurrentThread().get_Name() == null) {
            Thread.get_CurrentThread().set_Name("MainThread");
        }
        else {
            Console.WriteLine(("Unable to name a previously " 
                + "named thread."));
        } 
    } //main
} //Name

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0

XNA Framework

Supported in: 1.0
Show: