BuildProvider Clase

Definición

public ref class BuildProvider abstract

public abstract class BuildProvider

type BuildProvider = class

Public MustInherit Class BuildProvider

Herencia

Object

BuildProvider

Derivado

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

Más…

Ejemplos

En el ejemplo de código siguiente se muestra una implementación sencilla del proveedor de compilación, que hereda de la clase base abstracta BuildProvider . El proveedor de compilación invalida los CodeCompilerTypemiembros , GetGeneratedTypey GenerateCode de la clase base. En el ejemplo no se incluye la implementación de la SampleClassGenerator clase . Para obtener más información, consulte la información general de la CodeCompileUnit clase.

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

Comentarios

El entorno de compilación ASP.NET usa BuildProvider objetos para generar código fuente para distintos tipos de archivo dentro de una aplicación. Las clases derivadas de BuildProvider proporcionan principalmente código fuente para archivos, páginas web, recursos y otros elementos personalizados.

Normalmente, no se crea una instancia de la BuildProvider clase directamente. En su lugar, implementa una clase que deriva de BuildProvidery configura la BuildProvider implementación para su uso en el entorno de compilación de ASP.NET.

Las instancias de la BuildProvider clase se usan con AssemblyBuilder objetos para compilar uno o varios archivos en un ensamblado compilado. Una BuildProvider instancia genera código fuente en el idioma adecuado para los archivos individuales y el AssemblyBuilder objeto combina el origen aportado por cada BuildProvider instancia en un único ensamblado.

El entorno de compilación ASP.NET usa instancias de la BuildProvider clase para compilar archivos dentro de una aplicación. La VirtualPath propiedad de la BuildProvider clase indica la ruta de acceso del archivo que se va a compilar. La extensión de archivo de cada archivo dentro de una aplicación se asigna a un proveedor de compilación correspondiente. El entorno de compilación ASP.NET inicializa una BuildProvider instancia para cada archivo en función de la extensión de archivo y usa los BuildProvider métodos para generar código fuente para el archivo. El entorno de compilación ASP.NET pasa un AssemblyBuilder objeto basado en el lenguaje del compilador preferido y el contexto del archivo a los BuildProvider métodos al compilar un ensamblado a partir de uno o varios archivos, de modo que la BuildProvider instancia pueda contribuir con código fuente para su archivo al ensamblado general.

Para definir acciones de compilación personalizadas para un tipo de archivo dentro de una aplicación de ASP.NET, debe derivar una clase de , implementar miembros dentro de BuildProviderla clase derivada para compilar el tipo de archivo y configurar el proveedor de compilación para la extensión de archivo correspondiente dentro del archivo de configuración de la aplicación.

El add elemento especifica la extensión de archivo para los archivos admitidos y si el proveedor de compilación admite archivos de código, archivos web, archivos de recursos o todos los archivos. Use el type atributo para especificar el nombre de tipo completo de la implementación del proveedor de compilación. Use la BuildProviderAppliesToAttribute clase para especificar si el proveedor de compilación se aplica a los archivos del directorio App_Code, a los archivos de un directorio de contenido web, a los recursos globales o locales, o a todos los archivos. Use el extension atributo para especificar la extensión de archivo utilizada para identificar los archivos que admite la BuildProvider clase . Use la BuildProviderCollection clase para examinar los proveedores de compilación en un archivo de configuración. Para obtener más información sobre cómo configurar un proveedor de compilación, vea buildProviders Element for compilation (ASP.NET Configuración Schema) (Elemento buildProviders para compilación [esquema de ASP.NET Configuración]).

Para implementar un proveedor de compilación que genera código fuente para un tipo de archivo personalizado, derive una clase de BuildProvidere invalide el método para generar código GenerateCode fuente para el tipo de archivo admitido. El origen generado se agrega al AssemblyBuilder objeto en forma de un gráfico CodeDOM o como contenido que representa un archivo de código fuente físico. Si el proveedor de compilación requiere un lenguaje de programación específico, invalide la CodeCompilerType propiedad para devolver un CompilerType objeto para el lenguaje de programación admitido. Si el proveedor de compilación no requiere un lenguaje de programación específico, no invalide la CodeCompilerType propiedad ; use la implementación de clase base, que indica que el proveedor de compilación puede usar cualquier lenguaje de .NET Framework, como Visual Basic o C#.

Para implementar un proveedor de compilación que genera código fuente para el contenido web, derive una clase de BuildProvider e invalide el GetGeneratedType método para devolver para Type la clase generada por BuildProvider. Invalide el GenerateCode método para generar código fuente para el tipo proporcionado por el archivo admitido.

Constructores

Propiedades

Métodos

Se aplica a

Consulte también

• CompilerType
• ClientBuildManager
• AssemblyBuilder
• BuildProvider