AssemblyBuilder Třída

Reference

Definice

Obor názvů:: System.Web.Compilation

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje kontejner pro sestavení z jedné nebo více virtuálních cest v rámci projektu ASP.NET.

public ref class AssemblyBuilder

public class AssemblyBuilder

type AssemblyBuilder = class

Public Class AssemblyBuilder

Dědičnost: Object
AssemblyBuilder

Příklady

Následující příklad kódu znázorňuje jednoduchou implementaci zprostředkovatele sestavení, která dědí z abstraktní BuildProvider základní třídy. Zprostředkovatel sestavení přepíše CodeCompilerType GetGeneratedType, a GenerateCode členy základní třídy.

V implementaci GenerateCode metody zprostředkovatel sestavení přidá vygenerovaný kód pro kompilaci sestavení pomocí CreateCodeFile metody . Příklad nezahrnuje implementaci SampleClassGenerator třídy. Další informace naleznete v tématu CodeCompileUnit.

using System;
using System.Collections;
using System.IO;
using System.Text;
using System.Web;
using System.Web.Compilation;
using System.CodeDom.Compiler;
using System.CodeDom;
using System.Security;
using System.Security.Permissions;

// Define a simple build provider implementation.
[PermissionSet(SecurityAction.Demand, Unrestricted = true)]
public class SampleBuildProvider : BuildProvider
{
    // Define an internal member for the compiler type.
    protected CompilerType _compilerType = null;

    public SampleBuildProvider()
    {
        // Set the compiler to use Visual Basic.
        _compilerType = GetDefaultCompilerTypeForLanguage("C#");
    }

    // Return the internal CompilerType member 
    // defined in this implementation.
    public override CompilerType CodeCompilerType
    {
        get { return _compilerType; }
    }

    // Define a method that returns details for the 
    // code compiler for this build provider.
    public string GetCompilerTypeDetails()
    {
        StringBuilder details = new StringBuilder("");

        if (_compilerType != null)
        {
            // Format a string that contains the code compiler
            // implementation, and various compiler details.

            details.AppendFormat("CodeDomProvider type: {0}; \n",
                _compilerType.CodeDomProviderType.ToString());
            details.AppendFormat("Compiler debug build = {0}; \n",
                _compilerType.CompilerParameters.IncludeDebugInformation.ToString());
            details.AppendFormat("Compiler warning level = {0}; \n",
                _compilerType.CompilerParameters.WarningLevel.ToString());

            if (_compilerType.CompilerParameters.CompilerOptions != null)
            {
                details.AppendFormat("Compiler options: {0}; \n",
                    _compilerType.CompilerParameters.CompilerOptions.ToString());
            }
        }
        return details.ToString();
    }

    // Define the build provider implementation of the GenerateCode method.
    public override void GenerateCode(AssemblyBuilder assemBuilder)
    {
        // Generate a code compile unit, and add it to
        // the assembly builder.

        TextWriter tw = assemBuilder.CreateCodeFile(this);
        if (tw != null)
        {
            try
            {
                // Generate the code compile unit from the virtual path.
                CodeCompileUnit compileUnit = SampleClassGenerator.BuildCompileUnitFromPath(VirtualPath);

                // Generate the source for the code compile unit, 
                // and write it to a file specified by the assembly builder.
                CodeDomProvider provider = assemBuilder.CodeDomProvider;
                provider.CreateGenerator().GenerateCodeFromCompileUnit(compileUnit, tw, null);
            }
            finally
            {
                tw.Close();
            }
        }
    }

    public override System.Type GetGeneratedType(CompilerResults results)
    {
        string typeName = SampleClassGenerator.TypeName;

        return results.CompiledAssembly.GetType(typeName);
    }
}

Imports System.Collections
Imports System.IO
Imports System.Text
Imports System.Web
Imports System.Web.Compilation
Imports System.CodeDom.Compiler
Imports System.CodeDom
Imports System.Security
Imports System.Security.Permissions

<PermissionSet(SecurityAction.Demand, Unrestricted := true)> _
Public Class SampleBuildProvider
    Inherits BuildProvider

    Protected _compilerType As CompilerType = Nothing

    Public Sub New()
        _compilerType = GetDefaultCompilerType()
    End Sub

    ' Return the internal CompilerType member 
    ' defined in this implementation.
    Public Overrides ReadOnly Property CodeCompilerType() As CompilerType
        Get
            CodeCompilerType = _compilerType
        End Get
    End Property

    ' Define a method that returns details for the 
    ' code compiler for this build provider.
    Public Function GetCompilerTypeDetails() As String
        Dim details As StringBuilder = New StringBuilder("")

        If Not _compilerType Is Nothing Then
            ' Format a string that contains the code compiler
            ' implementation, and various compiler details.

            details.AppendFormat("CodeDomProvider type: {0}; ", _
                _compilerType.CodeDomProviderType.ToString())
            details.AppendFormat("Compiler debug build = {0}; ", _
                _compilerType.CompilerParameters.IncludeDebugInformation.ToString())
            details.AppendFormat("Compiler warning level = {0}; ", _
                _compilerType.CompilerParameters.WarningLevel.ToString())

            If Not _compilerType.CompilerParameters.CompilerOptions Is Nothing Then
                details.AppendFormat("Compiler options: {0}; ", _
                    _compilerType.CompilerParameters.CompilerOptions.ToString())
            End If
        End If
        Return details.ToString()
    End Function

    ' Define the build provider implementation of the GenerateCode method.
    Public Overrides Sub GenerateCode(ByVal assemBuilder As AssemblyBuilder)
        ' Generate a code compile unit, and add it to
        ' the assembly builder.

        Dim tw As TextWriter = assemBuilder.CreateCodeFile(Me)
        If Not tw Is Nothing Then
            Try
                ' Generate the code compile unit from the virtual path.
                Dim compileUnit As CodeCompileUnit = _
                        SampleClassGenerator.BuildCompileUnitFromPath(VirtualPath)

                ' Generate the source for the code compile unit, 
                ' and write it to a file specified by the assembly builder.
                Dim provider As CodeDomProvider = assemBuilder.CodeDomProvider
                provider.CreateGenerator().GenerateCodeFromCompileUnit(compileUnit, tw, Nothing)
            Finally
                tw.Close()
            End Try

        End If
    End Sub

    Public Overrides Function GetGeneratedType(ByVal results As CompilerResults) As System.Type
        Dim typeName As String = SampleClassGenerator.TypeName

        Return results.CompiledAssembly.GetType(typeName)
    End Function

End Class

Poznámky

AssemblyBuilder Instance třídy se používají s metodami BuildProvider třídy k sestavení jednoho nebo více souborů do zkompilovaného sestavení.

Třída BuildProvider definuje funkce sestavení pro jednotlivé soubory a AssemblyBuilder třída kombinuje zdrojový kód, který přispěla každá BuildProvider instance do jednoho sestavení. Prostředí ASP.NET sestavení předává AssemblyBuilder objekt BuildProvider metodám při sestavování sestavení z jednoho nebo více souborů, aby každá BuildProvider instance mohl přispívat zdrojovým kódem pro svůj soubor do celkového sestavení.

Prostředí ASP.NET sestavení určuje jazyk a kompilátor vyžadovaný soubory v rámci projektu na BuildProvider.CodeCompilerType základě vlastnosti. Prostředí sestavení seskupuje soubory na základě nastavení kompilátoru a sestaví sestavení ze souborů, které vyžadují stejný kompilátor.

Vlastnost CodeDomProvider označuje implementaci CodeDomProvider , kterou prostředí ASP.NET sestavení používá ke kompilaci sestavení ze zdrojového kódu, ke kterému přispěla každá BuildProvider implementace.

Objekt BuildProvider přispívá zdrojovým kódem ve formě grafu CodeDOM pomocí AddCodeCompileUnit metody . Objekt BuildProvider přispívá zdrojovým kódem uloženým ve fyzickém souboru pomocí CreateCodeFile metody .

Jakmile každý BuildProvider objekt přispívá zdrojovým kódem pomocí příslušných AssemblyBuilder metod, prostředí ASP.NET sestavení použije AssemblyBuilder třídu ke kompilaci shromážděného zdrojového kódu do sestavení.

Vlastnosti

CodeDomProvider

Získá kompilátor použitý k sestavení zdrojového kódu do sestavení.

Metody

AddAssemblyReference(Assembly)	Přidá sestavení, na které odkazuje zdrojový kód vygenerovaný pro soubor.
AddCodeCompileUnit(BuildProvider, CodeCompileUnit)	Přidá zdrojový kód pro sestavení ve formě grafu CodeDOM.
CreateCodeFile(BuildProvider)	Umožňuje poskytovateli sestavení vytvořit dočasný zdrojový soubor a zahrnout zdrojový soubor do kompilace sestavení.
CreateEmbeddedResource(BuildProvider, String)	Umožňuje poskytovateli sestavení vytvořit soubor prostředků, který se zahrne do kompilace sestavení.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GenerateTypeFactory(String)	Vloží rychlou šablonu objektu objektu pro typ do kompilovaného sestavení.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetTempFilePhysicalPath(String)	Vygeneruje dočasnou cestu k souboru.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Platí pro