Aracılığıyla paylaş

Yapılandırma dosyalarını kullanarak uygulamaları yapılandırma

  • Makale

Not

Bu makale .NET Framework'e özgüdür. .NET 6 ve sonraki sürümleri de dahil olmak üzere daha yeni .NET uygulamaları için geçerli değildir.

.NET Framework, geliştiricilere ve yöneticilere uygulamaların yapılandırma dosyaları üzerinden çalışma şekli üzerinde denetim ve esneklik sağlar. Yapılandırma dosyaları, gerektiğinde değiştirilebilen XML dosyalarıdır. Yönetici, bir uygulamanın erişebileceği korumalı kaynakları, bir uygulamanın hangi derleme sürümlerini kullanacağını ve uzak uygulamaların ve nesnelerin nerede bulunduğunu denetleyebilir. Geliştiriciler yapılandırma dosyalarına ayarlar koyarak bir ayarın her değiştiğinde uygulamayı yeniden derleme gereksinimini ortadan kaldırır. Bu bölümde nelerin yapılandırılabildiği ve bir uygulamayı yapılandırmanın neden yararlı olabileceği açıklanmaktadır.

Not

Yönetilen kod, yapılandırma dosyalarındaki ayarları okumak için System.Configuration ad alanında bulunan sınıfları kullanabilir, ancak bu dosyalara ayar yazamayabilir.

Bu makalede yapılandırma dosyalarının söz dizimi açıklanır ve üç yapılandırma dosyası türü hakkında bilgi sağlanır: makine, uygulama ve güvenlik.

Yapılandırma dosyası biçimi

Yapılandırma dosyaları, yapılandırma bilgilerini ayarlayan mantıksal veri yapıları olan öğeler içerir. Yapılandırma dosyası içinde, bir öğenin başlangıcını ve sonunu işaretlemek için etiketleri kullanırsınız. Örneğin, <runtime> öğesi</runtime><runtime>alt öğeden oluşur. Boş bir öğe <runtime/> veya <runtime></runtime>olarak yazılabilir.

Tüm XML dosyalarında olduğu gibi, yapılandırma dosyalarındaki söz dizimi büyük/küçük harfe duyarlıdır.

Yapılandırma ayarlarını, bir öğenin başlangıç etiketi içindeki ad/değer çiftleri olan önceden tanımlanmış öznitelikleri kullanarak belirtirsiniz. Aşağıdaki örnek, çalışma zamanının bir derlemeyi nerede bulabileceğini belirten <codeBase> öğesi için iki öznitelik (version ve href) belirtir (daha fazla bilgi için bkz. Derlemenin KonumBelirtme ).

<codeBase version="2.0.0.0"
          href="http://www.litwareinc.com/myAssembly.dll"/>

Makine yapılandırma dosyaları

Machine.configmakine yapılandırma dosyası, bilgisayarın tamamına uygulanan ayarları içerir. Bu dosya, \Config dizininde%%çalışma zamanı yükleme yolunda bulunur. Machine.config makine genelinde derleme bağlama, ve ASP.NET yerleşikuzaktan iletişim kanalları için yapılandırma ayarlarını içerir.

Yapılandırma sistemi önce <appSettings> öğesi ve bir geliştiricinin tanımlayabileceği diğer yapılandırma bölümleri için makine yapılandırma dosyasına bakar. Ardından uygulama yapılandırma dosyasına bakar. Makine yapılandırma dosyasını yönetilebilir durumda tutmak için bu ayarları uygulama yapılandırma dosyasına koymak en iyisidir. Ancak, ayarların makine yapılandırma dosyasına konulabilmesi sisteminizin daha sürdürülebilir olmasını sağlayabilir. Örneğin, hem istemci hem de sunucu uygulamanızın kullandığı bir üçüncü taraf bileşeniniz varsa, bu bileşenin ayarlarını tek bir yere yerleştirmek daha kolaydır. Bu durumda, makine yapılandırma dosyası ayarlar için uygun yerdir, bu nedenle iki farklı dosyada aynı ayarlara sahip olmazsınız.

Not

XCOPY kullanarak uygulama dağıtmak, makine yapılandırma dosyasındaki ayarları kopyalamaz.

Ortak dil çalışma zamanının derleme bağlama için makine yapılandırma dosyasını nasıl kullandığı hakkında daha fazla bilgi için bkz. Çalışma Zamanı Derlemeleri Nasıl Bulur .

Uygulama yapılandırma dosyaları

Uygulama yapılandırma dosyası, uygulamaya özgü ayarlar içerir. Bu dosya, ortak dil çalışma zamanı ortamının okuduğu yapılandırma ayarlarını (örneğin, derleme bağlama ilkesi, uzaktan iletişim nesneleri vb.) ve uygulamanın okuyabileceği ayarları içerir.

Uygulama yapılandırma dosyasının adı ve konumu, uygulamanın ana bilgisayarına bağlıdır ve bu da aşağıdakilerden biri olabilir:

  • Yürütülebilir bir sunucuda barındırılan uygulama.

    Bu uygulamaların iki yapılandırma dosyası vardır: geliştirme sırasında geliştirici tarafından değiştirilen bir kaynak yapılandırma dosyası ve uygulamayla birlikte dağıtılan bir çıkış dosyası.

    Varsayılan olarak, kaynak yapılandırma dosyasının adı App.config. Visual Studio'da bir .NET Framework projesi oluşturduğunuzda, projeye otomatik olarak bir App.config dosyası eklenir. Dosya >Yeni Dosyaseçerek dosyayı el ile de ekleyebilirsiniz. App.config dosyasını proje dizinine yerleştirin ve Çıktı Dizinine Kopyala özelliğini, Her zaman kopyala olarak ayarlayın veya Yeniyse kopyalaolarak ayarlayın.

    Uygulamayla dağıtılan çıkış yapılandırma dosyasını oluşturmak için Visual Studio, kaynak yapılandırma dosyasını derlenen derlemenin yerleştirildiği dizine kopyalar. Bu dosya, uygulama adınız>.exe.config<olarak adlandırılır. Örneğin, myApp.exe adlı bir uygulamanın myApp.exe.configadlı bir çıkış yapılandırma dosyası vardır.

    Bazı durumlarda, Visual Studio çıkış yapılandırma dosyasını değiştirebilir. Daha fazla bilgi için bkz. uygulama düzeyinde yeniden yönlendirme sürümleri.

  • ASP. NET tarafından barındırılan uygulama.

    ASP.NET yapılandırma dosyaları hakkında daha fazla bilgi için bkz. yapılandırma ayarları ASP.NET.

Güvenlik yapılandırma dosyaları

Güvenlik yapılandırma dosyaları, bir ilke düzeyiyle ilişkili kod grubu hiyerarşisi ve izin kümeleri hakkında bilgi içerir. İlke değişikliklerinin güvenlik yapılandırma dosyalarını bozmadığından emin olmak için güvenlik ilkesini değiştirmek için Kod Erişimi Güvenlik İlkesi aracını (Caspol.exe) kullanmanızı kesinlikle öneririz.

Not

.NET Framework 4'den başlayarak, güvenlik yapılandırma dosyaları yalnızca güvenlik ilkesi değiştirildiğinde bulunur.

Güvenlik yapılandırma dosyaları aşağıdaki konumlardadır:

  • Kurumsal ilke yapılandırma dosyası: %çalışma zamanı-yükleme yolu%\Config\Enterprisesec.config

  • Makine ilkesi yapılandırma dosyası: %çalışma zamanı-yükleme yolu%\Config\Security.config

  • Kullanıcı ilkesi yapılandırma dosyası: %USERPROFILE%\Application data\Microsoft\CLR security config\vxx.xx\Security.config

Ayrıca bkz.