Toegang tot kenmerken met behulp van weerspiegeling (Visual Basic)
Het feit dat u aangepaste kenmerken kunt definiëren en deze in uw broncode kunt plaatsen, zou weinig waarde hebben zonder dat u die informatie op een of andere manier kunt ophalen en erop kunt reageren. Met weerspiegeling kunt u de informatie ophalen die is gedefinieerd met aangepaste kenmerken. De sleutelmethode is GetCustomAttributes
, die een matrix met objecten retourneert die de runtime-equivalenten van de broncodekenmerken zijn. Deze methode heeft verschillende overbelaste versies. Zie Attribute voor meer informatie.
Een kenmerkspecificatie zoals:
<Author("P. Ackerman", Version:=1.1)>
Class SampleClass
' P. Ackerman's code goes here...
End Class
is conceptueel gelijk aan dit:
Dim anonymousAuthorObject As Author = New Author("P. Ackerman")
anonymousAuthorObject.version = 1.1
De code wordt echter pas uitgevoerd wanneer SampleClass
er een query wordt uitgevoerd op kenmerken. SampleClass
Als u aanroeptGetCustomAttributes
, wordt een Author
object geconstrueerd en geïnitialiseerd zoals hierboven. Als de klasse andere kenmerken heeft, worden andere kenmerkobjecten op dezelfde manier samengesteld. GetCustomAttributes
retourneert vervolgens het Author
object en eventuele andere kenmerkobjecten in een matrix. Vervolgens kunt u deze matrix herhalen, bepalen welke kenmerken zijn toegepast op basis van het type van elk matrixelement en informatie extraheren uit de kenmerkobjecten.
Opmerking
Hier volgt een volledig voorbeeld. Er wordt een aangepast kenmerk gedefinieerd, toegepast op verschillende entiteiten en opgehaald via weerspiegeling.
' Multiuse attribute
<System.AttributeUsage(System.AttributeTargets.Class Or
System.AttributeTargets.Struct,
AllowMultiple:=True)>
Public Class Author
Inherits System.Attribute
Private name As String
Public version As Double
Sub New(ByVal authorName As String)
name = authorName
' Default value
version = 1.0
End Sub
Function GetName() As String
Return name
End Function
End Class
' Class with the Author attribute
<Author("P. Ackerman")>
Public Class FirstClass
End Class
' Class without the Author attribute
Public Class SecondClass
End Class
' Class with multiple Author attributes.
<Author("P. Ackerman"), Author("R. Koch", Version:=2.0)>
Public Class ThirdClass
End Class
Class TestAuthorAttribute
Sub Main()
PrintAuthorInfo(GetType(FirstClass))
PrintAuthorInfo(GetType(SecondClass))
PrintAuthorInfo(GetType(ThirdClass))
End Sub
Private Shared Sub PrintAuthorInfo(ByVal t As System.Type)
System.Console.WriteLine("Author information for {0}", t)
' Using reflection
Dim attrs() As System.Attribute = System.Attribute.GetCustomAttributes(t)
' Displaying output
For Each attr In attrs
Dim a As Author = CType(attr, Author)
System.Console.WriteLine(" {0}, version {1:f}", a.GetName(), a.version)
Next
End Sub
' Output:
' Author information for FirstClass
' P. Ackerman, version 1.00
' Author information for SecondClass
' Author information for ThirdClass
' R. Koch, version 2.00
' P. Ackerman, version 1.00
End Class