Thread.GetData(LocalDataStoreSlot) Yöntem

Tanım

Geçerli iş parçacığının geçerli etki alanı içindeki geçerli iş parçacığında belirtilen yuvadan değeri alır. Daha iyi performans için bunun yerine özniteliğiyle ThreadStaticAttribute işaretlenmiş alanları kullanın.

public:
 static System::Object ^ GetData(LocalDataStoreSlot ^ slot);
public static object? GetData(LocalDataStoreSlot slot);
public static object GetData(LocalDataStoreSlot slot);
static member GetData : LocalDataStoreSlot -> obj
Public Shared Function GetData (slot As LocalDataStoreSlot) As Object

Parametreler

slot
LocalDataStoreSlot

LocalDataStoreSlot Değerin alındığı yer.

Döndürülenler

Alınan değer.

Örnekler

Bu bölüm iki kod örneği içerir. İlk örnekte, iş parçacığına özgü bilgileri tutmak için özniteliğiyle ThreadStaticAttribute işaretlenmiş bir alanın nasıl kullanılacağı gösterilmektedir. İkinci örnekte aynı işlemi yapmak için veri yuvasının nasıl kullanılacağı gösterilmektedir.

İlk Örnek

Aşağıdaki örnekte, iş parçacığına özgü bilgileri tutmak için ile ThreadStaticAttribute işaretlenmiş bir alanın nasıl kullanılacağı gösterilmektedir. Bu teknik, ikinci örnekte gösterilen teknikten daha iyi performans sağlar.

using System;
using System.Threading;

class Test
{
    static void Main()
    {
        for(int i = 0; i < 3; i++)
        {
            Thread newThread = new Thread(ThreadData.ThreadStaticDemo);
            newThread.Start();
        }
    }
}

class ThreadData
{
    [ThreadStatic]
    static int threadSpecificData;

    public static void ThreadStaticDemo()
    {
        // Store the managed thread id for each thread in the static
        // variable.
        threadSpecificData = Thread.CurrentThread.ManagedThreadId;
      
        // Allow other threads time to execute the same code, to show
        // that the static data is unique to each thread.
        Thread.Sleep( 1000 );

        // Display the static data.
        Console.WriteLine( "Data for managed thread {0}: {1}", 
            Thread.CurrentThread.ManagedThreadId, threadSpecificData );
    }
}

/* This code example produces output similar to the following:

Data for managed thread 4: 4
Data for managed thread 5: 5
Data for managed thread 3: 3
 */
open System
open System.Threading

type ThreadData() =
    // Create a static variable to hold the data for each thread.
    [<ThreadStatic; DefaultValue>]
    static val mutable private threadSpecificData : int

    static member ThreadStaticDemo() =
        // Store the managed thread id for each thread in the static
        // variable.
        ThreadData.threadSpecificData <- Thread.CurrentThread.ManagedThreadId
        
        // Allow other threads time to execute the same code, to show
        // that the static data is unique to each thread.
        Thread.Sleep 1000

        // Display the static data.
        printfn $"Data for managed thread {Thread.CurrentThread.ManagedThreadId}: {ThreadData.threadSpecificData}" 

for i = 0 to 2 do 
    let newThread = Thread ThreadData.ThreadStaticDemo
    newThread.Start()

// This code example produces output similar to the following:
//       Data for managed thread 4: 4
//       Data for managed thread 5: 5
//       Data for managed thread 3: 3
Imports System.Threading

Class Test

    <MTAThread> _
    Shared Sub Main()

        For i As Integer = 1 To 3
            Dim newThread As New Thread(AddressOf ThreadData.ThreadStaticDemo)
            newThread.Start()
        Next i

    End Sub

End Class

Class ThreadData

    <ThreadStatic> _
    Shared threadSpecificData As Integer

    Shared Sub ThreadStaticDemo()

        ' Store the managed thread id for each thread in the static
        ' variable.
        threadSpecificData = Thread.CurrentThread.ManagedThreadId
      
        ' Allow other threads time to execute the same code, to show
        ' that the static data is unique to each thread.
        Thread.Sleep( 1000 )

        ' Display the static data.
        Console.WriteLine( "Data for managed thread {0}: {1}", _
            Thread.CurrentThread.ManagedThreadId, threadSpecificData )

    End Sub

End Class

' This code example produces output similar to the following:
'
'Data for managed thread 4: 4
'Data for managed thread 5: 5
'Data for managed thread 3: 3

İkinci Örnek

Aşağıdaki örnekte, iş parçacığına özgü bilgileri depolamak için veri yuvasının nasıl kullanılacağı gösterilmektedir.

using System;
using System.Threading;

class Test
{
    static void Main()
    {
        Thread[] newThreads = new Thread[4];
        for(int i = 0; i < newThreads.Length; i++)
        {
            newThreads[i] = new Thread(
                new ThreadStart(Slot.SlotTest));
            newThreads[i].Start();
        }
    }
}

class Slot
{
    static Random randomGenerator;
    static LocalDataStoreSlot localSlot;

    static Slot()
    {
        randomGenerator = new Random();
        localSlot = Thread.AllocateDataSlot();
    }

    public static void SlotTest()
    {
        // Set different data in each thread's data slot.
        Thread.SetData(localSlot, randomGenerator.Next(1, 200));

        // Write the data from each thread's data slot.
        Console.WriteLine("Data in thread_{0}'s data slot: {1,3}", 
            AppDomain.GetCurrentThreadId().ToString(),
            Thread.GetData(localSlot).ToString());

        // Allow other threads time to execute SetData to show
        // that a thread's data slot is unique to the thread.
        Thread.Sleep(1000);

        Console.WriteLine("Data in thread_{0}'s data slot: {1,3}", 
            AppDomain.GetCurrentThreadId().ToString(),
            Thread.GetData(localSlot).ToString());
    }
}
open System
open System.Threading

module Slot =
    let randomGenerator = Random()
    let localSlot = Thread.AllocateDataSlot()


    let slotTest () =
        // Set different data in each thread's data slot.
        Thread.SetData(localSlot, randomGenerator.Next(1, 200))

        // Write the data from each thread's data slot.
        printfn $"Data in thread_{AppDomain.GetCurrentThreadId()}'s data slot: {Thread.GetData localSlot, 3}"

        // Allow other threads time to execute SetData to show
        // that a thread's data slot is unique to the thread.
        Thread.Sleep 1000

        printfn $"Data in thread_{AppDomain.GetCurrentThreadId()}'s data slot: {Thread.GetData localSlot, 3}"

let newThreads =
    [| for _ = 0 to 3 do
           let thread = Thread Slot.slotTest
           thread.Start()
           thread |]
Imports System.Threading

Class Test

    <MTAThread> _
    Shared Sub Main()
        Dim newThreads(3) As Thread
        For i As Integer = 0 To newThreads.Length - 1
            newThreads(i) = New Thread(AddressOf Slot.SlotTest)
            newThreads(i).Start()
        Next i
    End Sub

End Class

Public Class Slot

    Shared randomGenerator As Random
    Shared localSlot As LocalDataStoreSlot

    Shared Sub New()
        randomGenerator = new Random()
        localSlot = Thread.AllocateDataSlot()
    End Sub

    Shared Sub SlotTest()

        ' Set different data in each thread's data slot.
        Thread.SetData(localSlot, randomGenerator.Next(1, 200))

        ' Write the data from each thread's data slot.
        Console.WriteLine("Data in thread_{0}'s data slot: {1,3}", _
            AppDomain.GetCurrentThreadId().ToString(), _
            Thread.GetData(localSlot).ToString())

        ' Allow other threads time to execute SetData to show
        ' that a thread's data slot is unique to the thread.
        Thread.Sleep(1000)

        ' Write the data from each thread's data slot.
        Console.WriteLine("Data in thread_{0}'s data slot: {1,3}", _
            AppDomain.GetCurrentThreadId().ToString(), _
            Thread.GetData(localSlot).ToString())
    End Sub

End Class

Açıklamalar

Important

.NET Framework, iş parçacığı yerel depolamasını (TLS) kullanmak için iki mekanizma sağlar: iş parçacığı göreli statik alanlar (yani, ThreadStaticAttribute özniteliğiyle işaretlenmiş alanlar) ve veri yuvaları. İş parçacığı göreli statik alanlar, veri yuvalarından çok daha iyi performans sağlar ve derleme zamanı türü denetimini etkinleştirir. TLS kullanma hakkında daha fazla bilgi için bkz . İş Parçacığı Yerel Depolama: Thread-Relative Statik Alanlar ve Veri Yuvaları.

İş parçacıkları, iş parçacığına özgü verileri depolamak için yerel depolama bellek mekanizması kullanır. Ortak dil çalışma zamanı, oluşturulduğunda her işleme çok yuvalı bir veri deposu dizisi ayırır. İş parçacığı veri deposunda bir veri yuvası ayırabilir, yuvada bir veri değeri depolayıp alabilir ve iş parçacığının süresi dolduktan sonra yuvayı yeniden kullanmak üzere serbest bırakabilir. Veri yuvaları iş parçacığı başına benzersizdir. Başka hiçbir iş parçacığı (alt iş parçacığı bile) bu verileri alamaz.

Note

GetData , başka bir iş parçacığına başvuran bir Shared değişken kullanarak çağırsanız bile o anda yürütülen iş parçacığı için her zaman geçerli olan bir yöntemdir. Karışıklığı önlemek için, yöntemleri çağırırken Shared sınıf adını kullanın: Dim test As Object = Thread.GetData(testSlot).

Şunlara uygulanır

Ayrıca bkz.