CompilationSection Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee definieert u configuratie-instellingen die worden gebruikt ter ondersteuning van de compilatie-infrastructuur van webtoepassingen. Deze klasse kan niet worden overgenomen.
public ref class CompilationSection sealed : System::Configuration::ConfigurationSection
public sealed class CompilationSection : System.Configuration.ConfigurationSection
type CompilationSection = class
inherit ConfigurationSection
Public NotInheritable Class CompilationSection
Inherits ConfigurationSection
- Overname
Voorbeelden
In dit voorbeeld ziet u hoe u waarden declaratief opgeeft voor verschillende kenmerken van de compilation sectie, die ook kunnen worden geopend als leden van de CompilationSection klasse.
In het volgende voorbeeld van een configuratiebestand ziet u hoe u waarden declaratief opgeeft voor de compilation sectie.
<system.web>
<compilation
tempDirectory=""
debug="False"
strict="False"
explicit="True"
batch="True"
batchTimeout="900"
maxBatchSize="1000"
maxBatchGeneratedFileSize="1000"
numRecompilesBeforeAppRestart="15"
defaultLanguage="vb"
targetFramework="4.0"
urlLinePragmas="False"
assemblyPostProcessorType="">
<assemblies>
<clear />
</assemblies>
<buildProviders>
<clear />
</buildProviders>
<expressionBuilders>
<clear />
</expressionBuilders>
</compilation>
</system.web>
In het volgende codevoorbeeld ziet u hoe u leden van de CompilationSection klasse gebruikt.
#region Using directives
using System;
using System.Collections.Generic;
using System.Text;
using System.Configuration;
using System.Web;
using System.Web.Configuration;
#endregion
namespace Samples.Aspnet.SystemWebConfiguration
{
class UsingCompilationSection
{
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 Assemblies collection count.
Console.WriteLine("Assemblies Count: {0}",
configSection.Assemblies.Count);
// Display AssemblyPostProcessorType property.
Console.WriteLine("AssemblyPostProcessorType: {0}",
configSection.AssemblyPostProcessorType);
// Display Batch property.
Console.WriteLine("Batch: {0}", configSection.Batch);
// Set Batch property.
configSection.Batch = true;
// Display BatchTimeout property.
Console.WriteLine("BatchTimeout: {0}",
configSection.BatchTimeout);
// Set BatchTimeout property.
configSection.BatchTimeout = TimeSpan.FromMinutes(15);
// Display BuildProviders collection count.
Console.WriteLine("BuildProviders collection Count: {0}",
configSection.BuildProviders.Count);
// Display CodeSubDirectories collection count.
Console.WriteLine("CodeSubDirectories Count: {0}",
configSection.CodeSubDirectories.Count);
// Display Compilers collection count.
Console.WriteLine("Compilers Count: {0}",
configSection.Compilers.Count);
// Display Debug property.
Console.WriteLine("Debug: {0}",
configSection.Debug);
// Set Debug property.
configSection.Debug = false;
// Display DefaultLanguage property.
Console.WriteLine("DefaultLanguage: {0}",
configSection.DefaultLanguage);
// Set DefaultLanguage property.
configSection.DefaultLanguage = "vb";
// Display Explicit property.
Console.WriteLine("Explicit: {0}",
configSection.Explicit);
// Set Explicit property.
configSection.Explicit = true;
// Display ExpressionBuilders collection count.
Console.WriteLine("ExpressionBuilders Count: {0}",
configSection.ExpressionBuilders.Count);
// Display MaxBatchGeneratedFileSize property.
Console.WriteLine("MaxBatchGeneratedFileSize: {0}",
configSection.MaxBatchGeneratedFileSize);
// Set MaxBatchGeneratedFileSize property.
configSection.MaxBatchGeneratedFileSize = 1000;
// Display MaxBatchSize property.
Console.WriteLine("MaxBatchSize: {0}",
configSection.MaxBatchSize);
// Set MaxBatchSize property.
configSection.MaxBatchSize = 1000;
// Display NumRecompilesBeforeAppRestart property.
Console.WriteLine("NumRecompilesBeforeAppRestart: {0}",
configSection.NumRecompilesBeforeAppRestart);
// Set NumRecompilesBeforeAppRestart property.
configSection.NumRecompilesBeforeAppRestart = 15;
// Display Strict property.
Console.WriteLine("Strict: {0}",
configSection.Strict);
// Set Strict property.
configSection.Strict = false;
// Display TempDirectory property.
Console.WriteLine("TempDirectory: {0}", configSection.TempDirectory);
// Set TempDirectory property.
configSection.TempDirectory = "myTempDirectory";
// Display UrlLinePragmas property.
Console.WriteLine("UrlLinePragmas: {0}",
configSection.UrlLinePragmas);
// Set UrlLinePragmas property.
configSection.UrlLinePragmas = false;
// ExpressionBuilders Collection
int i = 1;
int j = 1;
foreach (ExpressionBuilder expressionBuilder in configSection.ExpressionBuilders)
{
Console.WriteLine();
Console.WriteLine("ExpressionBuilder {0} Details:", i);
Console.WriteLine("Type: {0}", expressionBuilder.ElementInformation.Type);
Console.WriteLine("Source: {0}", expressionBuilder.ElementInformation.Source);
Console.WriteLine("LineNumber: {0}", expressionBuilder.ElementInformation.LineNumber);
Console.WriteLine("Properties Count: {0}", expressionBuilder.ElementInformation.Properties.Count);
j = 1;
foreach (PropertyInformation propertyItem in expressionBuilder.ElementInformation.Properties)
{
Console.WriteLine("Property {0} Name: {1}", j, propertyItem.Name);
Console.WriteLine("Property {0} Value: {1}", j, propertyItem.Value);
j++;
}
i++;
}
// 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.Collections.Generic
Imports System.Text
Imports System.Configuration
Imports System.Web
Imports System.Web.Configuration
Namespace Samples.Aspnet.SystemWebConfiguration
Class UsingRoleManagerSection
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 Assemblies collection count.
Console.WriteLine("Assemblies Count: {0}", _
configSection.Assemblies.Count)
' Display AssemblyPostProcessorType property.
Console.WriteLine("AssemblyPostProcessorType: {0}", _
configSection.AssemblyPostProcessorType)
' Display Batch property.
Console.WriteLine("Batch: {0}", _
configSection.Batch)
' Set Batch property.
configSection.Batch = True
' Display BatchTimeout property.
Console.WriteLine("BatchTimeout: {0}", _
configSection.BatchTimeout)
' Set BatchTimeout property.
configSection.BatchTimeout = TimeSpan.FromMinutes(15)
' Display BuildProviders collection count.
Console.WriteLine("BuildProviders collection count: {0}", _
configSection.BuildProviders.Count)
' Display CodeSubDirectories property.
Console.WriteLine("CodeSubDirectories: {0}", _
configSection.CodeSubDirectories.Count)
' Display Compilers property.
Console.WriteLine("Compilers: {0}", _
configSection.Compilers.Count)
' Display Debug property.
Console.WriteLine("Debug: {0}", _
configSection.Debug)
' Set Debug property.
configSection.Debug = False
' Display DefaultLanguage property.
Console.WriteLine("DefaultLanguage: {0}", _
configSection.DefaultLanguage)
' Set DefaultLanguage property.
configSection.DefaultLanguage = "vb"
' Display Explicit property.
Console.WriteLine("Explicit: {0}", _
configSection.Explicit)
' Set Explicit property.
configSection.Explicit = True
' Display ExpressionBuilders collection count.
Console.WriteLine("ExpressionBuilders Count: {0}", _
configSection.ExpressionBuilders.Count)
' Display MaxBatchGeneratedFileSize property.
Console.WriteLine("MaxBatchGeneratedFileSize: {0}", _
configSection.MaxBatchGeneratedFileSize)
' Set MaxBatchGeneratedFileSize property.
configSection.MaxBatchGeneratedFileSize = 1000
' Display MaxBatchSize property.
Console.WriteLine("MaxBatchSize: {0}", _
configSection.MaxBatchSize)
' Set MaxBatchSize property.
configSection.MaxBatchSize = 1000
' Display NumRecompilesBeforeAppRestart property.
Console.WriteLine("NumRecompilesBeforeAppRestart: {0}", _
configSection.NumRecompilesBeforeAppRestart)
' Set NumRecompilesBeforeAppRestart property.
configSection.NumRecompilesBeforeAppRestart = 15
' Display Strict property.
Console.WriteLine("Strict: {0}", _
configSection.Strict)
' Set Strict property.
configSection.Strict = False
' Display TempDirectory property.
Console.WriteLine("TempDirectory: {0}", _
configSection.TempDirectory)
' Set TempDirectory property.
configSection.TempDirectory = "myTempDirectory"
' Display UrlLinePragmas property.
Console.WriteLine("UrlLinePragmas: {0}", _
configSection.UrlLinePragmas)
' Set UrlLinePragmas property.
configSection.UrlLinePragmas = False
' ExpressionBuilders Collection
Dim i = 1
Dim j = 1
For Each expressionBuilder As ExpressionBuilder In configSection.ExpressionBuilders()
Console.WriteLine()
Console.WriteLine("ExpressionBuilder {0} Details:", i)
Console.WriteLine("Type: {0}", expressionBuilder.ElementInformation.Type)
Console.WriteLine("Source: {0}", expressionBuilder.ElementInformation.Source)
Console.WriteLine("LineNumber: {0}", expressionBuilder.ElementInformation.LineNumber)
Console.WriteLine("Properties Count: {0}", expressionBuilder.ElementInformation.Properties.Count)
j = 1
For Each propertyItem As PropertyInformation In expressionBuilder.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
' 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
Opmerkingen
De CompilationSection klasse biedt een manier om programmatisch toegang te krijgen tot en de inhoud van de compilation sectie van het configuratiebestand te wijzigen.
Constructors
| Name | Description |
|---|---|
| CompilationSection() |
Initialiseert een nieuw exemplaar van de CompilationSection klasse met behulp van standaardinstellingen. |
Eigenschappen
| Name | Description |
|---|---|
| Assemblies |
Haalt de AssemblyCollection van de CompilationSection. |
| AssemblyPostProcessorType |
Hiermee wordt een waarde opgehaald of ingesteld die een compilatiestap na het proces voor een assembly opgeeft. |
| Batch |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of batchcompilatie wordt geprobeerd. |
| BatchTimeout |
Hiermee haalt u de time-outperiode in seconden op of stelt u deze in voor batchcompilatie. |
| BuildProviders |
Hiermee haalt u de BuildProviderCollection verzameling van de CompilationSection klasse op. |
| CodeSubDirectories |
Haalt de CodeSubDirectoriesCollection van de CompilationSection. |
| Compilers |
Hiermee haalt u de CompilerCollection verzameling van de CompilationSection klasse op. |
| ControlBuilderInterceptorType |
Hiermee haalt u een tekenreeks op die het objecttype vertegenwoordigt dat wordt gebruikt om een ControlBuilder object te onderscheppen en een container te configureren. |
| CurrentConfiguration |
Hiermee wordt een verwijzing opgehaald naar het exemplaar op het hoogste niveau Configuration dat de configuratiehiërarchie vertegenwoordigt waartoe het huidige ConfigurationElement exemplaar behoort. (Overgenomen van ConfigurationElement) |
| Debug |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of binaire releasebestanden moeten worden gecompileerd of binaire bestanden moeten worden opgespoord. |
| DefaultLanguage |
Hiermee haalt u de standaardprogrammeertaal op die moet worden gebruikt in dynamische compilatiebestanden. |
| DisableObsoleteWarnings |
Hiermee wordt opgehaald of ingesteld of de configuratiewaarde disableObsoleteWarnings in de sectie Compilatie is ingesteld. |
| ElementInformation |
Hiermee haalt u een ElementInformation object op dat de niet-aanpasbare informatie en functionaliteit van het ConfigurationElement object bevat. (Overgenomen van ConfigurationElement) |
| ElementProperty |
Hiermee haalt u het ConfigurationElementProperty object op dat het ConfigurationElement object zelf vertegenwoordigt. (Overgenomen van ConfigurationElement) |
| EnablePrefetchOptimization |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een ASP.NET toepassing kan profiteren van Windows 8 prefetch-functionaliteit. |
| EvaluationContext |
Hiermee haalt u het ContextInformation object voor het ConfigurationElement object op. (Overgenomen van ConfigurationElement) |
| Explicit |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de Microsoft Visual Basic |
| ExpressionBuilders |
Haalt de ExpressionBuilderCollection van de CompilationSection. |
| FolderLevelBuildProviders |
Hiermee haalt u de FolderLevelBuildProviderCollection verzameling van de CompilationSection klasse op, die de buildproviders vertegenwoordigt die tijdens de compilatie worden gebruikt. |
| HasContext |
Hiermee wordt een waarde opgehaald die aangeeft of de CurrentConfiguration eigenschap is |
| Item[ConfigurationProperty] |
Hiermee wordt een eigenschap of kenmerk van dit configuratie-element opgehaald of ingesteld. (Overgenomen van ConfigurationElement) |
| Item[String] |
Hiermee wordt een eigenschap, kenmerk of onderliggend element van dit configuratie-element opgehaald of ingesteld. (Overgenomen van ConfigurationElement) |
| LockAllAttributesExcept |
Hiermee haalt u de verzameling vergrendelde kenmerken op. (Overgenomen van ConfigurationElement) |
| LockAllElementsExcept |
Hiermee haalt u de verzameling vergrendelde elementen op. (Overgenomen van ConfigurationElement) |
| LockAttributes |
Hiermee haalt u de verzameling vergrendelde kenmerken op. (Overgenomen van ConfigurationElement) |
| LockElements |
Hiermee haalt u de verzameling vergrendelde elementen op. (Overgenomen van ConfigurationElement) |
| LockItem |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het element is vergrendeld. (Overgenomen van ConfigurationElement) |
| MaxBatchGeneratedFileSize |
Hiermee wordt de maximale gecombineerde grootte van de gegenereerde bronbestanden per batchcompilatie opgehaald of ingesteld. |
| MaxBatchSize |
Hiermee wordt het maximum aantal pagina's per compilatie in batch opgehaald of ingesteld. |
| MaxConcurrentCompilations |
Hiermee wordt opgehaald of ingesteld of de configuratiewaarde maxConcurrentCompilations in de sectie Compilatie is ingesteld. |
| NumRecompilesBeforeAppRestart |
Hiermee haalt u het aantal dynamische recompiles van resources op of stelt u deze in voordat de toepassing opnieuw wordt opgestart. |
| OptimizeCompilations |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de compilatie moet worden geoptimaliseerd. |
| ProfileGuidedOptimizations |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de toepassing is geoptimaliseerd voor de geïmplementeerde omgeving. |
| Properties |
Hiermee haalt u de verzameling eigenschappen op. (Overgenomen van ConfigurationElement) |
| SectionInformation |
Hiermee haalt u een SectionInformation object op dat de niet-aanpasbare informatie en functionaliteit van het ConfigurationSection object bevat. (Overgenomen van ConfigurationSection) |
| Strict |
Hiermee haalt u de optie Visual Basic |
| TargetFramework |
Hiermee haalt u de versie op van het .NET Framework waarop de website is gericht. |
| TempDirectory |
Hiermee wordt een waarde opgehaald of ingesteld waarmee de map wordt opgegeven die moet worden gebruikt voor tijdelijke bestandsopslag tijdens de compilatie. |
| UrlLinePragmas |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of instructies voor de compiler fysieke paden of URL's gebruiken. |
Methoden
| Name | Description |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Leest XML uit het configuratiebestand. (Overgenomen van ConfigurationElement) |
| DeserializeSection(XmlReader) |
Leest XML uit het configuratiebestand. (Overgenomen van ConfigurationSection) |
| Equals(Object) |
Vergelijkt het huidige ConfigurationElement exemplaar met het opgegeven object. (Overgenomen van ConfigurationElement) |
| GetHashCode() |
Hiermee haalt u een unieke waarde op die het huidige ConfigurationElement exemplaar vertegenwoordigt. (Overgenomen van ConfigurationElement) |
| GetRuntimeObject() |
Retourneert een aangepast object wanneer dit wordt overschreven in een afgeleide klasse. (Overgenomen van ConfigurationSection) |
| GetTransformedAssemblyString(String) |
Retourneert de getransformeerde versie van de opgegeven assemblynaam. (Overgenomen van ConfigurationElement) |
| GetTransformedTypeString(String) |
Retourneert de getransformeerde versie van de opgegeven typenaam. (Overgenomen van ConfigurationElement) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| Init() |
Hiermee stelt u het object in op de ConfigurationElement oorspronkelijke status. (Overgenomen van ConfigurationElement) |
| InitializeDefault() |
Wordt gebruikt om een standaardset waarden voor het ConfigurationElement object te initialiseren. (Overgenomen van ConfigurationElement) |
| IsModified() |
Geeft aan of dit configuratie-element is gewijzigd sinds het voor het laatst is opgeslagen of geladen wanneer dit is geïmplementeerd in een afgeleide klasse. (Overgenomen van ConfigurationSection) |
| IsReadOnly() |
Hiermee wordt een waarde opgehaald die aangeeft of het ConfigurationElement object het kenmerk Alleen-lezen heeft. (Overgenomen van ConfigurationElement) |
| ListErrors(IList) |
Voegt de fouten met ongeldige eigenschappen in dit ConfigurationElement object en in alle subelementen toe aan de doorgegeven lijst. (Overgenomen van ConfigurationElement) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Hiermee wordt een waarde opgehaald die aangeeft of er een onbekend kenmerk wordt aangetroffen tijdens deserialisatie. (Overgenomen van ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Hiermee wordt een waarde opgehaald die aangeeft of er een onbekend element wordt aangetroffen tijdens deserialisatie. (Overgenomen van ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Genereert een uitzondering wanneer een vereiste eigenschap niet wordt gevonden. (Overgenomen van ConfigurationElement) |
| PostDeserialize() |
Gebeld na ontserialisatie. (Overgenomen van ConfigurationElement) |
| PreSerialize(XmlWriter) |
Aangeroepen vóór serialisatie. (Overgenomen van ConfigurationElement) |
| Reset(ConfigurationElement) |
Hiermee stelt u de interne status van het ConfigurationElement object opnieuw in, inclusief de vergrendelingen en de eigenschappenverzamelingen. (Overgenomen van ConfigurationElement) |
| ResetModified() |
Hiermee stelt u de waarde van de methode IsModified() opnieuw in wanneer deze |
| SerializeElement(XmlWriter, Boolean) |
Schrijft de inhoud van dit configuratie-element naar het configuratiebestand wanneer deze wordt geïmplementeerd in een afgeleide klasse. (Overgenomen van ConfigurationElement) |
| SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Hiermee maakt u een XML-tekenreeks met een niet-gekoppelde weergave van het ConfigurationSection object als één sectie om naar een bestand te schrijven. (Overgenomen van ConfigurationSection) |
| SerializeToXmlElement(XmlWriter, String) |
Hiermee schrijft u de buitenste tags van dit configuratie-element naar het configuratiebestand wanneer het wordt geïmplementeerd in een afgeleide klasse. (Overgenomen van ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Hiermee stelt u een eigenschap in op de opgegeven waarde. (Overgenomen van ConfigurationElement) |
| SetReadOnly() |
Hiermee stelt u de IsReadOnly() eigenschap voor het ConfigurationElement object en alle subelementen in. (Overgenomen van ConfigurationElement) |
| ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName) |
Geeft aan of het opgegeven element moet worden geserialiseerd wanneer de hiërarchie van het configuratieobject wordt geserialiseerd voor de opgegeven doelversie van het .NET Framework. (Overgenomen van ConfigurationSection) |
| ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement) |
Geeft aan of de opgegeven eigenschap moet worden geserialiseerd wanneer de configuratieobjecthiërarchie wordt geserialiseerd voor de opgegeven doelversie van het .NET Framework. (Overgenomen van ConfigurationSection) |
| ShouldSerializeSectionInTargetVersion(FrameworkName) |
Hiermee wordt aangegeven of de huidige ConfigurationSection-instantie moet worden geserialiseerd wanneer de hiërarchie van het configuratieobject wordt geserialiseerd voor de opgegeven doelversie van het .NET Framework. (Overgenomen van ConfigurationSection) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Hiermee wijzigt u het ConfigurationElement object om alle waarden te verwijderen die niet mogen worden opgeslagen. (Overgenomen van ConfigurationElement) |