This documentation is archived and is not being maintained.
Attribute::GetCustomAttribute Method (Module, Type)
Visual Studio 2010
Retrieves a custom attribute applied to a module. Parameters specify the module, and the type of the custom attribute to search for.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- element
- Type: System.Reflection::Module
An object derived from the Module class that describes a portable executable file.
- attributeType
- Type: System::Type
The type, or a base type, of the custom attribute to search for.
Return Value
Type: System::AttributeA reference to the single custom attribute of type attributeType that is applied to element, or nullptr if there is no such attribute.
| Exception | Condition |
|---|---|
| ArgumentNullException | element or attributeType is nullptr. |
| ArgumentException | attributeType is not derived from Attribute. |
| AmbiguousMatchException | More than one of the requested attributes was found. |
The following code example illustrates the use of the GetCustomAttribute method taking a Module as a parameter.
using namespace System; using namespace System::Diagnostics; // Add the Debuggable attribute to the module. [module:Debuggable(true,false)]; namespace IsDef2CS { ref class DemoClass { public: static void Main() { // Get the class type to access its metadata. Type^ clsType = DemoClass::typeid; // See if the Debuggable attribute is defined for this module. bool isDef = Attribute::IsDefined( clsType->Module, DebuggableAttribute::typeid ); // Display the result. Console::WriteLine( "The Debuggable attribute {0} " "defined for Module {1}.", isDef ? (String^)"is" : "is not", clsType->Module->Name ); // If the attribute is defined, display the JIT settings. if ( isDef ) { // Retrieve the attribute itself. DebuggableAttribute^ dbgAttr = dynamic_cast<DebuggableAttribute^>(Attribute::GetCustomAttribute( clsType->Module, DebuggableAttribute::typeid )); if ( dbgAttr != nullptr ) { Console::WriteLine( "JITTrackingEnabled is {0}.", dbgAttr->IsJITTrackingEnabled ); Console::WriteLine( "JITOptimizerDisabled is {0}.", dbgAttr->IsJITOptimizerDisabled ); } else Console::WriteLine( "The Debuggable attribute " "could not be retrieved." ); } } }; } /* * Output: * The Debuggable attribute is defined for Module IsDef2CS.exe. * JITTrackingEnabled is True. * JITOptimizerDisabled is False. */
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: