ParameterizedThreadStart ParameterizedThreadStart ParameterizedThreadStart ParameterizedThreadStart Delegate

Определение

Представляет метод, выполняющийся в объекте Thread.Represents the method that executes on a Thread.

public delegate void ParameterizedThreadStart(System::Object ^ obj);
[System.Runtime.InteropServices.ComVisible(false)]
public delegate void ParameterizedThreadStart(object obj);
type ParameterizedThreadStart = delegate of obj -> unit
Public Delegate Sub ParameterizedThreadStart(obj As Object)

Параметры

obj
Object Object Object Object

Объект, содержащий данные потоковой процедуры.An object that contains data for the thread procedure.

Наследование
ParameterizedThreadStartParameterizedThreadStartParameterizedThreadStartParameterizedThreadStart
Атрибуты

Примеры

В следующем примере кода используется ParameterizedThreadStart делегат для выполнения статическим методом и методом экземпляра.The following code example uses a ParameterizedThreadStart delegate to execute a static method and an instance method. Первый ParameterizedThreadStart делегат представлен статическим DoWork метод, а второй представлен экземпляром DoMoreWork метод.The first ParameterizedThreadStart delegate is represented by the static DoWork method and the second is represented by the instance DoMoreWork method. Оба метода соответствует ParameterizedThreadStart сигнатуре делегата; то есть они имеют один параметр типа Object и не возвращает значений.Both methods match the ParameterizedThreadStart delegate signature; that is, they have a single parameter of type Object and don't return a value.

Примечание

Компиляторы Visual Basic и C# определяют ParameterizedThreadStart делегата из сигнатуры DoWork и DoMoreWork методов и вызовите метод надлежащий конструктор.The Visual Basic and C# compilers infer the ParameterizedThreadStart delegate from the signatures of the DoWork and DoMoreWork methods, and call the correct constructor. Таким образом отсутствует явный конструктор вызов в коде.Thus, there is no explicit constructor call in the code.

using namespace System;
using namespace System::Threading;

namespace SystemThreadingExample
{
    public ref class Work
    {
    public:
        void StartThreads()
        {
            // Start a thread that calls a parameterized static method.
            Thread^ newThread = gcnew
                Thread(gcnew ParameterizedThreadStart(Work::DoWork));
            newThread->Start(42);
              
            // Start a thread that calls a parameterized instance method.
            Work^ someWork = gcnew Work;
            newThread = gcnew Thread(
                        gcnew ParameterizedThreadStart(someWork,
                        &Work::DoMoreWork));
            newThread->Start("The answer.");
        }

        static void DoWork(Object^ data)
        {
            Console::WriteLine("Static thread procedure. Data='{0}'", 
                data);
        }

        void DoMoreWork(Object^ data)
        {
            Console::WriteLine("Instance thread procedure. Data='{0}'", 
                data);
        }
    };
}

//Entry point of example application
int main()
{
    SystemThreadingExample::Work^ samplework = 
        gcnew SystemThreadingExample::Work();
    samplework->StartThreads();
}
// This example displays output like the following:
//       Static thread procedure. Data='42'
//       Instance thread procedure. Data='The answer.'
using System;
using System.Threading;

public class Work
{
    public static void Main()
    {
        // Start a thread that calls a parameterized static method.
        Thread newThread = new Thread(Work.DoWork);
        newThread.Start(42);

        // Start a thread that calls a parameterized instance method.
        Work w = new Work();
        newThread = new Thread(w.DoMoreWork);
        newThread.Start("The answer.");
    }
 
    public static void DoWork(object data)
    {
        Console.WriteLine("Static thread procedure. Data='{0}'",
            data);
    }

    public void DoMoreWork(object data)
    {
        Console.WriteLine("Instance thread procedure. Data='{0}'",
            data);
    }
}
// This example displays output like the following:
//       Static thread procedure. Data='42'
//       Instance thread procedure. Data='The answer.'
Imports System.Threading

Public Class Work
    Shared Sub Main()
        ' Start a thread that calls a parameterized static method.
        Dim newThread As New Thread(AddressOf Work.DoWork)
        newThread.Start(42)

        ' Start a thread that calls a parameterized instance method.
        Dim w As New Work()
        newThread = New Thread(AddressOf w.DoMoreWork)
        newThread.Start("The answer.")
    End Sub
 
    Public Shared Sub DoWork(ByVal data As Object)
        Console.WriteLine("Static thread procedure. Data='{0}'",
                          data)
    End Sub

    Public Sub DoMoreWork(ByVal data As Object) 
        Console.WriteLine("Instance thread procedure. Data='{0}'",
                          data)
    End Sub
End Class
' This example displays output like the following:
'    Static thread procedure. Data='42'
'    Instance thread procedure. Data='The answer.'

Комментарии

При создании управляемого потока, представленного метод, который выполняется в потоке:When a managed thread is created, the method that executes on the thread is represented by:

  • Объект ThreadStart делегат, который передается Thread.Thread(ThreadStart) конструктор.A ThreadStart delegate that is passed to the Thread.Thread(ThreadStart) constructor. Любой метод, который не имеет параметров и возвращает void в C# или Sub процедуры в Visual Basic может представлять делегат.Any method that has no parameters and that returns void in C# or is a Sub procedure in Visual Basic can represent the delegate.

  • Объект ParameterizedThreadStart делегат, который передается Thread.Thread(ParameterizedThreadStart) конструктор.A ParameterizedThreadStart delegate that is passed to the Thread.Thread(ParameterizedThreadStart) constructor. Любой метод, который имеет один параметр типа Object и возвращает значение void в C#, являющийся процедуру Sub в Visual Basic может представлять делегат.Any method that has a single parameter of type Object and that returns void in C# or is a Sub procedure in Visual Basic can represent the delegate.

Поток не запускается до Thread.Start вызывается метод.The thread does not begin executing until the Thread.Start method is called. ThreadStart Или ParameterizedThreadStart делегат вызывается в потоке, и начинается выполнение на первой строке метода, представленный делегатом.The ThreadStart or ParameterizedThreadStart delegate is invoked on the thread, and execution begins at the first line of the method represented by the delegate. В случае использования ParameterizedThreadStart делегировать, объект, который передается Start(Object) методу передается делегату.In the case of the ParameterizedThreadStart delegate, the object that is passed to the Start(Object) method is passed to the delegate.

Примечание

Пользователи Visual Basic и C# можно опустить ThreadStart или ParameterizedThreadStart конструктора делегата при создании потока.Visual Basic and C# users can omit the ThreadStart or ParameterizedThreadStart delegate constructor when creating a thread. В Visual Basic, использовать AddressOf оператор при передаче метод Thread конструктор, например Dim t As New Thread(AddressOf ThreadProc).In Visual Basic, use the AddressOf operator when passing your method to the Thread constructor; for example, Dim t As New Thread(AddressOf ThreadProc). В C# просто укажите имя процедуры потока.In C#, simply specify the name of the thread procedure. Компилятор выбирает соответствующий конструктор делегата.The compiler selects the correct delegate constructor.

Примечание

При создании ParameterizedThreadStart делегат для метода экземпляра в C++, первый параметр конструктора является переменной экземпляра.When you create a ParameterizedThreadStart delegate for an instance method in C++, the first parameter of the constructor is the instance variable. Для статического метода первый параметр конструктора равно нулю.For a static method, the first parameter of the constructor is zero. Для статического метода, конструктора делегата требуется только один параметр: адрес метода обратного вызова, дополненное имя класса.For a static method, the delegate constructor requires only one parameter: the address of the callback method, qualified by the class name.

ParameterizedThreadStart Делегировать и Thread.Start(Object) перегрузку метода позволяют легко передавать данные в процедуру потока, но этот метод не является строго типизированным, так как любой объект может быть передан Thread.Start(Object).The ParameterizedThreadStart delegate and the Thread.Start(Object) method overload make it easy to pass data to a thread procedure, but this technique is not type safe because any object can be passed to Thread.Start(Object). Для размещения процедуры потока и полей данных в рабочий объект является более надежным способом для передачи данных в процедуру потока.A more robust way to pass data to a thread procedure is to put both the thread procedure and the data fields into a worker object. Дополнительные сведения см. в разделе создание потоков и передача данных во время запуска.For more information, see Creating Threads and Passing Data at Start Time.

ParameterizedThreadStart Делегат поддерживает только один параметр.The ParameterizedThreadStart delegate supports only a single parameter. Вы можете передать несколько элементов данных, чтобы ParameterizedThreadStart благодаря этому параметру, одно из следующих:You can pass multiple data items to the ParameterizedThreadStart by making that parameter one of the following:

  • Массив.An array.

  • Тип коллекции, если все элементы данных одного типа.A collection type, if all of the data items are of the same type.

  • Тип кортежа, например Tuple<T1,T2> или Tuple<T1,T2,T3,T4>.A tuple type, such as Tuple<T1,T2> or Tuple<T1,T2,T3,T4>.

Методы расширения

GetMethodInfo(Delegate) GetMethodInfo(Delegate) GetMethodInfo(Delegate) GetMethodInfo(Delegate)

Получает объект, представляющий метод, представленный указанным делегатом.Gets an object that represents the method represented by the specified delegate.

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

Дополнительно