/resource (Embed Resource File to Output) (C# Compiler Options)

Embeds the specified resource into the output file.

/resource:filename[,identifier[,accessibility-modifier]]

Arguments

  • filename
    The .NET Framework resource file that you want to embed in the output file.

  • identifier (optional)
    The logical name for the resource; the name that is used to load the resource. The default is the name of the file name.

  • accessibility-modifier (optional)
    The accessibility of the resource: public or private. The default is public.

Remarks

Use /linkresource to link a resource to an assembly and not add the resource file to the output file.

By default, resources are public in the assembly when they are created by using the C# compiler. To make the resources private, specify private as the accessibility modifier. No other accessibility other than public or private is allowed.

If filename is a .NET Framework resource file created, for example, by Resgen.exe or in the development environment, it can be accessed with members in the System.Resources namespace. For more information, see System.Resources.ResourceManager. For all other resources, use the GetManifestResource* methods in the Assembly class to access the resource at run time.

/res is the short form of /resource.

The order of the resources in the output file is determined from the order specified on the command line.

To set this compiler option in the Visual Studio development environment

  1. Add a resource file to your project.

  2. Select the file that you want to embed in Solution Explorer.

  3. Select Build Action for the file in the Properties window.

  4. Set Build Action to Embedded Resource.

For information about how to set this compiler option programmatically, see BuildAction.

Example

Compile in.cs and attach resource file rf.resource:

csc /resource:rf.resource in.cs

See Also

Other Resources

C# Compiler Options

Project Properties (Visual Studio)