ClientSettingsProvider Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengaktifkan aplikasi berbasis Windows untuk mengambil pengaturan pengguna dari layanan pengaturan Web.
public ref class ClientSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProvider
public class ClientSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider
[System.Security.SecurityCritical]
public class ClientSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider
type ClientSettingsProvider = class
inherit SettingsProvider
interface IApplicationSettingsProvider
[<System.Security.SecurityCritical>]
type ClientSettingsProvider = class
inherit SettingsProvider
interface IApplicationSettingsProvider
Public Class ClientSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider
- Warisan
- Atribut
- Penerapan
Contoh
Contoh kode berikut menunjukkan cara menggunakan kejadian ini untuk menampilkan daftar pengaturan yang tidak berhasil disimpan.
private void AttachSettingsSavedEventHandler()
{
((ClientSettingsProvider)Properties.Settings.Default.Providers
["System.Web.ClientServices.Providers.ClientSettingsProvider"])
.SettingsSaved +=
new EventHandler<SettingsSavedEventArgs>(Form1_SettingsSaved);
}
private void Form1_SettingsSaved(object sender,
SettingsSavedEventArgs e)
{
// If any settings were not saved, display a list of them.
if (e.FailedSettingsList.Count > 0)
{
String failedSettings = String.Join(
Environment.NewLine,
e.FailedSettingsList.ToArray());
String message = String.Format("{0}{1}{1}{2}",
"The following setting(s) were not saved:",
Environment.NewLine, failedSettings);
MessageBox.Show(message, "Unable to save settings",
MessageBoxButtons.OK, MessageBoxIcon.Warning);
}
}
Private WithEvents settingsProvider As ClientSettingsProvider = My.Settings _
.Providers("System.Web.ClientServices.Providers.ClientSettingsProvider")
Private Sub Form1_SettingsSaved(ByVal sender As Object, _
ByVal e As SettingsSavedEventArgs) _
Handles settingsProvider.SettingsSaved
' If any settings were not saved, display a list of them.
If e.FailedSettingsList.Count > 0 Then
Dim failedSettings As String = String.Join( _
Environment.NewLine, e.FailedSettingsList.ToArray())
Dim message As String = String.Format("{0}{1}{1}{2}", _
"The following setting(s) were not saved:", _
Environment.NewLine, failedSettings)
MessageBox.Show(message, "Unable to save settings", _
MessageBoxButtons.OK, MessageBoxIcon.Warning)
End If
End Sub
Keterangan
Anda dapat menggunakan layanan aplikasi klien untuk mengambil pengaturan pengguna dari layanan pengaturan Web yang ada dengan mengonfigurasi aplikasi Anda untuk menggunakan ClientSettingsProvider kelas . Setelah konfigurasi, Anda bisa mendapatkan dan mengatur pengaturan pengguna melalui kelas pengaturan aplikasi yang berasal dari ApplicationSettingsBase dan dikonfigurasi untuk menggunakan ClientSettingsProvider kelas . Anda dapat menggunakan Visual Studio untuk membuat Settings
kelas untuk proyek Anda (diakses seperti Properties.Settings.Default
di C# dan My.Settings
di Visual Basic). Untuk informasi selengkapnya tentang pengaturan aplikasi, lihat Gambaran Umum Pengaturan Aplikasi.
Anda dapat mengambil arus ClientSettingsProvider melalui ApplicationSettingsBase.Providers properti menggunakan nama kelas yang sepenuhnya memenuhi syarat ClientSettingsProvider sebagai kunci. Anda juga dapat mengambil penyedia melalui SettingsLoadedEventArgs.Provider properti saat menangani ApplicationSettingsBase.SettingsLoaded peristiwa.
Catatan
Kelas ini berisi SecurityCriticalAttribute di tingkat kelas yang berlaku untuk semua anggota kelas. Pengecualian run-time dilemparkan jika penelepon langsung transparan keamanan atau sebagian tepercaya. Untuk informasi selengkapnya tentang jenis dan anggota penting keamanan, lihat Kode Transparan Keamanan, Tingkat 2.
Catatan
Kelas ini berisi permintaan warisan di tingkat kelas yang berlaku untuk semua anggota. SecurityException dilemparkan ketika kelas turunan tidak memiliki izin kepercayaan penuh. Untuk detail tentang tuntutan keamanan, lihat Permintaan Tautan dan Permintaan Warisan.
Konstruktor
ClientSettingsProvider() |
Menginisialisasi instans baru kelas ClientSettingsProvider. |
Properti
ApplicationName |
Properti ini tidak digunakan oleh kelas ini. |
Description |
Mendapatkan deskripsi singkat dan ramah yang cocok untuk ditampilkan di alat administratif atau antarmuka pengguna (UI) lainnya. (Diperoleh dari ProviderBase) |
Name |
Mendapatkan nama yang mudah diingat yang digunakan untuk merujuk ke penyedia selama konfigurasi. (Diperoleh dari ProviderBase) |
ServiceUri |
Mendapatkan atau menyetel lokasi layanan pengaturan Web. |
Metode
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetPreviousVersion(SettingsContext, SettingsProperty) |
Mendapatkan versi sebelumnya dari properti yang ditentukan. |
GetPropertyMetadata(String) |
Mendapatkan kumpulan metadata untuk semua properti yang diambil dari layanan pengaturan Web yang ditentukan. |
GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Mengembalikan kumpulan nilai properti pengaturan untuk instans aplikasi dan grup properti pengaturan yang ditentukan. |
GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
Initialize(String, NameValueCollection) |
Menginisialisasi penyedia. |
MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
Reset(SettingsContext) |
Mereset semua pengaturan pengguna ke nilai default mereka. |
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Mengatur nilai dari grup pengaturan properti yang ditentukan. |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Upgrade(SettingsContext, SettingsPropertyCollection) |
Metode ini tidak digunakan oleh kelas ini. |
Acara
SettingsSaved |
Terjadi setelah penyedia pengaturan mencoba menyimpan nilai properti ke layanan pengaturan Web. |