Bagikan melalui

Mengonfigurasi aplikasi dengan menggunakan file konfigurasi

Nota

Artikel ini khusus untuk .NET Framework. Ini tidak berlaku untuk implementasi .NET yang lebih baru, termasuk .NET 6 dan versi yang lebih baru.

.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 yang dilindungi mana yang dapat diakses aplikasi, versi rakitan mana yang akan digunakan aplikasi, dan tempat 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.

Nota

Kode terkelola dapat menggunakan kelas di namespace System.Configuration untuk membaca pengaturan dari file konfigurasi, tetapi tidak untuk 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-elemen turunan</runtime>. Elemen kosong akan ditulis sebagai <runtime/> atau <runtime></runtime>.

Seperti semua file XML, sintaks dalam file konfigurasi peka terhadap perbedaan huruf besar dan huruf 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 assembly (untuk informasi selengkapnya, lihat Menentukan Lokasi Assembly).

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

File konfigurasi mesin

File konfigurasi komputer, Machine.config, berisi pengaturan yang berlaku untuk seluruh komputer. File ini terletak di jalur penginstalan runtime %%direktori \Config. Machine.config berisi pengaturan konfigurasi untuk pengikatan rakitan 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 klien dan aplikasi 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.

Nota

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

Untuk informasi selengkapnya tentang cara runtime bahasa umum (Common Language Runtime) menggunakan file konfigurasi komputer untuk pengikatan perakitan, lihat Cara Runtime Menemukan Perakitan.

File konfigurasi aplikasi

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

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.

    Secara default, nama file konfigurasi sumber App.config. Saat Anda membuat proyek .NET Framework di Visual Studio, file App.config secara otomatis ditambahkan ke proyek. Anda juga dapat menambahkan file secara manual dengan memilih File>File Baru. Tempatkan file App.config di direktori proyek dan atur properti Salin Ke Direktori Output ke Salin selalu atau Salin jika lebih baru.

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

    Dalam beberapa kasus, Visual Studio mungkin memodifikasi file konfigurasi output. Untuk informasi selengkapnya, lihat Mengalihkan versi di tingkat aplikasi.

  • Aplikasi yang dihosting dengan ASP.NET.

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

File konfigurasi keamanan

File konfigurasi keamanan berisi informasi tentang hierarki grup kode dan set 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.

Nota

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: %%\Config\Enterprisesec.config runtime-install-path

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

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

Lihat juga