CompilerParameters.EmbeddedResources Proprietà

Definizione

Ottiene i file di risorse .NET da includere durante la compilazione dell'output dell'assembly.

public System.Collections.Specialized.StringCollection EmbeddedResources { get; }
[System.Runtime.InteropServices.ComVisible(false)]
public System.Collections.Specialized.StringCollection EmbeddedResources { get; }

Valore della proprietà

Raccolta che contiene i percorsi di file delle risorse .NET da includere nell'assembly generato.

Attributi

Esempio

L'esempio seguente illustra l'uso CompilerParameters di per specificare varie impostazioni e opzioni del compilatore. Questo esempio di codice fa parte di un esempio più grande fornito per la CompilerParameters classe.

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 (Directory.Exists("Resources"))
    {
        if (provider.Supports(GeneratorSupport.Resources))
        {
            // Set the embedded resource file of the assembly.
            // This is useful for culture-neutral resources,
            // or default (fallback) resources.
            cp.EmbeddedResources.Add("Resources\\Default.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.
            cp.LinkedResources.Add("Resources\\nb-no.resources");
        }
    }

    // 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();
        }
    }
    else
    {
        Console.WriteLine("Source {0} built into {1} successfully.",
            sourceFile, cr.PathToAssembly);
        Console.WriteLine("{0} temporary files created during the compilation.",
            cp.TempFiles.Count.ToString());
    }

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

Commenti

Le risorse incorporate vengono incorporate nel file di output dell'assembly generato. L'inclusione di file tramite questa proprietà è simile all'argomento della /resource riga di comando supportato da molti compilatori .NET.

Non tutti i compilatori supportano i file di risorse .NET, quindi è consigliabile testare il supporto chiamando il metodo con il Supports flag Resources.

Aggiungere uno o più percorsi di file di risorse .NET al restituito StringCollection per incorporare le risorse file nell'assembly compilato. L'aggiunta di un percorso di file duplicato o non valido comporta errori di compilazione; assicurarsi che ogni stringa specifica un percorso univoco di un file di risorse .NET valido.

Usare per includere le risorse .NET predefinite o neutrali per un assembly. Utilizzare EmbeddedResources la LinkedResources proprietà per fare riferimento alle risorse .NET negli assembly satellite.

Si applica a

Prodotto Versioni
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Vedi anche