AsyncStateMachineAttribute Kelas

Definisi

Ruang nama:

System.Runtime.CompilerServices

Rakitan:

System.Runtime.dll

Sumber:

AsyncStateMachineAttribute.cs

Menunjukkan apakah metode ditandai dengan pengubah Asinkron atau asinkron .

public ref class AsyncStateMachineAttribute sealed : System::Runtime::CompilerServices::StateMachineAttribute

[System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)]
public sealed class AsyncStateMachineAttribute : System.Runtime.CompilerServices.StateMachineAttribute

[<System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)>]
type AsyncStateMachineAttribute = class
    inherit StateMachineAttribute

Public NotInheritable Class AsyncStateMachineAttribute
Inherits StateMachineAttribute

Warisan

Object

Attribute

StateMachineAttribute

AsyncStateMachineAttribute

Atribut

AttributeUsageAttribute

Contoh

Seperti yang ditunjukkan oleh contoh berikut, Anda dapat menentukan apakah metode ditandai dengan pengubah Asinkron atau asinkron . Dalam contoh, IsAsyncMethod lakukan langkah-langkah berikut:

• MethodInfo Mendapatkan objek untuk nama metode dengan menggunakan Type.GetMethod.

• Type Mendapatkan objek untuk atribut dengan menggunakan Operator GetType atau typeof.

• Mendapatkan objek atribut untuk metode dan jenis atribut dengan menggunakan MethodInfo.GetCustomAttribute. Jika GetCustomAttribute mengembalikan Nothing (Visual Basic) atau null (C#), metode tidak berisi atribut .

using System;
using System.Collections.Generic;
using System.Reflection;
using System.Threading.Tasks;
using System.Runtime.CompilerServices;

namespace ConsoleApplication1
{

    // This class is used by the code below to discover method attributes.
    public class TheClass
    {
        public async Task<int> AsyncMethod()
        {
            await Task.Delay(5);
            return 1;
        }

        public int RegularMethod()
        {
            return 0;
        }
    }

    class Program
    {
        private static bool IsAsyncMethod(Type classType, string methodName)
        {
            // Obtain the method with the specified name.
            MethodInfo method = classType.GetMethod(methodName);

            Type attType = typeof(AsyncStateMachineAttribute);

            // Obtain the custom attribute for the method.
            // The value returned contains the StateMachineType property.
            // Null is returned if the attribute isn't present for the method.
            var attrib = (AsyncStateMachineAttribute)method.GetCustomAttribute(attType);

            return (attrib != null);
        }

        private static void ShowResult(Type classType, string methodName)
        {
            Console.Write((methodName + ": ").PadRight(16));

            if (IsAsyncMethod(classType, methodName))
                Console.WriteLine("Async method");
            else
                Console.WriteLine("Regular method");
        }

        static void Main(string[] args)
        {
            ShowResult(classType: typeof(TheClass), methodName: "AsyncMethod");
            ShowResult(classType: typeof(TheClass), methodName: "RegularMethod");

            // Note: The IteratorStateMachineAttribute applies to Visual Basic methods
            // but not C# methods.

            Console.ReadKey();
        }

        // Output:
        //   AsyncMethod:    Async method
        //   RegularMethod:  Regular method
    }
}

Imports System.Collections.Generic
Imports System.Reflection
Imports System.Threading.Tasks
Imports System.Runtime.CompilerServices


Module Module1

    ' This class is used by the code below to discover method attributes.
    Public Class TheClass
        Public Async Function AsyncMethod() As Task(Of Integer)
            Await Task.Delay(5)
            Return 1
        End Function

        Public Iterator Function IteratorMethod() As IEnumerable(Of Integer)
            Yield 1
            Yield 2
        End Function

        Public Function RegularMethod() As Integer
            Return 0
        End Function
    End Class


    Private Function IsAsyncMethod(classType As Type, methodName As String)
        ' Obtain the method with the specified name.
        Dim method As MethodInfo = classType.GetMethod(methodName)

        Dim attType As Type = GetType(AsyncStateMachineAttribute)

        Dim attrib = CType(method.GetCustomAttribute(attType), AsyncStateMachineAttribute)
        ' The above variable contains the StateMachineType property.

        Return (attrib IsNot Nothing)
    End Function

    Private Function IsIteratorMethod(classType As Type, methodName As String)
        ' Obtain the method with the specified name.
        Dim method As MethodInfo = classType.GetMethod(methodName)

        Dim attType As Type = GetType(IteratorStateMachineAttribute)

        ' Obtain the custom attribute for the method.
        ' The value returned contains the StateMachineType property.
        ' Nothing is returned if the attribute isn't present for the method.
        Dim attrib = CType(method.GetCustomAttribute(attType), IteratorStateMachineAttribute)

        Return (attrib IsNot Nothing)
    End Function

    Private Sub ShowResult(classType As Type, methodName As String)
        Console.Write((methodName & ": ").PadRight(16))

        If IsAsyncMethod(classType, methodName) Then
            Console.WriteLine("Async method")
        ElseIf IsIteratorMethod(classType, methodName) Then
            Console.WriteLine("Iterator method")
        Else
            Console.WriteLine("Regular method")
        End If

        ' Note: The IteratorStateMachineAttribute applies to Visual Basic methods
        ' but not C# methods.
    End Sub

    Sub Main()
        ShowResult(GetType(TheClass), "AsyncMethod")
        ShowResult(GetType(TheClass), "IteratorMethod")
        ShowResult(GetType(TheClass), "RegularMethod")

        Console.ReadKey()
    End Sub

    '   AsyncMethod:    Async method
    '   IteratorMethod: Iterator method
    '   RegularMethod:  Regular method

End Module

Keterangan

Anda tidak boleh menerapkan atribut ke AsyncStateMachine metode dalam kode Anda. Untuk metode yang memiliki pengubah asinkron, pengkompilasi akan menerapkan AsyncStateMachine atribut di IL yang dipancarkan pengkompilasi.

Ketika metode (MethodName) memiliki pengubah Asinkron atau asinkron, pengkompilasi memancarkan IL yang menyertakan struktur komputer status. Struktur ini berisi kode dalam metode . IL tersebut juga berisi metode stub (MethodName) yang memanggil ke mesin status. Pengkompilasi menambahkan atribut ke AsyncStateMachine metode stub sehingga alat dapat mengidentifikasi mesin status yang sesuai. Detail IL yang dipancarkan mungkin berubah dalam rilis kompilator di masa mendatang.

Untuk informasi tentang fitur Asinkron, lihat Pemrograman asinkron (C#) atau Pemrograman asinkron dengan Asinkron dan Menunggu (Visual Basic).

Konstruktor

AsyncStateMachineAttribute(Type)

Menginisialisasi instans baru kelas AsyncStateMachineAttribute.

Properti

StateMachineType	Mengembalikan objek jenis untuk jenis mesin status yang mendasar yang dihasilkan oleh pengkompilasi untuk mengimplementasikan metode mesin status. (Diperoleh dari StateMachineAttribute)
TypeId	Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute. (Diperoleh dari Attribute)

Metode

Equals(Object)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari Attribute)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
IsDefaultAttribute()	Ketika ditimpa di kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan. (Diperoleh dari Attribute)
Match(Object)	Saat ditimpa di kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• IteratorStateMachineAttribute
• StateMachineType