![Applying Attributes
Syntax: Use square brackets to specify an attribute
To apply multiple attributes to an element, you can:
Specify multiple attributes in separate square brackets
Use a single square bracket and separate attributes with
commas
For some elements such as assemblies, specify the element
name associated with the attribute explicitly
[attribute(positional_parameters,named_parameter=value, ...)]
element](https://image.slidesharecdn.com/15attributes-190506070246/85/Module-15-attributes-5-320.jpg)
![Using the Conditional Attribute
Serves as a debugging tool
Causes conditional compilation of method calls,
depending on the value of a programmer-defined symbol
Does not cause conditional compilation of the method
itself
Restrictions on methods
Must have return type of void
Must not be declared as override
Must not be from an inherited interface
using System.Diagnostics;
...
class MyClass
{
[Conditional ("DEBUGGING")]
public static void MyMethod( )
{
...
}
}](https://image.slidesharecdn.com/15attributes-190506070246/85/Module-15-attributes-7-320.jpg)
![Using the DllImport Attribute
With the DllImport attribute, you can:
Invoke unmanaged code in DLLs from a C# environment
Tag an external method to show that it resides in an
unmanaged DLL
using System.Runtime.InteropServices;
...
public class MyClass( )
{
[DllImport("MyDLL.dll", EntryPoint="MyFunction")]
public static extern int MyFunction(string param1);
...
int result = MyFunction("Hello Unmanaged Code");
...
}](https://image.slidesharecdn.com/15attributes-190506070246/85/Module-15-attributes-8-320.jpg)
![Using the Transaction Attribute
To manage transactions in COM+
Specify that your component be included when a
transaction commit is requested
Use a Transaction attribute on the class that implements the
component
using System.EnterpriseServices;
...
[Transaction(TransactionOption.Required)]
public class MyTransactionalComponent
{
...
}](https://image.slidesharecdn.com/15attributes-190506070246/85/Module-15-attributes-9-320.jpg)
![Defining Custom Attribute Scope
Use the AttributeUsage tag to define scope
Example
Use the bitwise “or” operator (|) to specify multiple
elements
Example
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct)]
public class MyAttribute: System.Attribute
{ ... }
[AttributeUsage(AttributeTargets.Method)]
public class MyAttribute: System.Attribute
{ ... }](https://image.slidesharecdn.com/15attributes-190506070246/85/Module-15-attributes-11-320.jpg)
![Querying for Attribute Information
To retrieve attribute information:
Use GetCustomAttributes to retrieve all attribute
information as an array
Iterate through the array and examine the values of each
element in the array
Use the IsDefined method to determine whether a
particular attribute has been defined for a class
System.Reflection.MemberInfo typeInfo;
typeInfo = typeof(MyClass);
object[ ] attrs = typeInfo.GetCustomAttributes(false);](https://image.slidesharecdn.com/15attributes-190506070246/85/Module-15-attributes-17-320.jpg)
Module 15 attributes
- 1. Attributes
- 2. Overview Overview of Attributes Defining Custom Attributes Retrieving Attribute Values
- 3. Overview of Attributes Introduction to Attributes Applying Attributes Common Predefined Attributes Using the Conditional Attribute Using the DllImport Attribute Using the Transaction Attribute
- 4. Introduction to Attributes Attributes are: Declarative tags that convey information to the runtime Stored with the metadata of the element .NET Framework provides predefined attributes The runtime contains code to examine values of attributes and act on them
- 5. Applying Attributes Syntax: Use square brackets to specify an attribute To apply multiple attributes to an element, you can: Specify multiple attributes in separate square brackets Use a single square bracket and separate attributes with commas For some elements such as assemblies, specify the element name associated with the attribute explicitly [attribute(positional_parameters,named_parameter=value, ...)] element
- 6. Common Predefined Attributes .NET provides many predefined attributes General attributes COM interoperability attributes Transaction handling attributes Visual designer component building attributes
- 7. Using the Conditional Attribute Serves as a debugging tool Causes conditional compilation of method calls, depending on the value of a programmer-defined symbol Does not cause conditional compilation of the method itself Restrictions on methods Must have return type of void Must not be declared as override Must not be from an inherited interface using System.Diagnostics; ... class MyClass { [Conditional ("DEBUGGING")] public static void MyMethod( ) { ... } }
- 8. Using the DllImport Attribute With the DllImport attribute, you can: Invoke unmanaged code in DLLs from a C# environment Tag an external method to show that it resides in an unmanaged DLL using System.Runtime.InteropServices; ... public class MyClass( ) { [DllImport("MyDLL.dll", EntryPoint="MyFunction")] public static extern int MyFunction(string param1); ... int result = MyFunction("Hello Unmanaged Code"); ... }
- 9. Using the Transaction Attribute To manage transactions in COM+ Specify that your component be included when a transaction commit is requested Use a Transaction attribute on the class that implements the component using System.EnterpriseServices; ... [Transaction(TransactionOption.Required)] public class MyTransactionalComponent { ... }
- 10. Defining Custom Attributes Defining Custom Attribute Scope Defining an Attribute Class Processing a Custom Attribute Using Multiple Attributes
- 11. Defining Custom Attribute Scope Use the AttributeUsage tag to define scope Example Use the bitwise “or” operator (|) to specify multiple elements Example [AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct)] public class MyAttribute: System.Attribute { ... } [AttributeUsage(AttributeTargets.Method)] public class MyAttribute: System.Attribute { ... }
- 12. Defining an Attribute Class Deriving an attribute class All attribute classes must derive from System.Attribute, directly or indirectly Suffix name of attribute class with “Attribute” Components of an attribute class Define a single constructor for each attribute class by using a positional parameter Use properties to set an optional value by using a named parameter
- 13. Processing a Custom Attribute The Compilation Process 1. Searches for the attribute class 2. Checks the scope of the attribute 3. Checks for a constructor in the attribute 4. Creates an instance of the object 5. Checks for a named parameter 6. Sets field or property to named parameter value 7. Saves current state of attribute class
- 14. Using Multiple Attributes An element can have more than one attribute Define both attributes separately An element can have more than one instance of the same attribute Use AllowMultiple = true
- 15. Retrieving Attribute Values Examining Class Metadata Querying for Attribute Information
- 16. Examining Class Metadata To query class metadata information: Use the MemberInfo class in System.Reflection Populate a MemberInfo object by using System.Type Create a System.Type object by using the typeof operator Example System.Reflection.MemberInfo typeInfo; typeInfo = typeof(MyClass);
- 17. Querying for Attribute Information To retrieve attribute information: Use GetCustomAttributes to retrieve all attribute information as an array Iterate through the array and examine the values of each element in the array Use the IsDefined method to determine whether a particular attribute has been defined for a class System.Reflection.MemberInfo typeInfo; typeInfo = typeof(MyClass); object[ ] attrs = typeInfo.GetCustomAttributes(false);
- 18. Review Overview of Attributes Defining Custom Attributes Retrieving Attribute Values