BuildProviderCollection Clase

Definición

Espacio de nombres:: System.Web.Configuration

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa una colección de BuildProvider objetos. Esta clase no puede heredarse.

public ref class BuildProviderCollection sealed : System::Configuration::ConfigurationElementCollection

[System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.BuildProvider))]
public sealed class BuildProviderCollection : System.Configuration.ConfigurationElementCollection

[<System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.BuildProvider))>]
type BuildProviderCollection = class
    inherit ConfigurationElementCollection

Public NotInheritable Class BuildProviderCollection
Inherits ConfigurationElementCollection

Herencia: Object

ConfigurationElement

ConfigurationElementCollection
BuildProviderCollection

Atributos: ConfigurationCollectionAttribute

Ejemplos

En esta sección se proporcionan dos ejemplos de código. En la primera se muestra cómo especificar de forma declarativa valores para varias propiedades de la BuildProviderCollection clase . En el segundo se muestra cómo usar miembros de la BuildProviderCollection clase .

En el siguiente ejemplo de archivo de configuración se muestra cómo especificar de forma declarativa valores para varias propiedades de la BuildProviderCollection clase .

<system.web>
  <compilation>
    <buildProviders>
      <add extension=".aspx"
        type="System.Web.Compilation.PageBuildProvider"
         />
      <add extension=".ascx"
        type="System.Web.Compilation.UserControlBuildProvider"
         />
      <add extension=".master"
        type="System.Web.Compilation.MasterPageBuildProvider"
         />
      <add extension=".asix"
        type="System.Web.Compilation.ImageGeneratorBuildProvider"
         />
      <add extension=".asmx"
        type="System.Web.Compilation.WebServiceBuildProvider"
         />
      <add extension=".ashx"
        type="System.Web.Compilation.WebHandlerBuildProvider"
         />
      <add extension=".soap"
        type="System.Web.Compilation.WebServiceBuildProvider"
         />
      <add extension=".resx"
        type="System.Web.Compilation.ResXBuildProvider"
        appliesTo="Resources" />
      <add extension=".resources"
        type="System.Web.Compilation.ResourcesBuildProvider"
        appliesTo="Code, Resources" />
      <add extension=".wsdl"
        type="System.Web.Compilation.WsdlBuildProvider"
        appliesTo="Code" />
      <add extension=".xsd"
        type="System.Web.Compilation.XsdBuildProvider"
        appliesTo="Code" />
    </buildProviders>
  </compilation>
</system.web>

En el ejemplo de código siguiente se muestra cómo usar miembros de la BuildProviderCollection clase .

#region Using directives

using System;
using System.Configuration;
using System.Web.Configuration;

#endregion

namespace Samples.Aspnet.SystemWebConfiguration
{
  class UsingBuildProviderCollection
  {
    static void Main(string[] args)
    {
      try
      {
        // Set the path of the config file.
        string configPath = "";

        // Get the Web application configuration object.
        Configuration config =
          WebConfigurationManager.OpenWebConfiguration(configPath);

        // Get the section related object.
        CompilationSection configSection =
          (CompilationSection)config.GetSection
          ("system.web/compilation");

        // Display title and info.
        Console.WriteLine("ASP.NET Configuration Info");
        Console.WriteLine();

        // Display Config details.
        Console.WriteLine("File Path: {0}",
          config.FilePath);
        Console.WriteLine("Section Path: {0}",
          configSection.SectionInformation.Name);

        // Display BuildProviderCollection count.
        Console.WriteLine("BuildProviderCollection count: {0}",
          configSection.BuildProviders.Count);

        // Create a new BuildProvider.
        BuildProvider myBuildProvider =
          new BuildProvider(".myres",
          "System.Web.Compilation.ResourcesBuildProvider");

        // Add an BuildProvider to the collection.
        configSection.BuildProviders.Add(myBuildProvider);

        // Create a second BuildProvider.
        BuildProvider myBuildProvider2 =
          new BuildProvider(".myres2",
          "System.Web.Compilation.ResourcesBuildProvider");

        // Add an BuildProvider to the collection.
        configSection.BuildProviders.Add(myBuildProvider2);

        // BuildProvider Collection
        int i = 1;
        int j = 1;
        foreach (BuildProvider BuildProviderItem in
          configSection.BuildProviders)
        {
          Console.WriteLine();
          Console.WriteLine("BuildProviders {0} Details:", i);
          Console.WriteLine("Type: {0}",
            BuildProviderItem.ElementInformation.Type);
          Console.WriteLine("Source: {0}",
            BuildProviderItem.ElementInformation.Source);
          Console.WriteLine("LineNumber: {0}",
            BuildProviderItem.ElementInformation.LineNumber);
          Console.WriteLine("Properties Count: {0}",
            BuildProviderItem.ElementInformation.Properties.Count);
          j = 1;
          foreach (PropertyInformation propertyItem in
            BuildProviderItem.ElementInformation.Properties)
          {
            Console.WriteLine("Property {0} Name: {1}", j,
              propertyItem.Name);
            Console.WriteLine("Property {0} Value: {1}", j,
              propertyItem.Value);
            j++;
          }
          i++;
        }

        // Remove a BuildProvider.
        configSection.BuildProviders.Remove(".myres2");

        // Remove an BuildProvider.
        configSection.BuildProviders.RemoveAt(
          configSection.BuildProviders.Count - 1);

        // Update if not locked.
        if (!configSection.SectionInformation.IsLocked)
        {
          config.Save();
          Console.WriteLine("** Configuration updated.");
        }
        else
        {
          Console.WriteLine("** Could not update, section is locked.");
        }
      }

      catch (Exception e)
      {
        // Unknown error.
        Console.WriteLine(e.ToString());
      }

      // Display and wait.
      Console.ReadLine();
    }
  }
}

Imports System.Configuration
Imports System.Web.Configuration

Namespace Samples.Aspnet.SystemWebConfiguration
  Class UsingBuildProviderCollection
    Public Shared Sub Main()
      Try
        ' Set the path of the config file.
        Dim configPath As String = ""

        ' Get the Web application configuration object.
        Dim config As System.Configuration.Configuration = _
         WebConfigurationManager.OpenWebConfiguration(configPath)

        ' Get the section related object.
        Dim configSection As _
         System.Web.Configuration.CompilationSection = _
         CType(config.GetSection("system.web/compilation"), _
         System.Web.Configuration.CompilationSection)

        ' Display title and info.
        Console.WriteLine("ASP.NET Configuration Info")
        Console.WriteLine()

        ' Display Config details.
        Console.WriteLine("File Path: {0}", _
         config.FilePath)
        Console.WriteLine("Section Path: {0}", _
         configSection.SectionInformation.Name)

        ' Display BuildProviderCollection count.
        Console.WriteLine("BuildProviderCollection count: {0}", _
          configSection.BuildProviders.Count)

        ' Create a new BuildProvider.
        Dim myBuildProvider As BuildProvider = _
          New BuildProvider(".myres", _
          "System.Web.Compilation.ResourcesBuildProvider")

        ' Add an BuildProvider to the collection.
        configSection.BuildProviders.Add(myBuildProvider)

        ' Create a second BuildProvider.
        Dim myBuildProvider2 As BuildProvider = _
          New BuildProvider(".myres2", _
          "System.Web.Compilation.ResourcesBuildProvider")

        ' Add an BuildProvider to the collection.
        configSection.BuildProviders.Add(myBuildProvider2)

        ' BuildProvider Collection
        Dim i = 1
        Dim j = 1
        For Each BuildProviderItem As _
          BuildProvider In configSection.BuildProviders
          Console.WriteLine()
          Console.WriteLine("BuildProvider {0} Details:", i)
          Console.WriteLine("Type: {0}", _
            BuildProviderItem.ElementInformation.Type)
          Console.WriteLine("Source: {0}", _
            BuildProviderItem.ElementInformation.Source)
          Console.WriteLine("LineNumber: {0}", _
            BuildProviderItem.ElementInformation.LineNumber)
          Console.WriteLine("Properties Count: {0}", _
            BuildProviderItem.ElementInformation.Properties.Count)
          j = 1
          For Each propertyItem As PropertyInformation In _
            BuildProviderItem.ElementInformation.Properties
            Console.WriteLine("Property {0} Name: {1}", j, _
              propertyItem.Name)
            Console.WriteLine("Property {0} Value: {1}", j, _
              propertyItem.Value)
            j = j + 1
          Next
          i = i + 1
        Next

        ' Remove an BuildProvider.
        configSection.BuildProviders.Remove(".myres2")

        ' Remove an BuildProvider.
        configSection.BuildProviders.RemoveAt( _
          configSection.BuildProviders.Count - 1)

        ' Update if not locked.
        If Not configSection.SectionInformation.IsLocked Then
          config.Save()
          Console.WriteLine("** Configuration updated.")
        Else
          Console.WriteLine("** Could not update, section is locked.")
        End If

      Catch e As Exception
        ' Unknown error.
        Console.WriteLine(e.ToString())
      End Try

      ' Display and wait
      Console.ReadLine()
    End Sub
  End Class
End Namespace

Comentarios

BuildProviderCollection se usa para compilar archivos de recursos personalizados. Puede tener cualquier número de proveedores de compilación. No BuildProviderCollection hace referencia a ningún elemento real en el archivo de configuración subyacente. Es una construcción que permite un acceso sencillo a la información de compilación que contiene.

Constructores

Nombre	Description
BuildProviderCollection()	Inicializa una nueva instancia de la clase BuildProviderCollection.

Propiedades

Nombre	Description
AddElementName	Obtiene o establece el nombre del ConfigurationElement objeto que se va a asociar a la operación de adición en cuando ConfigurationElementCollection se invalida en una clase derivada. (Heredado de ConfigurationElementCollection)
ClearElementName	Obtiene o establece el nombre del objeto que ConfigurationElement se va a asociar a la operación clear en cuando ConfigurationElementCollection se invalida en una clase derivada. (Heredado de ConfigurationElementCollection)
CollectionType	Obtiene el tipo de ConfigurationElementCollection. (Heredado de ConfigurationElementCollection)
Count	Obtiene el número de elementos de la colección. (Heredado de ConfigurationElementCollection)
CurrentConfiguration	Obtiene una referencia a la instancia de nivel Configuration superior que representa la jerarquía de configuración a la que pertenece la instancia actual ConfigurationElement . (Heredado de ConfigurationElement)
ElementInformation	Obtiene un ElementInformation objeto que contiene la información y la funcionalidad no personalizables del ConfigurationElement objeto . (Heredado de ConfigurationElement)
ElementName	Obtiene el nombre usado para identificar esta colección de elementos en el archivo de configuración cuando se reemplaza en una clase derivada. (Heredado de ConfigurationElementCollection)
ElementProperty	Obtiene el ConfigurationElementProperty objeto que representa el ConfigurationElement propio objeto. (Heredado de ConfigurationElement)
EmitClear	Obtiene o establece un valor que especifica si se ha borrado la colección. (Heredado de ConfigurationElementCollection)
EvaluationContext	Obtiene el objeto ContextInformation para el objeto ConfigurationElement. (Heredado de ConfigurationElement)
HasContext	Obtiene un valor que indica si la CurrentConfiguration propiedad es `null`. (Heredado de ConfigurationElement)
IsSynchronized	Obtiene un valor que indica si se sincroniza el acceso a la colección. (Heredado de ConfigurationElementCollection)
Item[ConfigurationProperty]	Obtiene o establece una propiedad o atributo de este elemento de configuración. (Heredado de ConfigurationElement)
Item[Int32]	Obtiene el BuildProvider objeto en el índice especificado de la colección.
Item[String]	Obtiene el BuildProvider elemento de colección basado en el nombre especificado.
LockAllAttributesExcept	Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement)
LockAllElementsExcept	Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement)
LockAttributes	Obtiene la colección de atributos bloqueados. (Heredado de ConfigurationElement)
LockElements	Obtiene la colección de elementos bloqueados. (Heredado de ConfigurationElement)
LockItem	Obtiene o establece un valor que indica si el elemento está bloqueado. (Heredado de ConfigurationElement)
Properties	Obtiene la colección de propiedades. (Heredado de ConfigurationElement)
RemoveElementName	Obtiene o establece el nombre del ConfigurationElement objeto que se va a asociar a la operación remove en cuando ConfigurationElementCollection se reemplaza en una clase derivada. (Heredado de ConfigurationElementCollection)
SyncRoot	Obtiene un objeto utilizado para sincronizar el acceso a .ConfigurationElementCollection (Heredado de ConfigurationElementCollection)
ThrowOnDuplicate	Obtiene un valor que indica si un intento de agregar un duplicado ConfigurationElement a ConfigurationElementCollection hará que se produzca una excepción. (Heredado de ConfigurationElementCollection)

Métodos

Nombre	Description
Add(BuildProvider)	Agrega un BuildProvider objeto a .BuildProviderCollection
BaseAdd(ConfigurationElement, Boolean)	Agrega un elemento de configuración a la colección de elementos de configuración. (Heredado de ConfigurationElementCollection)
BaseAdd(ConfigurationElement)	Agrega un elemento de configuración a .ConfigurationElementCollection (Heredado de ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Agrega un elemento de configuración a la colección de elementos de configuración. (Heredado de ConfigurationElementCollection)
BaseClear()	Quita todos los objetos de elemento de configuración de la colección. (Heredado de ConfigurationElementCollection)
BaseGet(Int32)	Obtiene el elemento de configuración en la ubicación de índice especificada. (Heredado de ConfigurationElementCollection)
BaseGet(Object)	Devuelve el elemento de configuración con la clave especificada. (Heredado de ConfigurationElementCollection)
BaseGetAllKeys()	Devuelve una matriz de las claves para todos los elementos de configuración contenidos en .ConfigurationElementCollection (Heredado de ConfigurationElementCollection)
BaseGetKey(Int32)	Obtiene la clave de en ConfigurationElement la ubicación de índice especificada. (Heredado de ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Indica el índice del especificado ConfigurationElement. (Heredado de ConfigurationElementCollection)
BaseIsRemoved(Object)	Indica si el ConfigurationElement objeto con la clave especificada se ha quitado de .ConfigurationElementCollection (Heredado de ConfigurationElementCollection)
BaseRemove(Object)	Quita un ConfigurationElement elemento de la colección. (Heredado de ConfigurationElementCollection)
BaseRemoveAt(Int32)	Quita en ConfigurationElement la ubicación de índice especificada. (Heredado de ConfigurationElementCollection)
Clear()	Borra todos los BuildProvider objetos de .BuildProviderCollection
CopyTo(ConfigurationElement[], Int32)	Copia el contenido de en ConfigurationElementCollection una matriz. (Heredado de ConfigurationElementCollection)
CreateNewElement()	Cuando se reemplaza en una clase derivada, crea un nuevo ConfigurationElement. (Heredado de ConfigurationElementCollection)
CreateNewElement(String)	Crea un nuevo ConfigurationElement cuando se invalida en una clase derivada. (Heredado de ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Lee XML del archivo de configuración. (Heredado de ConfigurationElement)
Equals(Object)	Compara con ConfigurationElementCollection el objeto especificado. (Heredado de ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Obtiene la clave de elemento de un elemento de configuración especificado cuando se reemplaza en una clase derivada. (Heredado de ConfigurationElementCollection)
GetEnumerator()	Obtiene un IEnumerator objeto que se usa para recorrer en iteración .ConfigurationElementCollection (Heredado de ConfigurationElementCollection)
GetHashCode()	Obtiene un valor único que representa la ConfigurationElementCollection instancia. (Heredado de ConfigurationElementCollection)
GetTransformedAssemblyString(String)	Devuelve la versión transformada del nombre de ensamblado especificado. (Heredado de ConfigurationElement)
GetTransformedTypeString(String)	Devuelve la versión transformada del nombre de tipo especificado. (Heredado de ConfigurationElement)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Init()	Establece el ConfigurationElement objeto en su estado inicial. (Heredado de ConfigurationElement)
InitializeDefault()	Se usa para inicializar un conjunto predeterminado de valores para el ConfigurationElement objeto . (Heredado de ConfigurationElement)
IsElementName(String)	Indica si el especificado ConfigurationElement existe en .ConfigurationElementCollection (Heredado de ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Indica si el objeto especificado ConfigurationElement se puede quitar de .ConfigurationElementCollection (Heredado de ConfigurationElementCollection)
IsModified()	Indica si ConfigurationElementCollection se ha modificado desde que se guardó o cargó por última vez cuando se invalidó en una clase derivada. (Heredado de ConfigurationElementCollection)
IsReadOnly()	Indica si el ConfigurationElementCollection objeto es de solo lectura. (Heredado de ConfigurationElementCollection)
ListErrors(IList)	Agrega los errores de propiedad no válida en este ConfigurationElement objeto y, en todos los subelementos, a la lista pasada. (Heredado de ConfigurationElement)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtiene un valor que indica si se encuentra un atributo desconocido durante la deserialización. (Heredado de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Hace que el sistema de configuración produzca una excepción. (Heredado de ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	Produce una excepción cuando no se encuentra una propiedad necesaria. (Heredado de ConfigurationElement)
PostDeserialize()	Se llama después de la deserialización. (Heredado de ConfigurationElement)
PreSerialize(XmlWriter)	Se llama antes de la serialización. (Heredado de ConfigurationElement)
Remove(String)	Quita un BuildProvider objeto de .BuildProviderCollection
RemoveAt(Int32)	Quita el BuildProvider objeto en el índice especificado de .BuildProviderCollection
Reset(ConfigurationElement)	Restablece a ConfigurationElementCollection su estado sin modificar cuando se invalida en una clase derivada. (Heredado de ConfigurationElementCollection)
ResetModified()	Restablece el valor de la IsModified() propiedad a `false` cuando se invalida en una clase derivada. (Heredado de ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Escribe los datos de configuración en un elemento XML del archivo de configuración cuando se invalida en una clase derivada. (Heredado de ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Escribe las etiquetas externas de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada. (Heredado de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Establece una propiedad en el valor especificado. (Heredado de ConfigurationElement)
SetReadOnly()	Establece la IsReadOnly() propiedad para el ConfigurationElementCollection objeto y para todos los subelementos. (Heredado de ConfigurationElementCollection)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Invierte el efecto de combinar información de configuración de diferentes niveles de la jerarquía de configuración. (Heredado de ConfigurationElementCollection)

Implementaciones de interfaz explícitas

Nombre	Description
ICollection.CopyTo(Array, Int32)	Copia en ConfigurationElementCollection una matriz. (Heredado de ConfigurationElementCollection)

Métodos de extensión

Nombre	Description
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte un IEnumerable en un IQueryable.
Cast<TResult>(IEnumerable)	Convierte los elementos de un IEnumerable al tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de un IEnumerable en función de un tipo especificado.

Se aplica a

Consulte también

CompilationSection

Comentarios

¿Le ha resultado útil esta página?