AssemblyBuilder Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.Compilation

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

bir ASP.NET projesi içindeki bir veya daha fazla sanal yoldan derleme oluşturmak için bir kapsayıcı sağlar.

public ref class AssemblyBuilder

public class AssemblyBuilder

type AssemblyBuilder = class

Public Class AssemblyBuilder

Devralma: Object
AssemblyBuilder

Örnekler

Aşağıdaki kod örneği, soyut BuildProvider temel sınıftan devralan basit bir derleme sağlayıcısı uygulamasını gösterir. Derleme sağlayıcısı, temel sınıfın CodeCompilerType, GetGeneratedTypeve GenerateCode üyelerini geçersiz kılar.

GenerateCode Yöntem uygulamasında, derleme sağlayıcısı yöntemini kullanarak CreateCodeFile derleme derlemesi için oluşturulan kodu ekler. Örnek, sınıfın SampleClassGenerator uygulamasını içermez. Daha fazla bilgi için bkz. 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

Açıklamalar

Sınıfının örnekleri AssemblyBuilder , derlenmiş bir derlemede bir veya daha fazla dosya oluşturmak için sınıf yöntemleriyle BuildProvider birlikte kullanılır.

sınıfı BuildProvider , tek tek dosyalar için derleme işlevselliğini tanımlar ve AssemblyBuilder sınıfı her BuildProvider örneğin katkıda bulunduğu kaynak kodunu tek bir derlemede birleştirir. ASP.NET derleme ortamı, bir AssemblyBuilder veya daha fazla dosyadan derleme oluştururken bir nesneyi BuildProvider yöntemlere geçirir, böylece her BuildProvider örnek dosyasının kaynak kodunu genel derlemeye katkıda bulunabilir.

ASP.NET derleme ortamı, özelliğine göre projedeki dosyalar için gereken dili ve derleyiciyi BuildProvider.CodeCompilerType belirler. Derleme ortamı, dosyaları derleyici ayarlarına göre gruplandırıyor ve aynı derleyiciyi gerektiren dosyalardan bir derleme oluşturuyor.

özelliği, CodeDomProvider ASP.NET derleme ortamının her BuildProvider uygulamanın katkıda bulunduğu kaynak koddan bir derleme derlemek için kullandığı uygulamayı gösterirCodeDomProvider.

Bir BuildProvider nesne, yöntemini kullanarak codeDOM grafı biçiminde kaynak kodu katkıda bulunur AddCodeCompileUnit . Nesnesi BuildProvider , yöntemini kullanarak fiziksel bir dosyada depolanan kaynak koduna katkıda bulunur CreateCodeFile .

Her BuildProvider nesne uygun AssemblyBuilder yöntemleri kullanarak kaynak koduna katkıda bulunduktan sonra, ASP.NET derleme ortamı toplanan kaynak kodunu derlemek için sınıfını kullanırAssemblyBuilder.

Özellikler

CodeDomProvider

Bir derlemede kaynak kodu oluşturmak için kullanılan derleyiciyi alır.

Yöntemler

AddAssemblyReference(Assembly)	Bir dosya için oluşturulan kaynak kodu tarafından başvuruda bulunılan bir derleme ekler.
AddCodeCompileUnit(BuildProvider, CodeCompileUnit)	Derleme için codeDOM grafı biçiminde kaynak kodu ekler.
CreateCodeFile(BuildProvider)	Derleme sağlayıcısının geçici bir kaynak dosya oluşturmasına ve kaynak dosyayı derleme derlemesine eklemesine izin verir.
CreateEmbeddedResource(BuildProvider, String)	Derleme sağlayıcısının derleme derlemesine dahil etmek üzere bir kaynak dosyası oluşturmasına izin verir.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GenerateTypeFactory(String)	Derlenen derlemeye bir tür için hızlı nesne fabrikası şablonu ekler.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetTempFilePhysicalPath(String)	Geçici bir dosya yolu oluşturur.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Şunlara uygulanır

Aracılığıyla paylaş