Kompilacja elementu (ASP.Schemat ustawień netto)

Artykuł
06/25/2012

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Konfiguruje wszystkie ustawienia kompilacji, program ASP.NET używa się do kompilowania aplikacji.

<compilation 
   debug="[true|false]"
   batch="[true|false]"
   batchTimeout="number of seconds"
   defaultLanguage="language" 
   explicit="[true|false]" 
   maxBatchSize="maximim number of pages"
   maxBatchGeneratedFileSize="maximum combined size"
   numRecompilesBeforeAppRestart="number"
   strict="[true|false]" 
   tempDirectory="temporary files directory"
   urlLinePragmas="[true|false]"
   optimizeCompilations="[true|false]"
   targetFramework="2.0|3.0|3.5|4.0"
   assemblyPostProcessorType="assembly post processor, assembly"
>
   <assemblies>...</assemblies> 
   <buildProviders>...</buildProviders>
   <folderLevelBuildProviders>...</folderLevelBuildProviders>
   <codeSubDirectories>...</codeSubDirectories>
   <compilers>...</compilers>
   <expressionBuilders>...</expressionBuilders>
</compilation>

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty i elementy podrzędne elementy nadrzędne.

Atrybuty

Atrybut	Opis
assemblyPostProcessorType	Opcjonalny String atrybut. Określa etap samodzielny kompilacji dla zestawu, odwołując się do zgromadzenia procesor. Użyj formatu "zestawu zaksięgować procesor,Zgromadzenia". Zestawu zaksięgować procesor musi implementować IAssemblyPostProcessor interfejsu. Za pomocą tej metody wystawieniu wymusza debugowania na kompilacji, które można zastąpić, określając tryb rozmieszczania. Ten atrybut jest nowego w.NET Framework w wersji 2.0. Wartość domyślna to pusty ciąg.
batch	Opcjonalny Boolean atrybut. Wskazuje, czy jest obsługiwane tworzenie pakietów wsadowych. Jeśli True, eliminuje opóźnienia spowodowane kompilacji, wymagane podczas dostępu do pliku po raz pierwszy. Gdy ten atrybut jest ustawiony na True,ASP.NET prekompiluje wszystkie pliki nie skompilowanego w trybie wsadowym, co powoduje, że nawet dłuższy czas opóźnienia pierwszego, które pliki są kompilowane. Jednak po początkowego opóźnienia opóźnienie kompilacji jest wyeliminowane na dostęp do pliku. Wartością domyślną jest True.
batchTimeout	Opcjonalny TimeSpan atrybut. Określa okres limitu czasu w sekundach dla kompilacji wsadowej. Jeśli w ciągu okresu limitu czasu nie można ukończyć kompilacji, kompilator powraca do trybu kompilacji pojedynczej dla bieżącej strony. Wartością domyślną jest "900" (15 minut).
debug	Opcjonalny Boolean atrybut. Określa, czy skompilować pliki binarne debugowania, a nie pliki binarne detaliczne. Wartością domyślną jest False.
defaultLanguage	Opcjonalny String atrybut. Określa domyślny język programowania, takich jak "C#" lub PERL, aby użyć w dynamicznych plikach kompilacji. Nazwy języków są definiowane za pomocą kompilatory elementu system.codeDom sekcji lub kompilatory element podrzędny tego elementu (przestarzałe). Wartością domyślną jest "vb".
explicit	Opcjonalny Boolean atrybut. Określa, czy ustawić języka Microsoft Visual Basic explicit skompilować opcji. Jeśli True, wszystkie zmienne muszą być zadeklarowane za pomocą Dim, Private, Public, lub ReDim instrukcji. Wartością domyślną jest True.
maxBatchGeneratedFileSize	Opcjonalny Int32 atrybut. Określa maksymalny łączny rozmiar (w Kilobajtach) wygenerowanych plików źródłowych kompilacji wsadowej. Ogólnie rzecz biorąc nie jest idealny do załadowania ogromne zestawu w pamięci, gdy potrzebne są faktycznie mniejszą liczbę bitów. Limit ten pomaga upewnić się, że rozmiar zestawy dzielą się na rozsądnym zakresie, tak, aby aplikacja wykorzystuje mechanizm partii bez przeciążenia systemu. Jest to podobne do maxBatchSize. Wartością domyślną jest 1000.
maxBatchSize	Opcjonalny Int32 atrybut. Określa maksymalną liczbę stron w jednej kompilacji wsadowej. Wartością domyślną jest 1000.
numRecompilesBeforeAppRestart	Opcjonalny Int32 atrybut. Określa liczbę dynamicznych rekompilacji zasobów, które mogą wystąpić przed ponownym uruchomieniem aplikacji. Atrybut ten jest obsługiwany na poziomie globalnym i aplikacji, ale nie na poziomie katalogu. Note ASP.Wzrost netto NumRecompilesBeforeAppRestart właściwość przy każdym zgromadzenie jest unieważnione i nie można usunąć. Wartością domyślną jest 15.
optimizeCompilations	Opcjonalny Boolean atrybut. Określa, czy po zmianie pliku najwyższego poziomu dynamicznej kompilacji ponownie skompiluje całej witryny. Pliki najwyższego poziomu zawierają pliku Global.asax i wszystkie pliki w folderach pojemnika i App_Code. Jeśli True, tylko zmienione pliki są ponownie kompilowana. Wartością domyślną jest False. Aby uzyskać więcej informacji, zobacz Understanding ASP.NET Dynamic Compilation.
strict	Opcjonalny Boolean atrybut. Określa, czy włączyć Visual Basic strict skompilować opcji. Wartością domyślną jest False.
targetFramework	Opcjonalny String atrybut. Określa wersję.NET Framework cele witryny sieci Web. Wartością domyślną jest Null. Jeśli ten atrybut zostanie pominięty, wersja docelowa jest określana przez inne ustawienia w pliku Web.config i puli aplikacji usług IIS, związaną z witryny sieci Web. Aby uzyskać więcej informacji, zobacz CompilationSection.TargetFramework i .NET Framework Targeting for Web Projects.
tempDirectory	Opcjonalny String atrybut. Określa katalog używany do przechowywania plików tymczasowych podczas kompilacji. Wartością domyślną jest ciąg pusty (""). W odniesieniu do pusty ciąg znaków i jeżeli obecny proces ma wymaganych uprawnień dostępu, pliki są przechowywane w %FrameworkInstallLocation%\ Tymczasowe pliki ASP.NET, pliki katalogu. Należy zauważyć, że tylko procesy z wysokim poziomem zaufania uprawnienia mogą uzyskać dostęp do %FrameworkInstallLocation%\ Tymczasowe pliki ASP.NET pliki.
urlLinePragmas	Opcjonalny Boolean atrybut. Określa, czy kompilator należy używać adresów URL, zamiast ścieżek fizycznych. Wartością domyślną jest False.

Elementy podrzędne

Element	Opis
assemblies	Określa zbiór nazw zestawów, które są używane podczas kompilacji aplikacji ASP.NET zasobów.
buildProviders	Definiuje kolekcji dostawców kompilacji, które są wykorzystywane do kompilowania plików zasobów niestandardowych. Aby uzyskać więcej informacji, zobacz BuildProvider klasy.
codeSubDirectories	Definiuje uporządkowaną kolekcję podkatalogi, zawierających pliki, które są kompilowane w czasie wykonywania.
compilers	Określa zbiór opcji kompilatora. Note W.NET Framework w wersji 2.0 i nowsze wersje tego elementu jest zaniechana na rzecz kompilatory elementu system.codeDom sekcji.Jednakże, za pomocą compilers elementu podrzędnego elementu compilation elementu jest nadal ważna i zastępuje compilers element, który znajduje się w system.codedom sekcji.
expressionBuilders	Definiuje Kolekcja ciągów zasobów mają być używane podczas kompilacji. Ciągi zasobów skojarzyć prefiksy z konstruktorów wyrażeń.
folderLevelBuildProviders	Definiuje kolekcji dostawców kompilacji, które są wykorzystywane do kompilowania plików niestandardowych zasobów w określonych folderach. Budowanie dostawców są mapowane do plików o rozszerzeniach i są używane do generowania kodu z plików określonego typu. Aby uzyskać więcej informacji, zobacz FolderLevelBuildProvider klasy.

Elementy nadrzędne

Element	Opis
configuration	Określa element główny wymagane w każdym pliku konfiguracyjnym, który jest używany przez aparatu plików wykonywalnych języka wspólnego i.NET Framework aplikacji.
system.web	Określa element główny dla aplikacji ASP.Ustawienia konfiguracji netto w konfiguracji pliku i zawiera elementy konfiguracyjne określające konfigurację programu ASP.Zachowanie aplikacji sieci Web.

Uwagi

compilation Element konfiguruje wszystkie ustawienia kompilacji, program ASP.NET używa się do kompilowania aplikacji.

W.NET Framework w wersji 2.0, compilers elementu podrzędnego elementu compilation element zostanie zaniechana na rzecz kompilatory elementu system.codeDom sekcji. Jednakże, za pomocą compilers elementu podrzędnego elementu compilation elementu jest nadal ważna i zastępuje compilers element, który znajduje się w system.codedom sekcji.

Domyślna konfiguracja

Następujące domyślne compilation element nie jest jawnie skonfigurowane w pliku Machine.config lub głównego pliku Web.config. Jednakże jest domyślna konfiguracja zwracane przez aplikację. Elementy są dodawane do zespoły, buildProviders, i expressionBuilders kolekcji w pliku Web.config w katalogu głównego.

<compilation 
   tempDirectory="" 
   debug="false" 
   strict="false" 
   explicit="true" 
   batch="true" 
   batchTimeout="900" 
   maxBatchSize="1000" 
   maxBatchGeneratedFileSize="1000" 
   numRecompilesBeforeAppRestart="15" 
   defaultLanguage="vb" 
   urlLinePragmas="false" 
   assemblyPostProcessorType=""
>
   <assemblies>
       <clear />
   </assemblies>
   <buildProviders>
       <clear />
   </buildProviders>
   <expressionBuilders>
       <clear />
   </expressionBuilders>
</compilation>

Następujący element compilation domyślny jest skonfigurowany w pliku Machine.config w.NET Framework w wersji 1.1. W istnieją podobne ustawienia.NET Framework w wersji 1.0, z wyjątkiem numeru wersji.

<compilation debug="false" explicit="true" defaultLanguage="vb">
   <compilers>
      <compiler language="c#;cs;csharp" extension=".cs" type="Microsoft.CSharp.CSharpCodeProvider, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" warningLevel="1"/>
      <compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" type="Microsoft.VisualBasic.VBCodeProvider, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
      <compiler language="js;jscript;javascript" extension=".js" type="Microsoft.JScript.JScriptCodeProvider, Microsoft.JScript, Version=7.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <compiler language="VJ#;VJS;VJSharp" extension=".jsl" type="Microsoft.VJSharp.VJSharpCodeProvider, VJSharpCodeProvider, Version=7.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/></compilers>
   <assemblies>
      <add assembly="mscorlib"/>
      <add assembly="System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
      <add assembly="System.Web, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="System.Data, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
      <add assembly="System.Web.Services, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="System.Xml, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
      <add assembly="System.Drawing, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="System.EnterpriseServices, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="System.Web.Mobile, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="*"/>
   </assemblies>
</compilation>

Przykład

Poniższy przykład kodu demonstruje, jak skonfigurować ustawienia kompilacji dla aplikacji.

<configuration>
   <system.web>
      <compilation defaultLanguage="VB"
         targetFramework="4.0"
         debug="true"
         numRecompilesBeforeAppRestart="15">
         <assemblies>
            <add assembly="ADODB"/>
            <add assembly="*"/>
         </assemblies>

         <codeSubDirectories>
           <add directoryName="mySubDir1"/>
           <add directoryName="mySubDir2"/>
           <add directoryName="mySubDir3"/>
         </codeSubDirectories>

         <buildProviders>
            <buildProvider 
               extension=".mafx" type="BuildProviderType, 
                          BuildProviderAssembly"
            />
        </buildProviders>
     </compilation>
   </system.web>
</configuration>

Informacje o elementach

Program obsługi sekcji konfiguracji	CompilationSection
Członkowskie konfiguracji	Compilation
Lokalizacje konfigurowalne	Machine.config Web.config na poziomie katalogu głównego Poziom aplikacji Web.config Directory–level wirtualnego lub fizycznego Web.config
Wymagania	Microsoft Internet Information Services (IIS) 5.0, 5.1 lub 6.0 .NET Framework 1.0, 1.1, 2.0 Visual Studio 2003 lub Visual Studio 2005

Zobacz też

Udostępnij za pośrednictwem

Kompilacja elementu (ASP.Schemat ustawień netto)

Atrybuty i elementy

Atrybuty

Elementy podrzędne

Elementy nadrzędne

Uwagi

Domyślna konfiguracja

Przykład

Informacje o elementach

Zobacz też

Zadania

Informacje

Koncepcje

Inne zasoby

Dodatkowe zasoby