CompilerParameters.EmbeddedResources Vlastnost

Definice

Obor názvů:

System.CodeDom.Compiler

Sestavení:

System.CodeDom.dll

Balíček:

System.CodeDom v8.0.0

Zdroj:

CompilerParameters.cs

Získá soubory prostředků .NET, které mají být zahrnuty při kompilaci výstupu sestavení.

public System.Collections.Specialized.StringCollection EmbeddedResources { get; }

Hodnota vlastnosti

StringCollection

Kolekce, která obsahuje cesty k souborům prostředků .NET, které mají být zahrnuty do vygenerovaného sestavení.

Příklady

Následující příklad ukazuje použití k CompilerParameters určení různých nastavení a možností kompilátoru. Tento příklad kódu je součástí většího příkladu CompilerParameters pro třídu .

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;
    }
}

Poznámky

Vložené prostředky jsou integrovány do vygenerovaného výstupního souboru sestavení. Zahrnutí souborů prostřednictvím této vlastnosti se podobá argumentu příkazového /resource řádku podporovanému mnoha kompilátory .NET.

Ne všechny kompilátory podporují soubory prostředků .NET, proto byste měli tuto podporu otestovat voláním Supports metody s příznakem Resources.

Přidejte jednu nebo více cest k souborům prostředků .NET k vráceným StringCollection prostředkům, aby se prostředky souboru vložily do zkompilovaného sestavení. Přidání duplicitní nebo neplatné cesty k souboru vede k chybám kompilace; Ujistěte se, že každý řetězec určuje jedinečnou cestu k platnému souboru prostředků .NET.

Umožňuje EmbeddedResources zahrnout prostředky .NET výchozí nebo neutrální jazykové verze pro sestavení. Vlastnost slouží LinkedResources k odkazování na prostředky .NET v satelitních sestaveních.

Platí pro

Viz také

• GeneratorSupport
• LinkedResources
• Win32Resource