Bagikan melalui


ClientSettingsProvider Kelas

Definisi

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
ClientSettingsProvider
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.

Berlaku untuk

Lihat juga