Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

CompilationSection-Klasse

 

Veröffentlicht: Oktober 2016

Definiert Konfigurationseinstellungen, die zur Unterstützung der Infrastruktur Kompilierung von ASP.NET-Webanwendungen verwendet werden. Diese Klasse kann nicht vererbt werden.

Namespace:   System.Web.Configuration
Assembly:  System.Web (in System.Web.dll)

System.Object
  System.Configuration.ConfigurationElement
    System.Configuration.ConfigurationSection
      System.Web.Configuration.CompilationSection

public sealed class CompilationSection : ConfigurationSection

NameBeschreibung
System_CAPS_pubmethodCompilationSection()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Initialisiert eine neue Instanz der CompilationSection-Klasse mit Standardeinstellungen.

NameBeschreibung
System_CAPS_pubpropertyAssemblies

Ruft den AssemblyCollection von CompilationSection ab.

System_CAPS_pubpropertyAssemblyPostProcessorType

Ruft ab oder legt einen Wert, der einen nachträglichen Kompilierungsschritt für eine Assembly angibt.

System_CAPS_pubpropertyBatch

Ruft ab oder legt einen Wert, der angibt, ob die Batchkompilierung ausgeführt werden.

System_CAPS_pubpropertyBatchTimeout

Ruft ab oder legt das Timeout in Sekunden für die Batchkompilierung.

System_CAPS_pubpropertyBuildProviders

Ruft die BuildProviderCollection Auflistung von der CompilationSection Klasse.

System_CAPS_pubpropertyCodeSubDirectories

Ruft den CodeSubDirectoriesCollection von CompilationSection ab.

System_CAPS_pubpropertyCompilers

Ruft die CompilerCollection Auflistung von der CompilationSection Klasse.

System_CAPS_pubpropertyControlBuilderInterceptorType

Ruft ab oder legt eine Zeichenfolge für den Objekttyp, mit einem ControlBuilder Objekt, und Konfigurieren eines Containers.

System_CAPS_pubpropertyCurrentConfiguration

Ruft einen Verweis auf der obersten Ebene Configuration -Instanz, die die Konfigurationshierarchie darstellt, die die aktuelle ConfigurationElement -Instanz gehört.(Geerbt von „ConfigurationElement“.)

System_CAPS_pubpropertyDebug

Ruft ab oder legt einen Wert, der angibt, ob Version Binärdateien zu kompilieren oder Debugbinärdateien fest.

System_CAPS_pubpropertyDefaultLanguage

Ruft ab oder legt die Standardprogrammiersprache in dynamischen Kompilierungsdateien verwendet.

System_CAPS_pubpropertyDisableObsoleteWarnings

Ruft ab oder legt fest, ob der Konfigurationswert "DisableObsoleteWarnings" im Abschnitt Kompilierung festgelegt ist.

System_CAPS_pubpropertyElementInformation

Ruft ein ElementInformation Objekt, das die nicht anpassbaren Informationen und Funktionen von enthält die ConfigurationElement Objekt.(Geerbt von „ConfigurationElement“.)

System_CAPS_protpropertyElementProperty

Ruft die ConfigurationElementProperty -Objekt, das darstellt, die ConfigurationElement Objekt selbst.(Geerbt von „ConfigurationElement“.)

System_CAPS_pubpropertyEnablePrefetchOptimization

Ruft einen Wert ab, der angibt, ob eine ASP.NET-Anwendung die Vorabruffunktionalität von Windows 8 nutzen kann.

System_CAPS_pubpropertyExplicit

Ruft ab oder legt einen Wert, der angibt, ob die Microsoft Visual Basic verwenden explicit compile-Option.

System_CAPS_pubpropertyExpressionBuilders

Ruft den ExpressionBuilderCollection von CompilationSection ab.

System_CAPS_pubpropertyFolderLevelBuildProviders

Ruft die FolderLevelBuildProviderCollection Auflistung von der CompilationSection -Klasse, die der Buildanbieter darstellt, die während der Kompilierung verwendet werden.

System_CAPS_protpropertyItem[ConfigurationProperty]

Ruft ab oder legt eine Eigenschaft oder ein Attribut dieses Konfigurationselements.(Geerbt von „ConfigurationElement“.)

System_CAPS_protpropertyItem[String]

Ruft eine Eigenschaft, ein Attribut oder ein untergeordnetes Element dieses Konfigurationselements ab oder legt diese bzw. dieses fest.(Geerbt von „ConfigurationElement“.)

System_CAPS_pubpropertyLockAllAttributesExcept

Ruft die Auflistung gesperrter Attribute ab.(Geerbt von „ConfigurationElement“.)

System_CAPS_pubpropertyLockAllElementsExcept

Ruft die Auflistung gesperrter Elemente ab.(Geerbt von „ConfigurationElement“.)

System_CAPS_pubpropertyLockAttributes

Ruft die Auflistung gesperrter Attribute (Geerbt von „ConfigurationElement“.)

System_CAPS_pubpropertyLockElements

Ruft die Auflistung gesperrter Elemente ab.(Geerbt von „ConfigurationElement“.)

System_CAPS_pubpropertyLockItem

Ruft ab oder legt einen Wert, der angibt, ob das Element gesperrt ist.(Geerbt von „ConfigurationElement“.)

System_CAPS_pubpropertyMaxBatchGeneratedFileSize

Ruft ab oder legt die maximale Gesamtgröße der generierten Quelldateien pro Batchkompilierung.

System_CAPS_pubpropertyMaxBatchSize

Ruft ab oder legt die maximale Anzahl der Seiten pro Batchkompilierung.

System_CAPS_pubpropertyMaxConcurrentCompilations

Ruft ab oder legt fest, ob der Konfigurationswert "MaxConcurrentCompilations" im Abschnitt Kompilierung festgelegt ist.

System_CAPS_pubpropertyNumRecompilesBeforeAppRestart

Ruft ab oder legt die Anzahl der Ressourcen, die vor dem Neustart der Anwendung auftreten können dynamisch erneut kompiliert.

System_CAPS_pubpropertyOptimizeCompilations

Ruft ab oder legt einen Wert, der angibt, ob die Kompilierung optimiert werden muss.

System_CAPS_pubpropertyProfileGuidedOptimizations

Ruft einen Wert ab, der angibt, ob die Anwendung für die bereitgestellte Umgebung optimiert ist, oder legt ihn fest.

System_CAPS_protpropertyProperties

Ruft die Auflistung von Eigenschaften ab.(Geerbt von „ConfigurationElement“.)

System_CAPS_pubpropertySectionInformation

Ruft ein SectionInformation Objekt, das die nicht anpassbaren Informationen und Funktionen von enthält die ConfigurationSection Objekt.(Geerbt von „ConfigurationSection“.)

System_CAPS_pubpropertyStrict

Ruft ab oder legt die Visual Basic strict compile-Option.

System_CAPS_pubpropertyTargetFramework

Ruft ab oder legt die Version von .NET Framework, die die Website abzielt.

System_CAPS_pubpropertyTempDirectory

Ruft ab oder legt einen Wert, der angibt, das Verzeichnis für die Speicherung temporärer Dateien während der Kompilierung verwendet.

System_CAPS_pubpropertyUrlLinePragmas

Ruft ab oder legt fest, ob die Anweisungen für den Compiler physischen Pfaden oder URLs verwenden.

NameBeschreibung
System_CAPS_protmethodDeserializeElement(XmlReader, Boolean)

Liest XML aus der Konfigurationsdatei.(Geerbt von „ConfigurationElement“.)

System_CAPS_protmethodDeserializeSection(XmlReader)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Liest XML aus der Konfigurationsdatei.(Geerbt von „ConfigurationSection“.)

System_CAPS_pubmethodEquals(Object)

Vergleicht das aktuelle ConfigurationElement Instanz mit dem angegebenen Objekt.(Geerbt von „ConfigurationElement“.)

System_CAPS_pubmethodGetHashCode()

Ruft einen eindeutigen Wert, der die aktuelle darstellt ConfigurationElement Instanz.(Geerbt von „ConfigurationElement“.)

System_CAPS_protmethodGetRuntimeObject()

Gibt ein benutzerdefiniertes Objekt beim Überschreiben in einer abgeleiteten Klasse zurück.(Geerbt von „ConfigurationSection“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_protmethodInit()

Legt die ConfigurationElement Objekt in ihren ursprünglichen Zustand.(Geerbt von „ConfigurationElement“.)

System_CAPS_protmethodInitializeDefault()

Initialisiert einen Standardsatz von Werten für die ConfigurationElement Objekt.(Geerbt von „ConfigurationElement“.)

System_CAPS_protmethodIsModified()

Gibt an, ob dieses Konfigurationselement geändert wurde, seit es zuletzt gespeichert oder geladen, wenn in einer abgeleiteten Klasse implementiert wurde.(Geerbt von „ConfigurationSection“.)

System_CAPS_pubmethodIsReadOnly()

Ruft einen Wert ab, der angibt, ob das ConfigurationElement schreibgeschützt ist.(Geerbt von „ConfigurationElement“.)

System_CAPS_protmethodReset(ConfigurationElement)

Setzt den internen Status dieses ConfigurationElement-Objekts zurück, einschließlich der Sperren und der Eigenschaftenauflistungen.(Geerbt von „ConfigurationElement“.)

System_CAPS_protmethodResetModified()

Setzt bei Implementierung in einer abgeleiteten Klasse den Wert der IsModified-Methode auf false zurück.(Geerbt von „ConfigurationSection“.)

System_CAPS_protmethodSerializeElement(XmlWriter, Boolean)

Schreibt den Inhalt dieses Konfigurationselements in die Konfigurationsdatei bei Implementierung in einer abgeleiteten Klasse.(Geerbt von „ConfigurationElement“.)

System_CAPS_protmethodSerializeSection(ConfigurationElement, String, ConfigurationSaveMode)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Erstellt eine XML-Zeichenfolge mit einer nicht zusammengeführten Ansicht des der ConfigurationSection Objekt als einen einzelnen Abschnitt in eine Datei geschrieben.(Geerbt von „ConfigurationSection“.)

System_CAPS_protmethodSerializeToXmlElement(XmlWriter, String)

Schreibt die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei bei Implementierung in einer abgeleiteten Klasse.(Geerbt von „ConfigurationElement“.)

System_CAPS_protmethodSetReadOnly()

Legt die IsReadOnly -Eigenschaft für das ConfigurationElement -Objekt und alle untergeordneten Elemente.(Geerbt von „ConfigurationElement“.)

System_CAPS_protmethodShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)

Gibt an, ob das angegebene Element serialisiert werden soll, wenn für die angegebene Zielversion von die Objekthierarchie serialisiert wird die .NET Framework.(Geerbt von „ConfigurationSection“.)

System_CAPS_protmethodShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)

Gibt an, ob die angegebene Eigenschaft serialisiert werden soll, wenn für die angegebene Zielversion von die Objekthierarchie serialisiert wird die .NET Framework.(Geerbt von „ConfigurationSection“.)

System_CAPS_protmethodShouldSerializeSectionInTargetVersion(FrameworkName)

Gibt an, ob die aktuelle ConfigurationSection -Instanz serialisiert werden soll, wenn für die angegebene Zielversion von die Objekthierarchie serialisiert wird die .NET Framework.(Geerbt von „ConfigurationSection“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

System_CAPS_protmethodUnmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Ändert die ConfigurationElement -Objekt, das alle Werte zu entfernen, die nicht gespeichert werden sollen.(Geerbt von „ConfigurationElement“.)

Die CompilationSection -Klasse bietet eine Möglichkeit zum programmgesteuerten Zugriff auf und Ändern des Inhalts der compilation Abschnitt der Konfigurationsdatei.

In diesem Beispiel wird veranschaulicht, wie Werte für verschiedene Attribute des deklarativ angeben der compilation Bereich, der auch als Mitglieder zugegriffen werden kann die CompilationSection Klasse.

Die folgenden Beispielkonfigurationsdatei wird veranschaulicht, wie an deklarativ Werte für die compilation Abschnitt.

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

Im folgenden Codebeispiel wird veranschaulicht, wie Mitglieder der CompilationSection Klasse.

#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();
    }
  }
}

.NET Framework
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: