ASP.NET uygulamasının yapılandırmasını düzenleme

  • Makale

Bu makalede, bir ASP.NET uygulamasının Web.config dosyasının nasıl düzenleyebileceğiniz açıklanır.

Orijinal ürün sürümü: ASP.NET
Özgün KB numarası: 815178

Özet

Web.config dosyası, ASP.NET uygulamalarının davranışını tanımlar. ASP.NET dahil olmak üzere Microsoft .NET Framework, uygulamaları yapılandırmak için XML biçimli .config metin dosyalarını kullanır. Bu, geleneksel kayıt defteri ve metatabanı yapılandırma mekanizmalarından ayrılıştır. Şu anda .config dosyaları oluşturmak ve değiştirmek için Microsoft Yönetim Konsolu (MMC) ek bileşeni veya Microsoft tarafından sağlanan başka bir yönetim aracı yoktur.

Web.config yapılandırma ayarlarını ekleme

Çoğu ASP.NET uygulaması, Not Defteri gibi herhangi bir metin düzenleyicisiyle düzenlenebilen önceden oluşturulmuş bir Web.config dosyasıyla birlikte gelir. Genellikle ,Web.config dosyalar, dosyayı kendi kendine açık hale getiren açıklamalar içerir. Ancak, yapılandırma öğesi henüz tanımlanmamış bir Web.config dosyasına yapılandırma öğeleri eklemeniz gerekebilir. Web.config dosyasına standart yapılandırma öğesi eklemek için şu adımları izleyin:

  1. Machine.config dosyasını Not Defteri gibi bir metin düzenleyicisinde açın.

    Machine.config dosyası dizininde %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ bulunur.

  2. Machine.config dosyasında, Web.config dosyanızda geçersiz kılmak istediğiniz yapılandırma ayarını bulun. Öğe birden fazla satır olduğunda, öğe bir <element_name> çizgiyle başlar ve ile </element_name>biter. Öğesi de kendi kendine kapanıyor olabilir ve öğesine <element_name attribute1='option' attribute2='option' />benzer görünebilir. Boşluk yoksayılır. Bu nedenle, öğe birden çok satıra yayılabilir. Öğesinden önce bir açıklama gelebilir. Açıklama, işaretlerin içinde <!-- and --> yer alır. Aşağıdaki <trace> yapılandırma öğesi örneği, kendi kendini kapatan bir öğe örneğidir. Yapılandırma <trace> öğesi örneğinin birden çok özniteliği vardır, birden çok satıra yayılmıştır ve başında bir açıklama vardır.

    <!--
trace Attributes:
    enabled="[true|false]" - Enable application tracing
    localOnly="[true|false]" - View trace results from localhost only
    pageOutput="[true|false]" - Display trace output on individual pages
    requestLimit="[number]" - Number of trace results available in trace.axd
    traceMode="[SortByTime|SortByCategory]" - Sorts trace result displays based on Time or Category
 -->
<trace
    enabled="false"
    localOnly="true"
    pageOutput="false"
    requestLimit="10"
    traceMode="SortByTime"
/>

  3. Yapılandırma öğesinin tamamını ve başlangıç açıklamasını panoya kopyalayın.

  4. öğesinin Machine.config dosyasında nasıl iç içe yerleştirileceğini belirleyin.

    Machine.config dosyası hiyerarşiktir ve yapılandırma öğeleri diğer öğelere iç içe yerleştirilmiştir. Machine.configdosyasından Web.config dosyasına bir yapılandırma öğesi kopyaladığınızda, bu yapılandırma öğesini kopyalandığı öğeye iç içe yerleştirmeniz gerekir. Yapılandırma öğesinin içinde yer aldığı Machine.config dosyasının öğesini belirlemek için, açılan bir öğe bulana kadar Machine.config dosyasında yukarı kaydırın, kapatılmaz. Üst düzey öğelerin girintisi daha az olduğundan, içeren öğenin tanımlanması kolaydır.

    ASP.NET yapılandırma öğelerinin çoğu öğesinde <system.web> yer alır. öğesinin sonu ( </system.web> ) yapılandırma öğenizden sonra yerleştirilmelidir.

    Not

    Yapılandırma öğenizin içinde bulunduğu öğe. Bu öğeyi Web.config dosyasındaki aynı öğeye yapıştırmanız gerekir. Yapılandırma öğesi birden çok öğeye iç içe yerleştirilmiş olabilir. Web.config dosyasında tüm üst düzey öğeleri oluşturmanız gerekir.

  5. Machine.config dosyasını kapatın ve ardından metin düzenleyicinizi kullanarak Web.config dosyasını ASP.NET uygulamanızın kök dizininde açın.

  6. Yapılandırma öğesini, 4. adımda tanımladığınız öğenin başlangıcıyla sonu arasına yapıştırın.

    Örneğin, yapılandırma öğesi öğesinde <system.web> yer alırsa, yapılandırma öğesinin öğenin açılış satırından <system.web> hemen sonra ve kapanış satırından </system.web> önce yapıştırılması gerekir.

  7. Web.config dosyasındaki yapılandırma öğesini değiştirerek uygulamanın Machine.config ayarını geçersiz kılın.

    Bu ayar ,Web.config dosyasını ve tüm alt klasörleri içeren klasör için geçerlidir.

Başvurular