ThreadLocal<T> Класс

Ссылка

Определение

Пространство имен:: System.Threading

Сборка:: System.Threading.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет хранилище для данных, локальных для потока.

generic <typename T>
public ref class ThreadLocal : IDisposable

public class ThreadLocal<T> : IDisposable

type ThreadLocal<'T> = class
    interface IDisposable

Public Class ThreadLocal(Of T)
Implements IDisposable

Параметры типа

T

Указывает тип данных, хранящихся на поток.

Наследование: Object
ThreadLocal<T>

Реализации: IDisposable

Примеры

В следующем примере показано использование ThreadLocal<T>.

using System;
using System.Threading;
using System.Threading.Tasks;

class ThreadLocalDemo
{
    
        // Demonstrates:
        //      ThreadLocal(T) constructor
        //      ThreadLocal(T).Value
        //      One usage of ThreadLocal(T)
        static void Main()
        {
            // Thread-Local variable that yields a name for a thread
            ThreadLocal<string> ThreadName = new ThreadLocal<string>(() =>
            {
                return "Thread" + Thread.CurrentThread.ManagedThreadId;
            });

            // Action that prints out ThreadName for the current thread
            Action action = () =>
            {
                // If ThreadName.IsValueCreated is true, it means that we are not the
                // first action to run on this thread.
                bool repeat = ThreadName.IsValueCreated;

                Console.WriteLine("ThreadName = {0} {1}", ThreadName.Value, repeat ? "(repeat)" : "");
            };

            // Launch eight of them.  On 4 cores or less, you should see some repeat ThreadNames
            Parallel.Invoke(action, action, action, action, action, action, action, action);

            // Dispose when you are done
            ThreadName.Dispose();
        }
}
// This multithreading example can produce different outputs for each 'action' invocation and will vary with each run.
// Therefore, the example output will resemble but may not exactly match the following output (from a 4 core processor):
// ThreadName = Thread5 
// ThreadName = Thread6 
// ThreadName = Thread4 
// ThreadName = Thread6 (repeat)
// ThreadName = Thread1 
// ThreadName = Thread4 (repeat)
// ThreadName = Thread7 
// ThreadName = Thread5 (repeat)

Imports System.Threading
Imports System.Threading.Tasks

Module ThreadLocalDemo

    ' Demonstrates:
    ' ThreadLocal(T) constructor
    ' ThreadLocal(T).Value
    ' One usage of ThreadLocal(T)
    Sub Main()
        ' Thread-Local variable that yields a name for a thread
        Dim ThreadName As New ThreadLocal(Of String)(
            Function()
                Return "Thread" & Thread.CurrentThread.ManagedThreadId
            End Function)

        ' Action that prints out ThreadName for the current thread
        Dim action As Action =
            Sub()
                ' If ThreadName.IsValueCreated is true, it means that we are not the
                ' first action to run on this thread.
                Dim repeat As Boolean = ThreadName.IsValueCreated

                Console.WriteLine("ThreadName = {0} {1}", ThreadName.Value, If(repeat, "(repeat)", ""))
            End Sub

        ' Launch eight of them. On 4 cores or less, you should see some repeat ThreadNames
        Parallel.Invoke(action, action, action, action, action, action, action, action)

        ' Dispose when you are done
        ThreadName.Dispose()
    End Sub
End Module
' This multithreading example can produce different outputs for each 'action' invocation and will vary with each run.
' Therefore, the example output will resemble but may not exactly match the following output (from a 4 core processor):
' ThreadName = Thread5 
' ThreadName = Thread6 
' ThreadName = Thread4 
' ThreadName = Thread6 (repeat)
' ThreadName = Thread1 
' ThreadName = Thread4 (repeat)
' ThreadName = Thread7 
' ThreadName = Thread5 (repeat)

Конструкторы

ThreadLocal<T>()	Инициализирует экземпляр ThreadLocal<T>.
ThreadLocal<T>(Boolean)	Инициализирует экземпляр ThreadLocal<T> и указывает, доступны ли все значения из любого потока.
ThreadLocal<T>(Func<T>)	Инициализирует экземпляр ThreadLocal<T> с заданной функцией `valueFactory`.
ThreadLocal<T>(Func<T>, Boolean)	Инициализирует экземпляр ThreadLocal<T>с заданными функцией `valueFactory` и флагом, указывающим, доступны ли все значения из любого потока.

Свойства

IsValueCreated	Получает значение, указывающее, инициализирован ли объект Value в текущем потоке.
Value	Получает или задает значение данного экземпляра для текущего потока.
Values	Возвращает список, содержащий значения, хранящиеся всеми потоками, имеющими доступ к этому экземпляру.

Методы

Dispose()	Освобождает все ресурсы, используемые текущим экземпляром класса ThreadLocal<T>.
Dispose(Boolean)	Освобождает ресурсы, используемые этим экземпляром ThreadLocal<T>.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Finalize()	Освобождает ресурсы, используемые этим экземпляром ThreadLocal<T>.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Создает и возвращает строковое представление данного экземпляра для текущего потока.

Применяется к

Потокобезопасность

За исключением Dispose()того, что все открытые и защищенные элементы ThreadLocal<T> являются потокобезопасными и могут использоваться одновременно из нескольких потоков. Значение, возвращаемое для Value свойства, IsValueCreated зависит от потока, к которому осуществляется доступ к свойству.

Поделиться через