Bagikan melalui

Skema Pengaturan Aplikasi

  • Artikel

Pengaturan aplikasi memungkinkan aplikasi Formulir Windows atau ASP.NET untuk menyimpan dan mengambil pengaturan yang terlingkup aplikasi dan cakupan pengguna. Dalam konteks ini, pengaturan adalah informasi apa pun yang mungkin spesifik untuk aplikasi atau khusus untuk pengguna saat ini - apa pun dari string koneksi database ke ukuran jendela default pilihan pengguna.

Secara default, pengaturan aplikasi dalam aplikasi Formulir Windows menggunakan kelas LocalFileSettingsProvider, yang menggunakan sistem konfigurasi .NET untuk menyimpan pengaturan dalam file konfigurasi XML. Untuk informasi selengkapnya tentang file yang digunakan oleh pengaturan aplikasi, lihat Arsitektur Pengaturan Aplikasi.

Penting

Sebagian besar bagian konfigurasi yang ditentukan oleh .NET Framework tidak lagi berfungsi dalam versi .NET 6+ dan .NET Core. ConfigurationManager hanya disediakan untuk kompatibilitas. Alih-alih app.config, .NET modern menggunakan file appsettings.json untuk pengaturan aplikasi. Lihat Memodernisasi setelah memutakhirkan ke .NET dari .NET Framework.

Pertimbangkan untuk menghapus penggunaan di app.config dan memanggil API yang sesuai, jika tersedia, untuk membuat pengaturan yang sama. Untuk informasi selengkapnya, lihat Konfigurasi di .NET.

Pengaturan aplikasi mendefinisikan elemen berikut sebagai bagian dari file konfigurasi yang digunakannya.

Elemen Deskripsi
<applicationSettings> Berisi semua tag <pengaturan> khusus untuk aplikasi.
<userSettings> Berisi semua tag <pengaturan> khusus untuk pengguna saat ini.
<setting> Menentukan pengaturan. Turunan dari <applicationSettings> atau <userSettings>.
<value> Menentukan nilai pengaturan. Turunan dari <pengaturan>.

Elemen <applicationSettings>

Elemen ini berisi semua tag <pengaturan> yang khusus untuk instans aplikasi pada komputer klien. Ini tidak mendefinisikan atribut mana pun .

Elemen <userSettings>

Elemen ini berisi semua tag <pengaturan> yang khusus untuk pengguna yang saat ini menggunakan aplikasi. Ini tidak mendefinisikan atribut mana pun .

Element <pengaturan>

Elemen ini mendefinisikan pengaturan. Ini memiliki atribut berikut.

Atribut KETERANGAN
nama Harus diisi. ID unik dari pengaturan. Pengaturan yang dibuat melalui Visual Studio disimpan dengan nama ProjectName.Properties.Settings.
serializeAs Harus diisi. Format yang digunakan untuk menserialisasikan nilai ke teks. Nilai yang valid adalah:

- string. Nilai diserialisasikan sebagai string menggunakan TypeConverter.
- xml. Nilai diserialisasikan menggunakan serialisasi XML.
- binary. Nilai diserialisasikan sebagai biner yang dikodekan teks menggunakan serialisasi biner.
- custom. Penyedia pengaturan memiliki pengetahuan yang melekat tentang pengaturan ini dan menserialisasikan dan mendeserialisasikannya.

Tambahkan nama untuk pengaturan yang Anda buat di aplikasi Pengaturan> sebagai entri di bawah< elemen configSections> di bagian atas file.< Contohnya:

<configuration>
    <configSections>
        <sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
            <section name="WindowsFormsApp1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" requirePermission="false" />
            <section name="WindowsFormsApp1.Properties.MyCustomSettings" type="System.Configuration.ClientSettingsSection, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" requirePermission="false" />
        </sectionGroup>
    </configSections>
    ...
</configuration>

elemen <nilai>

Elemen ini berisi nilai pengaturan.

Contoh

Contoh berikut menunjukkan file pengaturan aplikasi yang menentukan dua pengaturan cakupan aplikasi dan dua pengaturan yang dicakup pengguna:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">
      <section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
    </sectionGroup>
    <sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">
      <section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" />
    </sectionGroup>
  </configSections>
  <applicationSettings>
    <WindowsApplication1.Properties.Settings>
      <setting name="Cursor" serializeAs="String">
        <value>Default</value>
      </setting>
      <setting name="DoubleBuffering" serializeAs="String">
        <value>False</value>
      </setting>
    </WindowsApplication1.Properties.Settings>
  </applicationSettings>
  <userSettings>
    <WindowsApplication1.Properties.Settings>
      <setting name="FormTitle" serializeAs="String">
        <value>Form1</value>
      </setting>
      <setting name="FormSize" serializeAs="String">
        <value>595, 536</value>
      </setting>
    </WindowsApplication1.Properties.Settings>
  </userSettings>
</configuration>

Baca juga