.NET framework 3.5 引入了对匹配方法签名和委托类型中的所有委托中的变体支持C#和 Visual Basic。 这表明不仅可以将具有匹配签名的方法分配给委托,还可以将返回多个派生类型(协变)的方法分配给委托,或者将所接受参数的派生类型(逆变)数目比委托类型指定的数目少的方法分配给委托。 这包括泛型委托和非泛型委托。
例如,思考以下代码,该代码具有两个类和两个委托:泛型和非泛型。
Public Class First
End Class
Public Class Second
Inherits First
End Class
Public Delegate Function SampleDelegate(ByVal a As Second) As First
Public Delegate Function SampleGenericDelegate(Of A, R)(ByVal a As A) As R
创建 SampleDelegate 或 SampleDelegate(Of A, R) 类型的委托时,可以将以下任一方法分配给这些委托。
' Matching signature.
Public Shared Function ASecondRFirst(
ByVal second As Second) As First
Return New First()
End Function
' The return type is more derived.
Public Shared Function ASecondRSecond(
ByVal second As Second) As Second
Return New Second()
End Function
' The argument type is less derived.
Public Shared Function AFirstRFirst(
ByVal first As First) As First
Return New First()
End Function
' The return type is more derived
' and the argument type is less derived.
Public Shared Function AFirstRSecond(
ByVal first As First) As Second
Return New Second()
End Function
以下代码示例说明了方法签名与委托类型之间的隐式转换。
' Assigning a method with a matching signature
' to a non-generic delegate. No conversion is necessary.
Dim dNonGeneric As SampleDelegate = AddressOf ASecondRFirst
' Assigning a method with a more derived return type
' and less derived argument type to a non-generic delegate.
' The implicit conversion is used.
Dim dNonGenericConversion As SampleDelegate = AddressOf AFirstRSecond
' Assigning a method with a matching signature to a generic delegate.
' No conversion is necessary.
Dim dGeneric As SampleGenericDelegate(Of Second, First) = AddressOf ASecondRFirst
' Assigning a method with a more derived return type
' and less derived argument type to a generic delegate.
' The implicit conversion is used.
Dim dGenericConversion As SampleGenericDelegate(Of Second, First) = AddressOf AFirstRSecond
有关更多示例,请参阅使用委托 (Visual Basic 中) 中的变体并对 Func 和 Action 泛型委托 (Visual Basic 中) 使用变体。
泛型类型参数中的变体
在.NET Framework 4 及更高版本,以便可以为具有指定的泛型类型参数的不同类型的泛型委托分配到对方,,如果类型继承自对方所需的可以启用委托之间的隐式转换方差。
若要启用隐式转换,必须使用 in 或 out 关键字将委托中的泛型参数显式声明为协变或逆变。
以下代码示例演示了如何创建一个具有协变泛型类型参数的委托。
' Type T is declared covariant by using the out keyword.
Public Delegate Function SampleGenericDelegate(Of Out T)() As T
Sub Test()
Dim dString As SampleGenericDelegate(Of String) = Function() " "
' You can assign delegates to each other,
' because the type T is declared covariant.
Dim dObject As SampleGenericDelegate(Of Object) = dString
End Sub
如果仅使用变体支持来匹配方法签名和委托类型,且不使用 in 和 out 关键字,则可能会发现有时可以使用相同的 lambda 表达式或方法实例化委托,但不能将一个委托分配给另一个委托。
在下面的代码示例中,SampleGenericDelegate(Of String)不能显式转换为SampleGenericDelegate(Of Object),尽管String继承Object。 可以使用 out 关键字标记 泛型参数 T 解决此问题。
Public Delegate Function SampleGenericDelegate(Of T)() As T
Sub Test()
Dim dString As SampleGenericDelegate(Of String) = Function() " "
' You can assign the dObject delegate
' to the same lambda expression as dString delegate
' because of the variance support for
' matching method signatures with delegate types.
Dim dObject As SampleGenericDelegate(Of Object) = Function() " "
' The following statement generates a compiler error
' because the generic type T is not marked as covariant.
' Dim dObject As SampleGenericDelegate(Of Object) = dString
End Sub
.NET Framework 中具有变体类型参数的泛型委托
.NET Framework 4 在几个现有泛型委托中引入了泛型类型参数的变体支持:
-
xref:System 命名空间的
Action委托,例如 xref:System.Action`1 和 xref:System.Action`2 -
xref:System 命名空间的
Func委托,例如 xref:System.Func`1 和 xref:System.Func`2
有关详细信息和示例,请参阅对 Func 和 Action 泛型委托 (Visual Basic 中) 使用变体。
声明泛型委托中的变体类型参数
如果泛型委托具有协变或逆变泛型类型参数,则该委托可被称为“变体泛型委托”。
可以使用 out 关键字声明泛型委托中的泛型类型参数协变。 协变类型只能用作方法返回类型,而不能用作方法参数的类型。 以下代码示例演示了如何声明协变泛型委托。
Public Delegate Function DCovariant(Of Out R)() As R
可以使用 in 关键字声明泛型委托中的泛型类型参数逆变。 逆变类型只能用作方法参数的类型,而不能用作方法返回类型。 以下代码示例演示了如何声明逆变泛型委托。
Public Delegate Sub DContravariant(Of In A)(ByVal a As A)
Important:
ByRef在 Visual Basic 中的参数不能标记为变体。
可以在同一个委托中支持变体和协变,但这只适用于不同类型的参数。 这在下面的示例中显示。
Public Delegate Function DVariant(Of In A, Out R)(ByVal a As A) As R
实例化和调用变体泛型委托
可以像实例化和调用固定委托一样,实例化和调用变体委托。 在以下示例中,该委托通过 lambda 表达式进行实例化。
Dim dvariant As DVariant(Of String, String) = Function(str) str + " "
dvariant("test")
合并变体泛型委托
不应合并变体委托。 xref:System.Delegate.Combine* 方法不支持变体委托转换,并且要求委托的类型完全相同。 这可能会导致运行时异常时合并委托可通过使用xref:System.Delegate.Combine*方法 (在C#和 Visual Basic) 或使用+运算符 (在C#),如下面的代码示例中所示。
Dim actObj As Action(Of Object) = Sub(x) Console.WriteLine("object: {0}", x)
Dim actStr As Action(Of String) = Sub(x) Console.WriteLine("string: {0}", x)
' The following statement throws an exception at run time.
' Dim actCombine = [Delegate].Combine(actStr, actObj)
泛型类型参数中用于值和引用类型的变体
泛型类型参数的变体仅支持引用类型。 例如,DVariant(Of Int)不能隐式转换为DVariant(Of Object)或DVariant(Of Long),因为整数是值类型。
以下示例演示了泛型类型参数中的变体不支持值类型。
' The type T is covariant.
Public Delegate Function DVariant(Of Out T)() As T
' The type T is invariant.
Public Delegate Function DInvariant(Of T)() As T
Sub Test()
Dim i As Integer = 0
Dim dInt As DInvariant(Of Integer) = Function() i
Dim dVariantInt As DVariant(Of Integer) = Function() i
' All of the following statements generate a compiler error
' because type variance in generic parameters is not supported
' for value types, even if generic type parameters are declared variant.
' Dim dObject As DInvariant(Of Object) = dInt
' Dim dLong As DInvariant(Of Long) = dInt
' Dim dVariantObject As DInvariant(Of Object) = dInt
' Dim dVariantLong As DInvariant(Of Long) = dInt
End Sub
在 Visual Basic 中的宽松的委托转换
宽松的委托转换,更灵活地匹配方法签名和委托类型。 例如,它允许您忽略参数规范和到委托分配方法时省略函数返回值。 有关详细信息,请参阅宽松委托转换。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
