Mengonfigurasi aplikasi dengan menggunakan file konfigurasi

  • Artikel

.NET Framework memberi pengembang dan administrator kontrol dan fleksibilitas atas cara aplikasi berjalan melalui file konfigurasi. File konfigurasi adalah file XML yang dapat diubah sesuai kebutuhan. Administrator dapat mengontrol sumber daya terlindungi mana yang dapat diakses aplikasi, versi rakitan mana yang akan digunakan aplikasi, dan di mana aplikasi dan objek jarak jauh berada. Pengembang dapat menempatkan pengaturan dalam file konfigurasi, menghilangkan kebutuhan untuk mengkompilasi ulang aplikasi setiap kali pengaturan berubah. Bagian ini menjelaskan apa yang dapat dikonfigurasi dan mengapa mengonfigurasi aplikasi mungkin berguna.

Catatan

Kode terkelola dapat menggunakan kelas di System.Configuration namespace untuk membaca pengaturan dari file konfigurasi, tetapi tidak menulis pengaturan ke file tersebut.

Artikel ini menguraikan sintaks file konfigurasi dan menyediakan informasi tentang tiga jenis file konfigurasi: mesin, aplikasi, dan keamanan.

Format file konfigurasi

File konfigurasi berisi elemen, yang merupakan struktur data logis yang mengatur informasi konfigurasi. Dalam file konfigurasi, Anda menggunakan tag untuk menandai awal dan akhir elemen. Misalnya, elemen <runtime> terdiri dari <runtime>elemen turunan</runtime>. Elemen kosong akan ditulis sebagai <runtime/> atau <runtime></runtime>.

Seperti semua file XML, sintaks dalam file konfigurasi peka huruf besar/kecil.

Anda menentukan pengaturan konfigurasi menggunakan atribut yang telah ditentukan sebelumnya, yang merupakan pasangan nama/nilai di dalam tag mulai elemen. Contoh berikut menentukan dua atribut (version dan href) untuk <codeBase> elemen , yang menentukan di mana runtime dapat menemukan rakitan (untuk informasi selengkapnya, lihat Menentukan Lokasi Rakitan).

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

File konfigurasi komputer

File konfigurasi komputer, Machine.config, berisi pengaturan yang berlaku untuk seluruh komputer. File ini terletak di direktori %runtime install path%\Config. Machine.config berisi pengaturan konfigurasi untuk pengikatan perakitan di seluruh komputer, saluran jarak jauh bawaan, dan ASP.NET.

Sistem konfigurasi pertama kali melihat file konfigurasi komputer untuk <elemen appSettings> dan bagian konfigurasi lainnya yang mungkin ditentukan pengembang. Kemudian terlihat dalam file konfigurasi aplikasi. Agar file konfigurasi komputer tetap dapat dikelola, yang terbaik adalah menempatkan pengaturan ini dalam file konfigurasi aplikasi. Namun, menempatkan pengaturan dalam file konfigurasi komputer dapat membuat sistem Anda lebih dapat dipertahankan. Misalnya, jika Anda memiliki komponen pihak ketiga yang digunakan aplikasi klien dan server Anda, lebih mudah untuk menempatkan pengaturan untuk komponen tersebut di satu tempat. Dalam hal ini, file konfigurasi komputer adalah tempat yang sesuai untuk pengaturan, sehingga Anda tidak memiliki pengaturan yang sama dalam dua file yang berbeda.

Catatan

Menyebarkan aplikasi menggunakan XCOPY tidak akan menyalin pengaturan dalam file konfigurasi komputer.

Untuk informasi selengkapnya tentang bagaimana runtime bahasa umum menggunakan file konfigurasi komputer untuk pengikatan perakitan, lihat Cara Runtime Menemukan Rakitan.

File konfigurasi aplikasi

File konfigurasi aplikasi berisi pengaturan yang khusus untuk aplikasi. File ini mencakup pengaturan konfigurasi yang dibaca runtime bahasa umum (seperti kebijakan pengikatan perakitan, objek jarak jauh, dan sebagainya), dan pengaturan yang dapat dibaca aplikasi.

Nama dan lokasi file konfigurasi aplikasi bergantung pada host aplikasi, yang dapat menjadi salah satu hal berikut:

  • Aplikasi yang dapat dieksekusi-dihosting.

    Aplikasi ini memiliki dua file konfigurasi: file konfigurasi sumber, yang dimodifikasi oleh pengembang selama pengembangan, dan file output yang didistribusikan dengan aplikasi.

    Saat Anda mengembangkan di Visual Studio, letakkan file konfigurasi sumber untuk aplikasi Anda di direktori proyek dan atur properti Salin Ke Direktori Output ke Salin selalu atau Salin jika lebih baru. Secara default, nama file konfigurasi adalah App.config.

    Untuk membuat file konfigurasi output yang disebarkan dengan aplikasi, Visual Studio menyalin file konfigurasi sumber ke direktori tempat rakitan yang dikompilasi ditempatkan. File ini bernama <yourappname>.exe.config. Misalnya, aplikasi bernama myApp.exe akan memiliki file konfigurasi output bernama myApp.exe.config.

    Dalam beberapa kasus, Visual Studio dapat memodifikasi file konfigurasi output; untuk informasi selengkapnya, lihat bagian Mengalihkan versi rakitan di bagian tingkat aplikasi dari artikel Mengalihkan Versi Rakitan.

  • Aplikasi yang dihosting ASP.NET.

    Untuk informasi selengkapnya tentang file konfigurasi ASP.NET, lihat Pengaturan Konfigurasi ASP.NET.

  • Aplikasi yang dihosting Internet Explorer.

    Jika aplikasi yang dihosting di Internet Explorer memiliki file konfigurasi, lokasi file ini ditentukan dalam <link> tag dengan sintaks berikut: <link rel="*ConfigurationFileName*" href="*location*">

    Dalam tag ini, location adalah URL ke file konfigurasi. Ini mengatur basis aplikasi. File konfigurasi harus terletak di situs web yang sama dengan aplikasi.

File konfigurasi keamanan

File konfigurasi keamanan berisi informasi tentang hierarki grup kode dan kumpulan izin yang terkait dengan tingkat kebijakan. Kami sangat menyarankan Anda menggunakan alat Kebijakan Keamanan Akses Kode (Caspol.exe) untuk memodifikasi kebijakan keamanan untuk memastikan bahwa perubahan kebijakan tidak merusak file konfigurasi keamanan.

Catatan

Dimulai dengan .NET Framework 4, file konfigurasi keamanan hanya ada jika kebijakan keamanan telah diubah.

File konfigurasi keamanan berada di lokasi berikut:

  • File konfigurasi kebijakan perusahaan: %runtime-install-path%\Config\Enterprisesec.config

  • File konfigurasi kebijakan komputer: %runtime-install-path%\Config\Security.config

  • File konfigurasi kebijakan pengguna: %USERPROFILE%\Application data\Microsoft\CLR security config\vxx.xx\Security.config

Lihat juga