IteratorStateMachineAttribute 類別

定義

命名空間:

System.Runtime.CompilerServices

組件:

System.Runtime.dll

來源:

IteratorStateMachineAttribute.cs

指出 Visual Basic 的方法是否以 Iterator 修飾詞標記。

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

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

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

Public NotInheritable Class IteratorStateMachineAttribute
Inherits StateMachineAttribute

繼承

Object

Attribute

StateMachineAttribute

IteratorStateMachineAttribute

屬性

AttributeUsageAttribute

範例

下列範例示範如何判斷方法是否為反覆運算器方法。 在範例中， IsIteratorMethod 執行下列步驟：

• MethodInfo使用Type.GetMethod取得方法名稱的物件。

• Type使用 GetType 運算子取得屬性的物件。

• 使用 MethodInfo.GetCustomAttribute取得方法和屬性類型的屬性物件。 如果 GetCustomAttribute 傳 Nothing 回visual Basic () ，方法就不會包含屬性。

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

備註

您不應該將 IteratorStateMachine 屬性套用至程序代碼中的方法。 對於具有 Iterator 修飾詞之 Visual Basic 中的方法，編譯程式會在它發出的 IL 中套用 IteratorStateMachine 屬性。

當 Visual Basic 中方法 (MethodName) 具有 Iterator 修飾詞時，編譯程式會發出包含狀態機器結構的 IL。 該結構包含方法中的程序代碼。 該 IL 也包含 stub 方法， (MethodName) 呼叫狀態電腦。 編譯程式會將 IteratorStateMachine 屬性新增至存根方法，讓工具可以識別對應的狀態機器。 發出之 IL 的詳細數據可能會在編譯程式的未來版本中變更。

反覆運算器方法會使用 Yield (Visual Basic) 語句，一次傳回每個元素，以對集合執行自定義反覆專案。 如需詳細資訊，請參閱 Iterator。

注意

您無法使用 IteratorStateMachineAttribute 來測試方法是否為 C# 中的反覆運算器方法。

建構函式

IteratorStateMachineAttribute(Type)

初始化 IteratorStateMachineAttribute 類別的新執行個體。

屬性

StateMachineType	傳回基礎狀態機器型別的型別物件，編譯器產生此型別以實作狀態機器方法。 (繼承來源 StateMachineAttribute)
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• AsyncStateMachineAttribute
• StateMachineType