ParameterInfo.GetCustomAttributes メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このパラメーターに適用されているカスタム属性を取得します。
オーバーロード
GetCustomAttributes(Type, Boolean) |
このパラメーターに適用されている、指定された型またはその派生型のカスタム属性を取得します。 |
GetCustomAttributes(Boolean) |
このパラメーターに定義されているすべてのカスタム属性を取得します。 |
GetCustomAttributes(Type, Boolean)
- ソース:
- ParameterInfo.cs
- ソース:
- ParameterInfo.cs
- ソース:
- ParameterInfo.cs
このパラメーターに適用されている、指定された型またはその派生型のカスタム属性を取得します。
public:
virtual cli::array <System::Object ^> ^ GetCustomAttributes(Type ^ attributeType, bool inherit);
public virtual object[] GetCustomAttributes (Type attributeType, bool inherit);
abstract member GetCustomAttributes : Type * bool -> obj[]
override this.GetCustomAttributes : Type * bool -> obj[]
Public Overridable Function GetCustomAttributes (attributeType As Type, inherit As Boolean) As Object()
パラメーター
- attributeType
- Type
型により識別されるカスタム属性。
- inherit
- Boolean
この型のオブジェクトでは、この引数は無視されます。
戻り値
指定された型またはその派生型のカスタム属性が格納されている配列。
実装
例外
型は、基になるランタイム システムで提供されている型でなければなりません。
attributeType
が null
です。
カスタム属性の型を読み込むことができませんでした。
注釈
このメソッドは、 パラメーターを inherit
無視します。 継承チェーンでパラメーターの属性を検索するには、 メソッドの適切なオーバーロードを Attribute.GetCustomAttributes 使用します。
適用対象
GetCustomAttributes(Boolean)
- ソース:
- ParameterInfo.cs
- ソース:
- ParameterInfo.cs
- ソース:
- ParameterInfo.cs
このパラメーターに定義されているすべてのカスタム属性を取得します。
public:
virtual cli::array <System::Object ^> ^ GetCustomAttributes(bool inherit);
public virtual object[] GetCustomAttributes (bool inherit);
abstract member GetCustomAttributes : bool -> obj[]
override this.GetCustomAttributes : bool -> obj[]
Public Overridable Function GetCustomAttributes (inherit As Boolean) As Object()
パラメーター
- inherit
- Boolean
この型のオブジェクトでは、この引数は無視されます。
戻り値
このパラメーターに適用されているすべてのカスタム属性が格納されている配列。
実装
例外
カスタム属性の型を読み込むことができませんでした。
例
次の例は、メソッドのパラメーターに適用されているカスタム属性を実行時に取得する方法を示しています。 この例では、 という名前 MyAttribute
のカスタム属性を定義し、パラメーターに適用できます。 次に、 という名前のクラスを という名前MyClass
MyMethod
のメソッドで定義し、 メソッドのパラメーターに適用しますMyAttribute
。
この例を実行すると、 メソッドを GetCustomAttributes(Boolean) 使用して、 内のすべてのメソッド MyClass
のすべてのパラメーターに適用されているカスタム属性を取得し、コンソールに表示します。
using namespace System;
using namespace System::Reflection;
// Define a custom attribute with one named parameter.
[AttributeUsage(AttributeTargets::Parameter)]
public ref class MyAttribute: public Attribute
{
private:
String^ myName;
public:
MyAttribute( String^ name )
{
myName = name;
}
property String^ Name
{
String^ get()
{
return myName;
}
}
};
// Define a class which has a custom attribute associated with one of the
// parameters of a method.
public ref class MyClass1
{
public:
void MyMethod(
[MyAttribute("This is an example parameter attribute")]
int i ) {}
};
void main()
{
// Get the type of the class 'MyClass1'.
Type^ myType = MyClass1::typeid;
// Get the members associated with the class 'MyClass1'.
array<MethodInfo^>^myMethods = myType->GetMethods();
// Display the attributes for each of the parameters of each method of the class 'MyClass1'.
for ( int i = 0; i < myMethods->Length; i++ )
{
// Get the parameters for the method.
array<ParameterInfo^>^myParameters = myMethods[ i ]->GetParameters();
if ( myParameters->Length > 0 )
{
Console::WriteLine( "\nThe parameters for the method \"{0}\" that have custom attributes are:", myMethods[ i ] );
for ( int j = 0; j < myParameters->Length; j++ )
{
// Get the attributes of type 'MyAttribute' for each parameter.
array<Object^>^myAttributes = myParameters[ j ]->GetCustomAttributes( MyAttribute::typeid, false );
if ( myAttributes->Length > 0 )
{
Console::WriteLine( "Parameter {0}, name = {1}, type = {2} has attributes:",
myParameters[ j ]->Position,
myParameters[ j ]->Name,
myParameters[ j ]->ParameterType );
for ( int k = 0; k < myAttributes->Length; k++ )
{
Console::WriteLine( "\t{0}", myAttributes[ k ] );
}
}
}
}
}
}
/* This code example produces the following output:
The parameters for the method Void MyMethod(Int32) that have custom attributes are :
Parameter 0, name = i, type = System.Int32 has attributes:
MyAttribute
The parameters for the method Boolean Equals(System.Object) that have custom attributes are :
*/
using System;
using System.Reflection;
// Define a custom attribute with one named parameter.
[AttributeUsage(AttributeTargets.Parameter)]
public class MyAttribute : Attribute
{
private string myName;
public MyAttribute(string name)
{
myName = name;
}
public string Name
{
get
{
return myName;
}
}
}
// Define a class which has a custom attribute associated with one of the
// parameters of a method.
public class MyClass1
{
public void MyMethod(
[MyAttribute("This is an example parameter attribute")]
int i)
{
return;
}
}
public class MemberInfo_GetCustomAttributes
{
public static void Main()
{
// Get the type of the class 'MyClass1'.
Type myType = typeof(MyClass1);
// Get the members associated with the class 'MyClass1'.
MethodInfo[] myMethods = myType.GetMethods();
// Display the attributes for each of the parameters of each method of the class 'MyClass1'.
for(int i = 0; i < myMethods.Length; i++)
{
// Get the parameters for the method.
ParameterInfo[] myParameters = myMethods[i].GetParameters();
if (myParameters.Length > 0)
{
Console.WriteLine("\nThe parameters for the method {0} that have custom attributes are :", myMethods[i]);
for(int j = 0; j < myParameters.Length; j++)
{
// Get the attributes of type 'MyAttribute' for each parameter.
Object[] myAttributes = myParameters[j].GetCustomAttributes(typeof(MyAttribute), false);
if (myAttributes.Length > 0)
{
Console.WriteLine("Parameter {0}, name = {1}, type = {2} has attributes: ",
myParameters[j].Position, myParameters[j].Name, myParameters[j].ParameterType);
for(int k = 0; k < myAttributes.Length; k++)
{
Console.WriteLine("\t{0}", myAttributes[k]);
}
}
}
}
}
}
}
/* This code example produces the following output:
The parameters for the method Void MyMethod(Int32) that have custom attributes are :
Parameter 0, name = i, type = System.Int32 has attributes:
MyAttribute
The parameters for the method Boolean Equals(System.Object) that have custom attributes are :
*/
Imports System.Reflection
' Define a custom attribute with one named parameter.
<AttributeUsage(AttributeTargets.Parameter)> Public Class MyAttribute
Inherits Attribute
Private myName As String
Public Sub New(ByVal name As String)
myName = name
End Sub
Public ReadOnly Property Name() As String
Get
Return myName
End Get
End Property
End Class
' Define a class which has a custom attribute associated with one of
' the parameters of a method.
Public Class MyClass1
Public Sub MyMethod( _
<MyAttribute("This is an example parameter attribute")> _
ByVal i As Integer _
)
Return
End Sub
End Class
Public Class MemberInfo_GetCustomAttributes
Public Shared Sub Main()
' Get the type of the class 'MyClass1'.
Dim myType As Type = GetType(MyClass1)
' Get the members associated with the class 'MyClass1'.
Dim myMethods As MethodInfo() = myType.GetMethods()
' Display the attributes for each of the parameters of each method of the class 'MyClass1'.
For i As Integer = 0 To myMethods.Length - 1
' Get the parameters for the method.
Dim myParameters As ParameterInfo() = myMethods(i).GetParameters()
If myParameters.Length > 0 Then
Console.WriteLine(vbCrLf & "The parameters for the method {0} that have custom attributes are : ", myMethods(i))
For j As Integer = 0 To myParameters.Length - 1
' Get the attributes of type 'MyAttribute' for each parameter.
Dim myAttributes As Object() = myParameters(j).GetCustomAttributes(GetType(MyAttribute), False)
If myAttributes.Length > 0 Then
Console.WriteLine("Parameter {0}, name = {1}, type = {2} has attributes: ", _
myParameters(j).Position, myParameters(j).Name, myParameters(j).ParameterType)
For k As Integer = 0 To myAttributes.Length - 1
Console.WriteLine(vbTab & "{0}", myAttributes(k))
Next k
End If
Next j
End If
Next i
End Sub
End Class
' This code example produces the following output:
'
'The parameters for the method Void MyMethod(Int32) that have custom attributes are :
'Parameter 0, name = i, type = System.Int32 has attributes:
' MyAttribute
'
'The parameters for the method Boolean Equals(System.Object) that have custom attributes are :
注釈
このメソッドは、 パラメーターを inherit
無視します。 継承チェーンでパラメーターの属性を検索するには、 メソッドの適切なオーバーロードを Attribute.GetCustomAttributes 使用します。
適用対象
.NET