Introducing Managed Resources

Embedding resources in .NET allows for data to be packaged together with your code in an assembly. Resources are normally specified at design time and then embedded by the compiler during build time.

PostSharp's AssemblyLevelAspect adds additional flexibility by allowing you to programmatically add resources at compile time. In doing so, you can add logic, and therefore flexibility, in determining which resources are embedded and how. For example, you could use this feature to encrypt a resource just before embedding it into your assembly.

Introducing resources

In the following example, we create an assembly decorator that retrieves the name of the user who runs the build, and then stores that information in the current assembly as a resource. The example then shows that this information can be retrieved from the assembly at run time.

Start by creating a class called AddBuildInfoAspect that derives from AssemblyLevelAspect. Also implement IAspectProvider, which exposes the ProvideAspects(object) method. The ProvideAspects(object) method will be called once by PostSharp, providing access to assembly information and allowing for a resource to be programmatically added to the assembly:
Full screen
```
public sealed class AddBuildInfoAspect : AssemblyLevelAspect, IAspectProvider
{
    public IEnumerable<AspectInstance> ProvideAspects(object targetElement)
    {
    }
}
```

Implement the ProvideAspects(object) method:

Full screen

public sealed class AddBuildInfoAspect : AssemblyLevelAspect, IAspectProvider
{
    public IEnumerable<AspectInstance> ProvideAspects(object targetElement)
    {
        Assembly assembly = (Assembly)targetElement;

        byte[] userNameData = Encoding.ASCII.GetBytes(
           assembly.FullName + " was compiled by: " + Environment.UserName);
        ManagedResourceIntroductionAspect mria2 = new ManagedResourceIntroductionAspect("BuildUser", userNameData);

        yield return new AspectInstance(assembly, mria2);
    }
}

In this example, the targetElement object passed in is cast to an Assembly object from which the assembly name is retrieved. The code then gets the current user name, concatenates it with the assembly name, and then converts this string to a byte array. The byte array is then stored along with a name for the data in PostSharp's ManagedResourceIntroductionAspect object, and returned via an AspectInstance. PostSharp then embeds the resource into the current assembly.

Open the AssemblyInfo.cs file of your project and add a line to include the AddBuildInfoAspect class:
Full screen
```
[assembly:AddBuildInfoAspect]
```

With this code in place, the assembly will now embed the user name as a resource into itself during compilation.

The following code demonstrates how to retrieve the data at run time:

Full screen

class Program
{
    static void Main(string[] args)
    {
        Assembly a = Assembly.GetExecutingAssembly();
        Stream stream = a.GetManifestResourceStream("BuildUser");

        byte[] bytesRead = new byte[stream.Length];
        stream.Read(bytesRead, 0, (int)stream.Length);
        string value = Encoding.ASCII.GetString(bytesRead);
        Console.WriteLine(value);
    }
}

This will display the following line in the console window:

Introducing resources

See Also