LinkedResources Property

CompilerParameters.LinkedResources Property

Gets the .NET Framework resource files that are referenced in the current source.

Namespace: System.CodeDom.Compiler
Assembly: System (in system.dll)

public StringCollection LinkedResources { get; }
/** @property */
public StringCollection get_LinkedResources ()

public function get LinkedResources () : StringCollection

Not applicable.

Property Value

A StringCollection containing the file paths of .NET Framework resources that are referenced by the source.

Linked resource files allow your assembly to reference .NET Framework resources without embedding the actual resources in the assembly. Referencing files through this property is similar to the /linkresource command-line argument supported by many of the .NET Framework compilers.

Not all compilers support .NET Framework resource files, so you should test for this support by calling the Supports method with the flag Resources.

Add one or more .NET Framework resource file paths to the returned StringCollection to create links for the resources in the compiled assembly. Adding a duplicate or invalid file path results in compilation errors; ensure that each string specifies a unique path to a valid .NET Framework resource file.

Use LinkedResources to reference .NET Framework resources in satellite assemblies, localized for a particular culture; use the EmbeddedResources property to embed the resources into the compiled assembly.

The following example illustrates using CompilerParameters to specify various compiler settings and options.

public static bool CompileCode(CodeDomProvider provider, 
    String sourceFile, 
    String exeFile)

    CompilerParameters cp = new CompilerParameters();

    // Generate an executable instead of 
    // a class library.
    cp.GenerateExecutable = true;

    // Set the assembly file name to generate.
    cp.OutputAssembly = exeFile;

    // Generate debug information.
    cp.IncludeDebugInformation = true;

    // Add an assembly reference.
    cp.ReferencedAssemblies.Add( "System.dll" );

    // Save the assembly as a physical file.
    cp.GenerateInMemory = false;

    // Set the level at which the compiler 
    // should start displaying warnings.
    cp.WarningLevel = 3;

    // Set whether to treat all warnings as errors.
    cp.TreatWarningsAsErrors = false;
    // Set compiler argument to optimize output.
    cp.CompilerOptions = "/optimize";

    // Set a temporary files collection.
    // The TempFileCollection stores the temporary files
    // generated during a build in the current directory,
    // and does not delete them after compilation.
    cp.TempFiles = new TempFileCollection(".", true);

    if (provider.Supports(GeneratorSupport.EntryPointMethod))
        // Specify the class that contains 
        // the main method of the executable.
        cp.MainClass = "Samples.Class1";
    if (provider.Supports(GeneratorSupport.Resources))
        // Set the embedded resource file of the assembly.
        // This is useful for culture-neutral resources, 
        // or default (fallback) resources.

        // Set the linked resource reference files of the assembly.
        // These resources are included in separate assembly files,
        // typically localized for a specific language and culture.

    // Invoke compilation.
    CompilerResults cr = provider.CompileAssemblyFromFile(cp, sourceFile);

    if(cr.Errors.Count > 0)
        // Display compilation errors.
        Console.WriteLine("Errors building {0} into {1}",  
            sourceFile, cr.PathToAssembly);
        foreach(CompilerError ce in cr.Errors)
            Console.WriteLine("  {0}", ce.ToString());
        Console.WriteLine("Source {0} built into {1} successfully.",
            sourceFile, cr.PathToAssembly);
        Console.WriteLine("{0} temporary files created during the compilation.",

    // Return the results of compilation.
    if (cr.Errors.Count > 0)
        return false;
        return true;

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

© 2015 Microsoft