AssemblyBuilder Classe

Définition

Espace de noms:: System.Web.Compilation

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit un conteneur pour la création d’un assembly à partir d’un ou plusieurs chemins virtuels au sein d’un projet ASP.NET.

public ref class AssemblyBuilder

public class AssemblyBuilder

type AssemblyBuilder = class

Public Class AssemblyBuilder

Héritage: Object
AssemblyBuilder

Exemples

L’exemple de code suivant illustre une implémentation de fournisseur de build simple, héritée de la classe de base abstraite BuildProvider . Le fournisseur de build remplace le CodeCompilerType, GetGeneratedTypeet GenerateCode les membres de la classe de base.

Dans l’implémentation de la GenerateCode méthode, le fournisseur de build ajoute le code généré pour la compilation d’assembly à l’aide de la CreateCodeFile méthode. L’exemple n’inclut pas l’implémentation de la SampleClassGenerator classe. Pour plus d’informations, consultez 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

Remarques

Les instances de la AssemblyBuilder classe sont utilisées avec BuildProvider des méthodes de classe pour générer un ou plusieurs fichiers dans un assembly compilé.

La BuildProvider classe définit la fonctionnalité de génération pour les fichiers individuels, et la AssemblyBuilder classe combine le code source fourni par chaque BuildProvider instance dans un seul assembly. L’environnement de génération ASP.NET transmet un AssemblyBuilder objet aux méthodes lors de la BuildProvider génération d’un assembly à partir d’un ou de plusieurs fichiers, afin que chaque BuildProvider instance puisse contribuer au code source de son fichier à l’assembly global.

L’environnement de génération ASP.NET détermine le langage et le compilateur requis par les fichiers du projet, en fonction de la BuildProvider.CodeCompilerType propriété. L’environnement de génération regroupe les fichiers en fonction de leurs paramètres du compilateur et génère un assembly à partir de fichiers qui nécessitent le même compilateur.

La CodeDomProvider propriété indique l’implémentation utilisée par l’environnement CodeDomProvider de génération ASP.NET pour compiler un assembly à partir du code source fourni par chaque BuildProvider implémentation.

Un BuildProvider objet contribue au code source sous la forme d’un graphique CodeDOM à l’aide de la AddCodeCompileUnit méthode. Un BuildProvider objet contribue au code source stocké dans un fichier physique à l’aide de la CreateCodeFile méthode.

Une fois que chaque BuildProvider objet a contribué au code source à l’aide des méthodes appropriées AssemblyBuilder , l’environnement de génération ASP.NET utilise la AssemblyBuilder classe pour compiler le code source collecté dans un assembly.

Propriétés

Nom	Description
CodeDomProvider	Obtient le compilateur utilisé pour générer du code source dans un assembly.

Méthodes

Nom	Description
AddAssemblyReference(Assembly)	Ajoute un assembly référencé par le code source généré pour un fichier.
AddCodeCompileUnit(BuildProvider, CodeCompileUnit)	Ajoute le code source de l’assembly sous la forme d’un graphe CodeDOM.
CreateCodeFile(BuildProvider)	Permet à un fournisseur de build de créer un fichier source temporaire et d’inclure le fichier source dans la compilation d’assembly.
CreateEmbeddedResource(BuildProvider, String)	Permet à un fournisseur de build de créer un fichier de ressources à inclure dans la compilation d’assembly.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GenerateTypeFactory(String)	Insère un modèle de fabrique d’objets rapide pour un type dans l’assembly compilé.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetTempFilePhysicalPath(String)	Génère un chemin d’accès de fichier temporaire.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?