AssemblyBuilder Classe

Definição

Fornece um contêiner para a criação de um assembly de um ou mais caminhos virtuais em um projeto do ASP.NET.Provides a container for building an assembly from one or more virtual paths within an ASP.NET project.

public ref class AssemblyBuilder
public class AssemblyBuilder
type AssemblyBuilder = class
Public Class AssemblyBuilder
Herança
AssemblyBuilder

Exemplos

O exemplo de código a seguir ilustra uma implementação de provedor de compilação simples, herdando da classe base abstrata BuildProvider.The following code example illustrates a simple build provider implementation, inheriting from the abstract BuildProvider base class. O provedor de compilação substitui os membros CodeCompilerType, GetGeneratedTypee GenerateCode da classe base.The build provider overrides the CodeCompilerType, GetGeneratedType, and GenerateCode members of the base class.

Na implementação do método GenerateCode, o provedor de compilação adiciona o código gerado para a compilação do assembly usando o método CreateCodeFile.In the GenerateCode method implementation, the build provider adds the generated code for the assembly compilation using the CreateCodeFile method. O exemplo não inclui a implementação da classe SampleClassGenerator.The example does not include the implementation of the SampleClassGenerator class. Para obter mais informações, consulte CodeCompileUnit.For more information, see 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

Comentários

As instâncias da classe AssemblyBuilder são usadas com BuildProvider métodos de classe para criar um ou mais arquivos em um assembly compilado.Instances of the AssemblyBuilder class are used with BuildProvider class methods to build one or more files into a compiled assembly.

A classe BuildProvider define a funcionalidade de compilação para arquivos individuais, e a classe AssemblyBuilder combina o código-fonte contribuído por cada instância BuildProvider em um único assembly.The BuildProvider class defines build functionality for individual files, and the AssemblyBuilder class combines the source code contributed by each BuildProvider instance into a single assembly. O ambiente de compilação ASP.NET passa um objeto AssemblyBuilder para os métodos BuildProvider ao criar um assembly de um ou mais arquivos, para que cada instância BuildProvider possa contribuir com o código-fonte de seu arquivo para o assembly geral.The ASP.NET build environment passes an AssemblyBuilder object to the BuildProvider methods when building an assembly from one or more files, so that each BuildProvider instance can contribute source code for its file to the overall assembly.

O ambiente de compilação ASP.NET determina o idioma e o compilador exigidos pelos arquivos dentro do projeto, com base na propriedade BuildProvider.CodeCompilerType.The ASP.NET build environment determines the language and compiler required by files within the project, based on the BuildProvider.CodeCompilerType property. O ambiente de compilação agrupa arquivos com base em suas configurações de compilador e cria um assembly a partir de arquivos que exigem o mesmo compilador.The build environment groups files based on their compiler settings and builds an assembly from files that require the same compiler.

A propriedade CodeDomProvider indica a implementação de CodeDomProvider que o ambiente de compilação ASP.NET usa para compilar um assembly a partir do código-fonte contribuído por cada implementação de BuildProvider.The CodeDomProvider property indicates the CodeDomProvider implementation that the ASP.NET build environment uses to compile an assembly from the source code contributed by each BuildProvider implementation.

Um objeto BuildProvider contribui com o código-fonte na forma de um grafo CodeDOM usando o método AddCodeCompileUnit.A BuildProvider object contributes source code in the form of a CodeDOM graph using the AddCodeCompileUnit method. Um objeto BuildProvider contribui com o código-fonte armazenado em um arquivo físico usando o método CreateCodeFile.A BuildProvider object contributes source code stored in a physical file using the CreateCodeFile method.

Depois que cada objeto de BuildProvider contribui com o código-fonte usando os métodos de AssemblyBuilder apropriados, o ambiente de compilação ASP.NET usa a classe AssemblyBuilder para compilar o código-fonte coletado em um assembly.After each BuildProvider object contributes source code using the appropriate AssemblyBuilder methods, the ASP.NET build environment uses the AssemblyBuilder class to compile the collected source code into an assembly.

Propriedades

CodeDomProvider

Obtém o compilador usado para compilar o código-fonte em um assembly.Gets the compiler used to build source code into an assembly.

Métodos

AddAssemblyReference(Assembly)

Adiciona um assembly que é referenciado pelo código-fonte gerado para um arquivo.Adds an assembly that is referenced by source code generated for a file.

AddCodeCompileUnit(BuildProvider, CodeCompileUnit)

Adiciona o código-fonte ao assembly na forma de um gráfico CodeDOM.Adds source code for the assembly in the form of a CodeDOM graph.

CreateCodeFile(BuildProvider)

Permite que um provedor de build crie um arquivo de origem temporário e inclua-o na compilação do assembly.Allows a build provider to create a temporary source file, and include the source file in the assembly compilation.

CreateEmbeddedResource(BuildProvider, String)

Permite que um provedor de build crie um arquivo de recurso para incluir na compilação do assembly.Allows a build provider to create a resource file to include in the assembly compilation.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GenerateTypeFactory(String)

Insere um modelo de alocador de objeto para um tipo no assembly compilado.Inserts a fast object factory template for a type into the compiled assembly.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetTempFilePhysicalPath(String)

Gera um caminho de arquivo temporário.Generates a temporary file path.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a

Veja também