BuildProvider 클래스

참조

정의

네임스페이스:: System.Web.Compilation

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

ASP.NET 빌드 환경에서 소스 코드를 생성하기 위한 속성 및 메서드 집합을 정의합니다. 이 클래스는 추상 클래스입니다.

public ref class BuildProvider abstract

public abstract class BuildProvider

type BuildProvider = class

Public MustInherit Class BuildProvider

상속: Object
BuildProvider

파생: System.Data.Entity.Design.AspNet.EntityDesignerBuildProvider

System.Data.Entity.Design.AspNet.EntityModelBuildProvider

System.Data.Entity.Design.AspNet.MappingModelBuildProvider

System.Data.Entity.Design.AspNet.StorageModelBuildProvider

System.Data.Services.BuildProvider.DataServiceBuildProvider

자세히…

예제

다음 코드 예제에서는 추상에서 상속 하는 간단한 빌드 공급자 구현 BuildProvider 기본 클래스입니다. 빌드 공급자를 재정의 합니다 CodeCompilerType, GetGeneratedType, 및 GenerateCode 기본 클래스의 멤버입니다. 예제 구현의 포함 되지 않습니다는 SampleClassGenerator 클래스입니다. 자세한 내용은 참조는 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()
    {
        _compilerType = GetDefaultCompilerTypeForLanguage("C#");
    }

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

    // 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.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 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.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

설명

ASP.NET 빌드 환경에서는 BuildProvider 애플리케이션 내에서 다른 파일 형식에 대 한 소스 코드를 생성 하는 개체입니다. 주로 파생 BuildProvider 된 클래스는 파일, 웹 페이지, 리소스 및 기타 사용자 지정 항목에 대한 소스 코드를 제공합니다.

일반적으로 만들지 않도록의 인스턴스는 BuildProvider 클래스를 직접. 대신 파생되는 클래스 BuildProvider를 구현하고 ASP.NET 빌드 환경 내에서 사용할 구현을 구성 BuildProvider 합니다.

클래스의 BuildProvider 인스턴스는 컴파일된 어셈블리에 하나 이상의 파일을 빌드하기 위해 개체와 함께 AssemblyBuilder 사용됩니다. 인스턴스는 BuildProvider 개별 파일에 대해 적절한 언어로 소스 코드를 생성하고 개체는 AssemblyBuilder 각 BuildProvider 인스턴스에서 제공하는 원본을 단일 어셈블리로 결합합니다.

인스턴스를 사용 하는 ASP.NET 빌드 환경의 BuildProvider 클래스는 애플리케이션 내에서 파일을 빌드할 수 있습니다. 클래스의 BuildProvider 속성은 VirtualPath 빌드할 파일의 경로를 나타냅니다. 애플리케이션 내의 각 파일의 파일 확장명을 해당 하는 빌드 공급자에 매핑됩니다. ASP.NET 빌드 환경에서는 파일 확장자를 기반으로 각 파일에 대한 인스턴스를 초기화 BuildProvider 하고 메서드를 BuildProvider 사용하여 파일에 대한 소스 코드를 생성합니다. ASP.NET 빌드 환경은 기본 컴파일러 언어 및 파일의 컨텍스트를 기반으로 개체를 하나 이상의 파일에서 어셈블리를 빌드할 BuildProvider 때 메서드에 전달 AssemblyBuilder 하므로 BuildProvider 인스턴스가 파일의 소스 코드를 전체 어셈블리에 기여할 수 있습니다.

ASP.NET 애플리케이션에서 특정 파일 형식에 대 한 사용자 지정 빌드 작업을 정의 하려면 클래스에서 파생 해야 BuildProvider파일 형식을 작성 하기 위한 파생된 된 클래스 내에서 멤버를 구현 하 고 해당 파일 확장명에 대 한 빌드 공급자를 구성 합니다. 애플리케이션 구성 파일입니다.

이 add 요소는 지원되는 파일에 대한 파일 확장명과 빌드 공급자가 코드 파일, 웹 파일, 리소스 파일 또는 모든 파일을 지원하는지 여부를 지정합니다. 특성을 type 사용하여 빌드 공급자 구현의 정규화된 형식 이름을 지정합니다. 이 클래스를 BuildProviderAppliesToAttribute 사용하여 빌드 공급자가 App_Code 디렉터리의 파일, 웹 콘텐츠 디렉터리의 파일, 전역 또는 로컬 리소스 또는 모든 파일에 적용되는지 여부를 지정합니다. 특성을 사용하여 클래스가 extension 지원하는 파일을 식별하는 데 사용되는 파일 BuildProvider 확장자를 지정합니다. 클래스를 BuildProviderCollection 사용하여 구성 파일에서 빌드 공급자를 검사합니다. 빌드 공급자를 구성하는 방법에 대한 자세한 내용은 컴파일을 위한 buildProviders 요소(ASP.NET 설정 스키마)를 참조하세요.

사용자 지정 파일 형식에 대한 소스 코드를 생성하는 빌드 공급자를 구현하려면 클래스를 BuildProvider파생시키고 메서드를 재정의 GenerateCode 하여 지원되는 파일 형식에 대한 소스 코드를 생성합니다. 생성된 소스는 CodeDOM 그래프 형식 또는 물리적 소스 코드 파일을 나타내는 콘텐츠로 개체에 추가 AssemblyBuilder 됩니다. 빌드 공급자에 특정 프로그래밍 언어가 필요한 경우 지원되는 프로그래밍 언어에 대한 개체를 CompilerType 반환하도록 속성을 재정 CodeCompilerType 의합니다. 빌드 공급자에 특정 프로그래밍 언어가 필요하지 않은 경우 속성을 재정의 CodeCompilerType 하지 마세요. 빌드 공급자가 Visual Basic 또는 C#과 같은 .NET Framework 언어를 사용할 수 있음을 나타내는 기본 클래스 구현을 사용합니다.

웹 콘텐츠에 대한 소스 코드를 생성하는 빌드 공급자를 구현하려면 클래스를 파생시키고 메서드를 BuildProvider 재정의 GetGeneratedType Type 하여 생성된 BuildProvider클래스에 대해 반환합니다. 지원되는 파일에서 GenerateCode 제공하는 형식에 대한 소스 코드를 생성하도록 메서드를 재정의합니다.

참고

사용자 지정 추가 BuildProvider Web.config 파일에는 클래스는 ASP.NET 웹 사이트에서 작동 하지만 ASP.NET 웹 애플리케이션 프로젝트에서 작동 하지 않습니다. 웹 애플리케이션 프로젝트에 의해 생성 되는 코드는 BuildProvider 클래스는 애플리케이션에 포함할 수 없습니다. 자세한 내용은 ASP.NET 웹 애플리케이션 프로젝트 미리 컴파일 개요합니다.

생성자

BuildProvider()

BuildProvider 클래스의 새 인스턴스를 초기화합니다.

속성

CodeCompilerType	빌드 공급자가 사용자 지정 파일 형식용 소스 코드를 생성하기 위해 사용하는 컴파일러 형식을 나타냅니다.
ReferencedAssemblies	빌드 공급자에서 생성한 소스 코드로 컴파일할 어셈블리를 나타냅니다.
VirtualPath	구현된 빌드 공급자를 사용하여 빌드할 파일을 나타냅니다.
VirtualPathDependencies	빌드 공급자가 코드를 생성하기 전에 빌드해야 할 가상 경로 컬렉션을 나타냅니다.

메서드

Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GenerateCode(AssemblyBuilder)	빌드 공급자의 가상 경로에 대해 소스 코드를 생성하고 이 소스 코드를 지정된 어셈블리 빌더에 추가합니다.
GetCodeCompileUnit(IDictionary)	생성된 CodeDOM 그래프의 컨테이너를 나타냅니다.
GetCustomString(CompilerResults)	컴파일된 어셈블리에 유지할 문자열을 생성합니다.
GetDefaultCompilerType()	애플리케이션의 기본 언어에 사용되는 컴파일러 설정을 반환합니다.
GetDefaultCompilerTypeForLanguage(String)	지정된 언어에 따라 빌드 공급자의 컴파일러 설정을 반환합니다.
GetGeneratedType(CompilerResults)	가상 경로에 대해 빌드 공급자가 생성한 형식을 반환합니다.
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetResultFlags(CompilerResults)	가상 경로를 빌드할 때 수행할 작업을 나타내는 값을 반환합니다.
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
OpenReader()	현재 빌드 공급자 개체의 가상 경로에서 읽는 데 사용할 텍스트 판독기를 엽니다.
OpenReader(String)	지정된 가상 경로에서 읽는 데 사용할 텍스트 판독기를 엽니다.
OpenStream()	현재 빌드 공급자 개체의 가상 경로를 읽는 데 사용할 스트림을 엽니다.
OpenStream(String)	지정된 가상 경로에서 읽기 위한 스트림을 엽니다.
ProcessCompileErrors(CompilerResults)	파생된 클래스를 재정의하면 컴파일러 오류 메시지를 검토하고 수정하여 추가 정보를 제공할 수 있습니다.
RegisterBuildProvider(String, Type)	빌드 공급자를 등록합니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

적용 대상

BuildProvider 클래스

정의

예제

설명

생성자

속성

메서드

적용 대상

추가 정보

추가 리소스