BuildProviderCollection Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.Configuration

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta una raccolta di oggetti BuildProvider. La classe non può essere ereditata.

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

Ereditarietà: Object

ConfigurationElement

ConfigurationElementCollection
BuildProviderCollection

Attributi: ConfigurationCollectionAttribute

Esempio

Questa sezione fornisce due esempi di codice. La prima illustra come specificare in modo dichiarativo i valori per diverse proprietà della BuildProviderCollection classe. Il secondo illustra come usare i membri della BuildProviderCollection classe.

Nell'esempio di file di configurazione seguente viene illustrato come specificare in modo dichiarativo i valori per diverse proprietà della BuildProviderCollection classe.

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

Nell'esempio di codice seguente viene illustrato come usare i membri della BuildProviderCollection classe.

#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

Commenti

Viene BuildProviderCollection usato per compilare file di risorse personalizzati. Possono essere presenti più provider di compilazione. Non BuildProviderCollection fa riferimento a alcun elemento effettivo nel file di configurazione sottostante. Si tratta di un costrutto che consente di accedere facilmente alle informazioni di compilazione contenute.

Costruttori

BuildProviderCollection()

Inizializza una nuova istanza della classe BuildProviderCollection.

Proprietà

AddElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di aggiunta nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
ClearElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di cancellazione nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
CollectionType	Ottiene il tipo di ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
Count	Ottiene il numero di elementi nella raccolta. (Ereditato da ConfigurationElementCollection)
CurrentConfiguration	Ottiene un riferimento all'istanza di Configuration di livello superiore che rappresenta la gerarchia di configurazione cui appartiene l'istanza corrente di ConfigurationElement. (Ereditato da ConfigurationElement)
ElementInformation	Ottiene un oggetto ElementInformation contenente le funzionalità e le informazioni non personalizzabili dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
ElementName	Ottiene il nome utilizzato per identificare questo insieme di elementi nel file di configurazione quando è sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
ElementProperty	Ottiene l'oggetto ConfigurationElementProperty che rappresenta l'oggetto ConfigurationElement stesso. (Ereditato da ConfigurationElement)
EmitClear	Ottiene o imposta un valore che specifica se l'insieme è stato cancellato. (Ereditato da ConfigurationElementCollection)
EvaluationContext	Ottiene l'oggetto ContextInformation per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
HasContext	Ottiene un valore che indica se la proprietà CurrentConfiguration è `null`. (Ereditato da ConfigurationElement)
IsSynchronized	Ottiene un valore che indica se l'accesso alla raccolta è sincronizzato. (Ereditato da ConfigurationElementCollection)
Item[ConfigurationProperty]	Ottiene o imposta una proprietà o un attributo di questo elemento di configurazione. (Ereditato da ConfigurationElement)
Item[Int32]	Ottiene l'oggetto BuildProvider in corrispondenza dell'indice specificato dell'insieme.
Item[String]	Ottiene l'elemento dell'insieme BuildProvider in base al nome specificato.
LockAllAttributesExcept	Ottiene l'insieme di attributi bloccati. (Ereditato da ConfigurationElement)
LockAllElementsExcept	Ottiene l'insieme di elementi bloccati. (Ereditato da ConfigurationElement)
LockAttributes	Ottiene l'insieme di attributi bloccati. (Ereditato da ConfigurationElement)
LockElements	Ottiene l'insieme di elementi bloccati. (Ereditato da ConfigurationElement)
LockItem	Ottiene o imposta un valore che indica se l'elemento è bloccato. (Ereditato da ConfigurationElement)
Properties	Ottiene la raccolta di proprietà. (Ereditato da ConfigurationElement)
RemoveElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di rimozione nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
SyncRoot	Ottiene un oggetto utilizzato per sincronizzare l'accesso alla classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
ThrowOnDuplicate	Ottiene un valore che indica se il tentativo di aggiungere una classe ConfigurationElement duplicata alla classe ConfigurationElementCollection genererà un'eccezione. (Ereditato da ConfigurationElementCollection)

Metodi

Add(BuildProvider)	Aggiunge un oggetto BuildProvider a BuildProviderCollection.
BaseAdd(ConfigurationElement)	Aggiunge un elemento di configurazione a ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)	Aggiunge un elemento di configurazione all'insieme di elementi di configurazione. (Ereditato da ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Aggiunge un elemento di configurazione all'insieme di elementi di configurazione. (Ereditato da ConfigurationElementCollection)
BaseClear()	Rimuove tutti gli oggetti dell'elemento di configurazione dall'insieme. (Ereditato da ConfigurationElementCollection)
BaseGet(Int32)	Ottiene l'elemento di configurazione in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
BaseGet(Object)	Restituisce l'elemento di configurazione con la chiave specificata. (Ereditato da ConfigurationElementCollection)
BaseGetAllKeys()	Restituisce una matrice delle chiavi di tutti gli elementi di configurazione inclusi nella classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseGetKey(Int32)	Ottiene la chiave per la classe ConfigurationElement in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Indica l'indice della classe ConfigurationElement specificata. (Ereditato da ConfigurationElementCollection)
BaseIsRemoved(Object)	Indica se la classe ConfigurationElement con la chiave specificata è stata rimossa dalla classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseRemove(Object)	Rimuove un oggetto ConfigurationElement dalla raccolta. (Ereditato da ConfigurationElementCollection)
BaseRemoveAt(Int32)	Rimuove la classe ConfigurationElement in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
Clear()	Cancella tutti gli oggetti BuildProvider dalla classe BuildProviderCollection.
CopyTo(ConfigurationElement[], Int32)	Copia il contenuto della classe ConfigurationElementCollection in una matrice. (Ereditato da ConfigurationElementCollection)
CreateNewElement()	Quando è sottoposto a override in una classe derivata, crea un nuovo elemento ConfigurationElement. (Ereditato da ConfigurationElementCollection)
CreateNewElement(String)	Crea una nuova classe ConfigurationElement quando è sottoposto a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Legge il codice XML dal file di configurazione. (Ereditato da ConfigurationElement)
Equals(Object)	Confronta la classe ConfigurationElementCollection con l'oggetto specificato. (Ereditato da ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Ottiene la chiave per un elemento di configurazione specificato quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
GetEnumerator()	Ottiene un'interfaccia IEnumerator utilizzata per scorrere la classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
GetHashCode()	Ottiene un valore univoco che rappresenta l'istanza di ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
GetTransformedAssemblyString(String)	Restituisce la versione trasformata del nome di assembly specificato. (Ereditato da ConfigurationElement)
GetTransformedTypeString(String)	Restituisce la versione trasformata del nome del tipo specificato. (Ereditato da ConfigurationElement)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Init()	Ripristina lo stato iniziale dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
InitializeDefault()	Da utilizzare per inizializzare un insieme predefinito di valori per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
IsElementName(String)	Indica se la classe ConfigurationElement specificata esiste nella classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Indica se è possibile rimuovere l'oggetto ConfigurationElement da ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
IsModified()	Indica se questa classe ConfigurationElementCollection è stata modificata dall'ultimo salvataggio o caricamento durante l'override in una classe derivata. (Ereditato da ConfigurationElementCollection)
IsReadOnly()	Indica se l'oggetto ConfigurationElementCollection è in sola lettura. (Ereditato da ConfigurationElementCollection)
ListErrors(IList)	Aggiunge all'elenco passato gli errori di proprietà non valida di questo oggetto ConfigurationElement e di tutti i sottoelementi. (Ereditato da ConfigurationElement)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ottiene un valore che indica se viene incontrato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Fa generare un'eccezione al sistema di configurazione. (Ereditato da ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	Genera un'eccezione quando una proprietà obbligatoria non viene trovata. (Ereditato da ConfigurationElement)
PostDeserialize()	Da chiamare dopo la deserializzazione. (Ereditato da ConfigurationElement)
PreSerialize(XmlWriter)	Da chiamare prima della serializzazione. (Ereditato da ConfigurationElement)
Remove(String)	Rimuove un oggetto BuildProvider dall'oggetto BuildProviderCollection.
RemoveAt(Int32)	Rimuove l'oggetto BuildProvider in corrispondenza dell'indice specificato dalla classe BuildProviderCollection.
Reset(ConfigurationElement)	Reimposta la classe ConfigurationElementCollection sullo stato non modificato quando viene sottoposta a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
ResetModified()	Reimposta il valore della proprietà IsModified() su `false` quando viene sottoposto a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Scrive i dati di configurazione in un elemento XML del file di configurazione quando vengono sottoposti a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Scrive i tag esterni di questo elemento di configurazione nel file di configurazione in caso di implementazione in una classe derivata. (Ereditato da ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Imposta una proprietà sul valore specificato. (Ereditato da ConfigurationElement)
SetReadOnly()	Imposta la proprietà IsReadOnly() per l'oggetto ConfigurationElementCollection e per tutti i sottoelementi. (Ereditato da ConfigurationElementCollection)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Inverte l'effetto di unione delle informazioni sulla configurazione da livelli diversi della gerarchia di configurazione. (Ereditato da ConfigurationElementCollection)

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)

Copia ConfigurationElementCollection in una matrice.

(Ereditato da ConfigurationElementCollection)

Metodi di estensione

Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un oggetto IEnumerable in un oggetto IQueryable.

Si applica a

Vedi anche

CompilationSection