BuildProviderCollection Classe
Definizione
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 BuildProvider oggetti . 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à
- Attributi
Esempio
In questa sezione vengono forniti 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. È possibile avere un numero qualsiasi di provider di compilazione. Non BuildProviderCollection fa riferimento ad alcun elemento effettivo nel file di configurazione sottostante. Si tratta di un costrutto che consente di accedere facilmente alle informazioni di compilazione contenute.
Costruttori
| Nome | Descrizione |
|---|---|
| BuildProviderCollection() |
Inizializza una nuova istanza della classe BuildProviderCollection. |
Proprietà
| Nome | Descrizione |
|---|---|
| AddElementName |
Ottiene o imposta il nome del ConfigurationElement da associare all'operazione di aggiunta nel ConfigurationElementCollection quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationElementCollection) |
| ClearElementName |
Ottiene o imposta il nome del ConfigurationElement da associare all'operazione di cancellazione nel ConfigurationElementCollection quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationElementCollection) |
| CollectionType |
Ottiene il tipo del ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection) |
| Count |
Ottiene il numero di elementi nella raccolta. (Ereditato da ConfigurationElementCollection) |
| CurrentConfiguration |
Ottiene un riferimento all'istanza di Configuration di primo livello che rappresenta la gerarchia di configurazione a cui appartiene l'istanza di ConfigurationElement corrente. (Ereditato da ConfigurationElement) |
| ElementInformation |
Ottiene un oggetto ElementInformation che contiene le informazioni e le funzionalità non personalizzabili dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement) |
| ElementName |
Ottiene il nome utilizzato per identificare questa raccolta di elementi nel file di configurazione quando ne viene eseguito l'override in una 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 è |
| 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 BuildProvider della raccolta in base al nome specificato. |
| LockAllAttributesExcept |
Ottiene la raccolta di attributi bloccati. (Ereditato da ConfigurationElement) |
| LockAllElementsExcept |
Ottiene la raccolta di elementi bloccati. (Ereditato da ConfigurationElement) |
| LockAttributes |
Ottiene la raccolta di attributi bloccati. (Ereditato da ConfigurationElement) |
| LockElements |
Ottiene la raccolta 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 del ConfigurationElement da associare all'operazione di rimozione nel ConfigurationElementCollection quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationElementCollection) |
| SyncRoot |
Ottiene un oggetto utilizzato per sincronizzare l'accesso al ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection) |
| ThrowOnDuplicate |
Ottiene un valore che indica se un tentativo di aggiungere un ConfigurationElement duplicato al ConfigurationElementCollection genererà un'eccezione. (Ereditato da ConfigurationElementCollection) |
Metodi
| Nome | Descrizione |
|---|---|
| Add(BuildProvider) |
Aggiunge un BuildProvider oggetto all'oggetto BuildProviderCollection. |
| BaseAdd(ConfigurationElement, Boolean) |
Aggiunge un elemento di configurazione alla raccolta di elementi di configurazione. (Ereditato da ConfigurationElementCollection) |
| BaseAdd(ConfigurationElement) |
Aggiunge un elemento di configurazione al ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection) |
| BaseAdd(Int32, ConfigurationElement) |
Aggiunge un elemento di configurazione alla raccolta di elementi di configurazione. (Ereditato da ConfigurationElementCollection) |
| BaseClear() |
Rimuove tutti gli oggetti elemento di configurazione dalla raccolta. (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 per tutti gli elementi di configurazione contenuti nella ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection) |
| BaseGetKey(Int32) |
Ottiene la chiave per il ConfigurationElement in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection) |
| BaseIndexOf(ConfigurationElement) |
Indica l'indice del ConfigurationElementspecificato. (Ereditato da ConfigurationElementCollection) |
| BaseIsRemoved(Object) |
Indica se il ConfigurationElement con la chiave specificata è stato rimosso dal ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection) |
| BaseRemove(Object) |
Rimuove un ConfigurationElement dalla raccolta. (Ereditato da ConfigurationElementCollection) |
| BaseRemoveAt(Int32) |
Rimuove il ConfigurationElement in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection) |
| Clear() |
Cancella tutti gli BuildProvider oggetti da BuildProviderCollection. |
| CopyTo(ConfigurationElement[], Int32) |
Copia il contenuto del ConfigurationElementCollection in una matrice. (Ereditato da ConfigurationElementCollection) |
| CreateNewElement() |
Quando sottoposto a override in una classe derivata, crea un nuovo ConfigurationElementoggetto . (Ereditato da ConfigurationElementCollection) |
| CreateNewElement(String) |
Crea una nuova ConfigurationElement quando ne viene eseguito l'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 il ConfigurationElementCollection con l'oggetto specificato. (Ereditato da ConfigurationElementCollection) |
| GetElementKey(ConfigurationElement) |
Ottiene la chiave dell'elemento per un elemento di configurazione specificato quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationElementCollection) |
| GetEnumerator() |
Ottiene un IEnumerator oggetto utilizzato per scorrere l'oggetto 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 dell'assembly specificato. (Ereditato da ConfigurationElement) |
| GetTransformedTypeString(String) |
Restituisce la versione trasformata del nome del tipo specificato. (Ereditato da ConfigurationElement) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| Init() |
Imposta l'oggetto ConfigurationElement sullo stato iniziale. (Ereditato da ConfigurationElement) |
| InitializeDefault() |
Utilizzato per inizializzare un set predefinito di valori per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement) |
| IsElementName(String) |
Indica se il ConfigurationElement specificato esiste nel ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection) |
| IsElementRemovable(ConfigurationElement) |
Indica se il ConfigurationElement specificato può essere rimosso dal ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection) |
| IsModified() |
Indica se questa ConfigurationElementCollection è stata modificata dopo l'ultimo salvataggio o caricamento quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationElementCollection) |
| IsReadOnly() |
Indica se l'oggetto ConfigurationElementCollection è di sola lettura. (Ereditato da ConfigurationElementCollection) |
| ListErrors(IList) |
Aggiunge gli errori di proprietà non validi in questo oggetto ConfigurationElement e in tutti i sottoelementi all'elenco passato. (Ereditato da ConfigurationElement) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Ottiene un valore che indica se viene rilevato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Fa sì che il sistema di configurazione generi un'eccezione. (Ereditato da ConfigurationElementCollection) |
| OnRequiredPropertyNotFound(String) |
Genera un'eccezione quando non viene trovata una proprietà obbligatoria. (Ereditato da ConfigurationElement) |
| PostDeserialize() |
Chiamato dopo la deserializzazione. (Ereditato da ConfigurationElement) |
| PreSerialize(XmlWriter) |
Chiamato prima della serializzazione. (Ereditato da ConfigurationElement) |
| Remove(String) |
Rimuove un BuildProvider oggetto da BuildProviderCollection. |
| RemoveAt(Int32) |
Rimuove l'oggetto BuildProvider in corrispondenza dell'indice specificato dall'oggetto BuildProviderCollection. |
| Reset(ConfigurationElement) |
Reimposta il ConfigurationElementCollection sullo stato non modificato quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationElementCollection) |
| ResetModified() |
Reimposta il valore della proprietà IsModified() su |
| SerializeElement(XmlWriter, Boolean) |
Scrive i dati di configurazione in un elemento XML nel file di configurazione quando ne viene eseguito l'override in una classe derivata. (Ereditato da ConfigurationElementCollection) |
| SerializeToXmlElement(XmlWriter, String) |
Scrive i tag esterni di questo elemento di configurazione nel file di configurazione quando implementato 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 dell'unione delle informazioni di configurazione da diversi livelli della gerarchia di configurazione. (Ereditato da ConfigurationElementCollection) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| ICollection.CopyTo(Array, Int32) |
Copia il ConfigurationElementCollection in una matrice. (Ereditato da ConfigurationElementCollection) |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| AsParallel(IEnumerable) |
Abilita la parallelizzazione di una query. |
| AsQueryable(IEnumerable) |
Converte un IEnumerable in un IQueryable. |
| Cast<TResult>(IEnumerable) |
Esegue il cast degli elementi di un IEnumerable al tipo specificato. |
| OfType<TResult>(IEnumerable) |
Filtra gli elementi di un IEnumerable in base a un tipo specificato. |