Retrieves a custom attribute applied to a method parameter. Parameters specify the method parameter, the type of the custom attribute to search for, and whether to search ancestors of the method parameter.
public:
static Attribute ^ GetCustomAttribute(System::Reflection::ParameterInfo ^ element, Type ^ attributeType, bool inherit);public static Attribute? GetCustomAttribute(System.Reflection.ParameterInfo element, Type attributeType, bool inherit);public static Attribute GetCustomAttribute(System.Reflection.ParameterInfo element, Type attributeType, bool inherit);static member GetCustomAttribute : System.Reflection.ParameterInfo * Type * bool -> AttributePublic Shared Function GetCustomAttribute (element As ParameterInfo, attributeType As Type, inherit As Boolean) As AttributeThe type, or a base type, of the custom attribute to search for.
If true, specifies to also search the ancestors of element for custom attributes.
A reference to the single custom attribute of type attributeType that is applied to element, or null if there is no such attribute.
element or attributeType is null.
More than one of the requested attributes was found.
A custom attribute type cannot be loaded.
ExamplesThe following code example defines a custom parameter Attribute class and applies the custom attribute to a method in a derived class and the base of the derived class. The example shows the use of the GetCustomAttribute method to return the attributes.
// Example for the Attribute.GetCustomAttribute( ParameterInfo, Type, Boolean )
// method.
using System;
using System.Reflection;
namespace NDP_UE_CS
{
// Define a custom parameter attribute that takes a single message argument.
[AttributeUsage( AttributeTargets.Parameter )]
public class ArgumentUsageAttribute : Attribute
{
// This is the attribute constructor.
public ArgumentUsageAttribute( string UsageMsg )
{
this.usageMsg = UsageMsg;
}
// usageMsg is storage for the attribute message.
protected string usageMsg;
// This is the Message property for the attribute.
public string Message
{
get { return usageMsg; }
set { usageMsg = value; }
}
}
public class BaseClass
{
// Assign an ArgumentUsage attribute to the strArray parameter.
// Assign a ParamArray attribute to strList using the params keyword.
public virtual void TestMethod(
[ArgumentUsage("Must pass an array here.")]
String[] strArray,
params String[] strList)
{ }
}
public class DerivedClass : BaseClass
{
// Assign an ArgumentUsage attribute to the strList parameter.
// Assign a ParamArray attribute to strList using the params keyword.
public override void TestMethod(
String[] strArray,
[ArgumentUsage("Can pass a parameter list or array here.")]
params String[] strList)
{ }
}
class CustomParamDemo
{
static void Main( )
{
Console.WriteLine(
"This example of Attribute.GetCustomAttribute( Parameter" +
"Info, Type, Boolean )\ngenerates the following output." );
// Get the class type, and then get the MethodInfo object
// for TestMethod to access its metadata.
Type clsType = typeof(DerivedClass);
MethodInfo mInfo = clsType.GetMethod("TestMethod");
// Iterate through the ParameterInfo array for the method parameters.
ParameterInfo[] pInfoArray = mInfo.GetParameters();
if (pInfoArray != null)
{
DisplayParameterAttributes( mInfo, pInfoArray, false );
DisplayParameterAttributes( mInfo, pInfoArray, true );
}
else
Console.WriteLine("The parameters information could " +
"not be retrieved for method {0}.", mInfo.Name);
}
static void DisplayParameterAttributes( MethodInfo mInfo,
ParameterInfo[] pInfoArray, bool includeInherited )
{
Console.WriteLine(
"\nParameter attribute information for method \"" +
"{0}\"\nincludes inheritance from base class: {1}.",
mInfo.Name, includeInherited ? "Yes" : "No" );
// Display the attribute information for the parameters.
foreach( ParameterInfo paramInfo in pInfoArray )
{
// See if the ParamArray attribute is defined.
bool isDef = Attribute.IsDefined( paramInfo,
typeof(ParamArrayAttribute));
if( isDef )
Console.WriteLine(
"\n The ParamArray attribute is defined " +
"for \n parameter {0} of method {1}.",
paramInfo.Name, mInfo.Name);
// See if ParamUsageAttribute is defined.
// If so, display a message.
ArgumentUsageAttribute usageAttr = (ArgumentUsageAttribute)
Attribute.GetCustomAttribute( paramInfo,
typeof(ArgumentUsageAttribute),
includeInherited );
if( usageAttr != null )
{
Console.WriteLine(
"\n The ArgumentUsage attribute is def" +
"ined for \n parameter {0} of method {1}.",
paramInfo.Name, mInfo.Name );
Console.WriteLine( "\n The usage " +
"message for {0} is:\n \"{1}\".",
paramInfo.Name, usageAttr.Message);
}
}
}
}
}
/*
This example of Attribute.GetCustomAttribute( ParameterInfo, Type, Boolean )
generates the following output.
Parameter attribute information for method "TestMethod"
includes inheritance from base class: No.
The ParamArray attribute is defined for
parameter strList of method TestMethod.
The ArgumentUsage attribute is defined for
parameter strList of method TestMethod.
The usage message for strList is:
"Can pass a parameter list or array here.".
Parameter attribute information for method "TestMethod"
includes inheritance from base class: Yes.
The ArgumentUsage attribute is defined for
parameter strArray of method TestMethod.
The usage message for strArray is:
"Must pass an array here.".
The ParamArray attribute is defined for
parameter strList of method TestMethod.
The ArgumentUsage attribute is defined for
parameter strList of method TestMethod.
The usage message for strList is:
"Can pass a parameter list or array here.".
*/
open System
open System.Reflection
// Define a custom parameter attribute that takes a single message argument.
[<AttributeUsage(AttributeTargets.Parameter); AllowNullLiteral>]
type ArgumentUsageAttribute(usageMsg) =
inherit Attribute()
// This is the Message property for the attribute.
member val Message: string = usageMsg
type BaseClass() =
// Assign an ArgumentUsage attribute to the strArray parameter.
// Assign a ParamArray attribute to strList.
abstract member TestMethod: string [] * string[] -> unit
default _.TestMethod(
[<ArgumentUsage "Must pass an array here.">]
strArray,
[<ParamArray>]
strList) = ()
type DerivedClass() =
inherit BaseClass()
// Assign an ArgumentUsage attribute to the strList parameter.
// Assign a ParamArray attribute to strList.
override _.TestMethod(
strArray,
[<ArgumentUsage "Can pass a parameter list or array here."; ParamArray>]
strList) = ()
let displayParameterAttributes (mInfo: MethodInfo) (pInfoArray: ParameterInfo []) includeInherited =
printfn $"""
Parameter attribute information for method "{mInfo.Name}"
includes inheritance from base class: {if includeInherited then "Yes" else "No"}."""
// Display the attribute information for the parameters.
for paramInfo in pInfoArray do
// See if the ParamArray attribute is defined.
let isDef = Attribute.IsDefined(paramInfo, typeof<ParamArrayAttribute>)
if isDef then
printfn $"\n The ParamArray attribute is defined for \n parameter {paramInfo.Name} of method {mInfo.Name}."
// See if ParamUsageAttribute is defined.
// If so, display a message.
let usageAttr =
Attribute.GetCustomAttribute(paramInfo, typeof<ArgumentUsageAttribute>, includeInherited)
:?> ArgumentUsageAttribute
if usageAttr <> null then
printfn $"\n The ArgumentUsage attribute is defined for \n parameter {paramInfo.Name} of method {mInfo.Name}."
printfn $"\n The usage message for {paramInfo.Name} is:\n \"{usageAttr.Message}\"."
printfn "This example of Attribute.GetCustomAttribute(ParameterInfo, Type, Boolean)\ngenerates the following output."
// Get the class type, and then get the MethodInfo object
// for TestMethod to access its metadata.
let clsType = typeof<DerivedClass>
let mInfo = clsType.GetMethod "TestMethod"
// Iterate through the ParameterInfo array for the method parameters.
let pInfoArray = mInfo.GetParameters()
if pInfoArray <> null then
displayParameterAttributes mInfo pInfoArray false
displayParameterAttributes mInfo pInfoArray true
else
printfn $"The parameters information could not be retrieved for method {mInfo.Name}."
// This example of Attribute.GetCustomAttribute( ParameterInfo, Type, Boolean )
// generates the following output.
//
// Parameter attribute information for method "TestMethod"
// includes inheritance from base class: No.
//
// The ParamArray attribute is defined for
// parameter strList of method TestMethod.
//
// The ArgumentUsage attribute is defined for
// parameter strList of method TestMethod.
//
// The usage message for strList is:
// "Can pass a parameter list or array here.".
//
// Parameter attribute information for method "TestMethod"
// includes inheritance from base class: Yes.
//
// The ArgumentUsage attribute is defined for
// parameter strArray of method TestMethod.
//
// The usage message for strArray is:
// "Must pass an array here.".
//
// The ParamArray attribute is defined for
// parameter strList of method TestMethod.
//
// The ArgumentUsage attribute is defined for
// parameter strList of method TestMethod.
//
// The usage message for strList is:
// "Can pass a parameter list or array here.".
' Example for the Attribute.GetCustomAttribute( ParameterInfo, Type, Boolean )
' method.
Imports System.Reflection
Namespace NDP_UE_VB
' Define a custom parameter attribute that takes a single message argument.
<AttributeUsage(AttributeTargets.Parameter)> _
Public Class ArgumentUsageAttribute
Inherits Attribute
' This is the attribute constructor.
Public Sub New(UsageMsg As String)
Me.usageMsg = UsageMsg
End Sub
' usageMsg is storage for the attribute message.
Protected usageMsg As String
' This is the Message property for the attribute.
Public Property Message() As String
Get
Return usageMsg
End Get
Set
usageMsg = value
End Set
End Property
End Class
Public Class BaseClass
' Assign an ArgumentUsage attribute to the strArray parameter.
' Assign a ParamArray attribute to the strList parameter.
Public Overridable Sub TestMethod( _
<ArgumentUsage("Must pass an array here.")> _
strArray() As String, _
ParamArray strList() As String)
End Sub
End Class
Public Class DerivedClass
Inherits BaseClass
' Assign an ArgumentUsage attribute to the strList parameter.
' Assign a ParamArray attribute to the strList parameter.
Public Overrides Sub TestMethod( _
strArray() As String, _
<ArgumentUsage("Can pass a parameter list or array here.")> _
ParamArray strList() As String)
End Sub
End Class
Class DemoClass
Shared Sub DisplayParameterAttributes(mInfo As MethodInfo, _
pInfoArray() As ParameterInfo, includeInherited As Boolean)
Console.WriteLine( vbCrLf & _
"Parameter attribute information for method ""{0}""" & _
vbCrLf & "includes inheritance from the base class: {1}.", _
mInfo.Name, IIf(includeInherited, "Yes", "No"))
' Display attribute information for the parameters.
Dim paramInfo As ParameterInfo
For Each paramInfo In pInfoArray
' See if the ParamArray attribute is defined.
Dim isDef As Boolean = _
Attribute.IsDefined(paramInfo, GetType(ParamArrayAttribute))
If isDef Then
Console.WriteLine( vbCrLf & " The " & _
"ParamArray attribute is defined for " & _
vbCrLf & " parameter {0} of method {1}.", _
paramInfo.Name, mInfo.Name)
End If
' See if ParamUsageAttribute is defined.
' If so, display a message.
Dim usageAttr As ArgumentUsageAttribute = _
Attribute.GetCustomAttribute(paramInfo, _
GetType(ArgumentUsageAttribute), _
includeInherited)
If Not (usageAttr Is Nothing) Then
Console.WriteLine( vbCrLf & " The " & _
"ArgumentUsage attribute is defined for " & _
vbCrLf & " parameter {0} of method {1}.", _
paramInfo.Name, mInfo.Name)
Console.WriteLine( vbCrLf & _
" The usage message for {0} is: " & _
vbCrLf & " ""{1}"".", _
paramInfo.Name, usageAttr.Message)
End If
Next paramInfo
End Sub
Public Shared Sub Main()
Console.WriteLine( _
"This example of Attribute.GetCustomAttribute" & _
"( ParameterInfo, Type, Boolean )" & vbCrLf & _
"generates the following output." )
' Get the class type, and then get the MethodInfo object
' for TestMethod to access its metadata.
Dim clsType As Type = GetType(DerivedClass)
Dim mInfo As MethodInfo = clsType.GetMethod("TestMethod")
' Iterate through the ParameterInfo array for the method parameters.
Dim pInfoArray As ParameterInfo() = mInfo.GetParameters()
If Not (pInfoArray Is Nothing) Then
DisplayParameterAttributes(mInfo, pInfoArray, False)
DisplayParameterAttributes(mInfo, pInfoArray, True)
Else
Console.WriteLine( _
"The parameters information could " & _
"not be retrieved for method {0}.", mInfo.Name)
End If
End Sub
End Class
End Namespace ' NDP_UE_VB
' This example of Attribute.GetCustomAttribute( ParameterInfo, Type, Boolean )
' generates the following output.
'
' Parameter attribute information for method "TestMethod"
' includes inheritance from the base class: No.
'
' The ParamArray attribute is defined for
' parameter strList of method TestMethod.
'
' The ArgumentUsage attribute is defined for
' parameter strList of method TestMethod.
'
' The usage message for strList is:
' "Can pass a parameter list or array here.".
'
' Parameter attribute information for method "TestMethod"
' includes inheritance from the base class: Yes.
'
' The ArgumentUsage attribute is defined for
' parameter strArray of method TestMethod.
'
' The usage message for strArray is:
' "Must pass an array here.".
'
' The ParamArray attribute is defined for
' parameter strList of method TestMethod.
'
' The ArgumentUsage attribute is defined for
' parameter strList of method TestMethod.
'
' The usage message for strList is:
' "Can pass a parameter list or array here.".
If element represents a parameter in a method of a derived type, the return value includes the inheritable custom attributes applied to the same parameter in the overridden base methods.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4