CompilationSection クラス

定義

名前空間:: System.Web.Configuration

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

Web アプリケーションのコンパイルインフラストラクチャをサポートするために使用される構成設定を定義します。このクラスは継承できません。

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

継承: Object

ConfigurationElement

ConfigurationSection
CompilationSection

例

この例では、 compilation セクションのいくつかの属性に対して宣言的に値を指定する方法を示します。これは、 CompilationSection クラスのメンバーとしてもアクセスできます。

次の構成ファイルの例は、 compilation セクションに対して宣言によって値を指定する方法を示しています。

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

次のコード例は、 CompilationSection クラスのメンバーを使用する方法を示しています。

#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

注釈

CompilationSection クラスは、構成ファイルの compilation セクションの内容にプログラムでアクセスして変更する方法を提供します。

コンストラクター

名前	説明
CompilationSection()	既定の設定を使用して、 CompilationSection クラスの新しいインスタンスを初期化します。

プロパティ

名前	説明
Assemblies	AssemblyCollectionのCompilationSectionを取得します。
AssemblyPostProcessorType	アセンブリのプロセス後コンパイルステップを指定する値を取得または設定します。
Batch	バッチコンパイルが試行されるかどうかを示す値を取得または設定します。
BatchTimeout	バッチコンパイルのタイムアウト期間 (秒単位) を取得または設定します。
BuildProviders	BuildProviderCollection クラスのCompilationSection コレクションを取得します。
CodeSubDirectories	CodeSubDirectoriesCollectionのCompilationSectionを取得します。
Compilers	CompilerCollection クラスのCompilationSection コレクションを取得します。
ControlBuilderInterceptorType	ControlBuilder オブジェクトをインターセプトしてコンテナーを構成するために使用するオブジェクトの種類を表す文字列を取得または設定します。
CurrentConfiguration	現在のConfiguration インスタンスが属している構成階層を表す最上位ConfigurationElement インスタンスへの参照を取得します。 (継承元 ConfigurationElement)
Debug	リリースバイナリをコンパイルするか、バイナリをデバッグするかを指定する値を取得または設定します。
DefaultLanguage	動的コンパイルファイルで使用する既定のプログラミング言語を取得または設定します。
DisableObsoleteWarnings	[コンパイル] セクションの "disableObsoleteWarnings" 構成値が設定されているかどうかを取得または設定します。
ElementInformation	ElementInformation オブジェクトのカスタマイズ不可能な情報と機能を含むConfigurationElement オブジェクトを取得します。 (継承元 ConfigurationElement)
ElementProperty	ConfigurationElementProperty オブジェクト自体を表すConfigurationElement オブジェクトを取得します。 (継承元 ConfigurationElement)
EnablePrefetchOptimization	ASP.NET アプリケーションがプリフェッチ機能を利用できるかどうかを示す値Windows 8取得または設定します。
EvaluationContext	ContextInformation オブジェクトの ConfigurationElement オブジェクトを取得します。 (継承元 ConfigurationElement)
Explicit	Microsoft Visual Basic `explicit` コンパイルオプションを使用するかどうかを示す値を取得または設定します。
ExpressionBuilders	ExpressionBuilderCollectionのCompilationSectionを取得します。
FolderLevelBuildProviders	コンパイル時に使用されるビルドプロバイダーを表す、FolderLevelBuildProviderCollection クラスのCompilationSection コレクションを取得します。
HasContext	CurrentConfiguration プロパティが`null`されているかどうかを示す値を取得します。 (継承元 ConfigurationElement)
Item[ConfigurationProperty]	この構成要素のプロパティまたは属性を取得または設定します。 (継承元 ConfigurationElement)
Item[String]	この構成要素のプロパティ、属性、または子要素を取得または設定します。 (継承元 ConfigurationElement)
LockAllAttributesExcept	ロックされた属性のコレクションを取得します。 (継承元 ConfigurationElement)
LockAllElementsExcept	ロックされた要素のコレクションを取得します。 (継承元 ConfigurationElement)
LockAttributes	ロックされた属性のコレクションを取得します。 (継承元 ConfigurationElement)
LockElements	ロックされた要素のコレクションを取得します。 (継承元 ConfigurationElement)
LockItem	要素がロックされているかどうかを示す値を取得または設定します。 (継承元 ConfigurationElement)
MaxBatchGeneratedFileSize	バッチコンパイルごとに生成されるソースファイルの最大結合サイズを取得または設定します。
MaxBatchSize	バッチコンパイルあたりの最大ページ数を取得または設定します。
MaxConcurrentCompilations	[コンパイル] セクションの "maxConcurrentCompilations" 構成値が設定されているかどうかを取得または設定します。
NumRecompilesBeforeAppRestart	アプリケーションの再起動前に発生する可能性があるリソースの動的再コンパイルの数を取得または設定します。
OptimizeCompilations	コンパイルを最適化する必要があるかどうかを示す値を取得または設定します。
ProfileGuidedOptimizations	アプリケーションがデプロイされた環境用に最適化されているかどうかを示す値を取得または設定します。
Properties	プロパティのコレクションを取得します。 (継承元 ConfigurationElement)
SectionInformation	SectionInformation オブジェクトのカスタマイズ不可能な情報と機能を含むConfigurationSection オブジェクトを取得します。 (継承元 ConfigurationSection)
Strict	Visual Basic `strict` コンパイルオプションを取得または設定します。
TargetFramework	Web サイトが対象とする .NET Framework のバージョンを取得または設定します。
TempDirectory	コンパイル時に一時ファイルストレージに使用するディレクトリを指定する値を取得または設定します。
UrlLinePragmas	コンパイラへの命令で物理パスまたは URL を使用するかどうかを示す値を取得または設定します。

メソッド

名前	説明
DeserializeElement(XmlReader, Boolean)	構成ファイルから XML を読み取ります。 (継承元 ConfigurationElement)
DeserializeSection(XmlReader)	構成ファイルから XML を読み取ります。 (継承元 ConfigurationSection)
Equals(Object)	現在の ConfigurationElement インスタンスを指定したオブジェクトと比較します。 (継承元 ConfigurationElement)
GetHashCode()	現在の ConfigurationElement インスタンスを表す一意の値を取得します。 (継承元 ConfigurationElement)
GetRuntimeObject()	派生クラスでオーバーライドされると、カスタムオブジェクトを返します。 (継承元 ConfigurationSection)
GetTransformedAssemblyString(String)	指定したアセンブリ名の変換されたバージョンを返します。 (継承元 ConfigurationElement)
GetTransformedTypeString(String)	指定した型名の変換されたバージョンを返します。 (継承元 ConfigurationElement)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
Init()	ConfigurationElement オブジェクトを初期状態に設定します。 (継承元 ConfigurationElement)
InitializeDefault()	ConfigurationElement オブジェクトの既定の値セットを初期化するために使用します。 (継承元 ConfigurationElement)
IsModified()	この構成要素が最後に保存されてから変更されたか、派生クラスに実装されたときに読み込まれたかを示します。 (継承元 ConfigurationSection)
IsReadOnly()	ConfigurationElement オブジェクトが読み取り専用かどうかを示す値を取得します。 (継承元 ConfigurationElement)
ListErrors(IList)	この ConfigurationElement オブジェクトおよびすべてのサブ要素の無効なプロパティエラーを、渡されたリストに追加します。 (継承元 ConfigurationElement)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
OnDeserializeUnrecognizedAttribute(String, String)	逆シリアル化中に不明な属性が検出されたかどうかを示す値を取得します。 (継承元 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	逆シリアル化中に不明な要素が検出されたかどうかを示す値を取得します。 (継承元 ConfigurationElement)
OnRequiredPropertyNotFound(String)	必要なプロパティが見つからない場合に例外をスローします。 (継承元 ConfigurationElement)
PostDeserialize()	逆シリアル化後に呼び出されます。 (継承元 ConfigurationElement)
PreSerialize(XmlWriter)	シリアル化の前に呼び出されます。 (継承元 ConfigurationElement)
Reset(ConfigurationElement)	ロックやプロパティコレクションなど、 ConfigurationElement オブジェクトの内部状態をリセットします。 (継承元 ConfigurationElement)
ResetModified()	派生クラスで実装されたときに IsModified() メソッドの値を `false` にリセットします。 (継承元 ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	派生クラスで実装されている場合、この構成要素の内容を構成ファイルに書き込みます。 (継承元 ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	ファイルに書き込む単一のセクションとして、 ConfigurationSection オブジェクトの結合されていないビューを含む XML 文字列を作成します。 (継承元 ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)	派生クラスで実装されるときに、この構成要素の外部タグを構成ファイルに書き込みます。 (継承元 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	プロパティを指定した値に設定します。 (継承元 ConfigurationElement)
SetReadOnly()	IsReadOnly() オブジェクトとすべてのサブ要素のConfigurationElement プロパティを設定します。 (継承元 ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)	.NET Framework の指定したターゲットバージョンに対して構成オブジェクト階層をシリアル化するときに、指定した要素をシリアル化するかどうかを示します。 (継承元 ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)	.NET Framework の指定したターゲットバージョンに対して構成オブジェクト階層をシリアル化するときに、指定したプロパティをシリアル化する必要があるかどうかを示します。 (継承元 ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)	.NET Framework の指定したターゲットバージョンに対して構成オブジェクト階層をシリアル化するときに、現在の ConfigurationSection インスタンスをシリアル化するかどうかを示します。 (継承元 ConfigurationSection)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	ConfigurationElement オブジェクトを変更して、保存すべきでないすべての値を削除します。 (継承元 ConfigurationElement)

適用対象

こちらもご覧ください

フィードバック

このページはお役に立ちましたか?