ClientSettingsProvider Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.ClientServices.Providers

Bütünleştirilmiş Kod:: System.Web.Extensions.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Windows tabanlı uygulamaların bir Web ayarları hizmetinden kullanıcı ayarlarını almasını sağlar.

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

Devralma: Object

ProviderBase

SettingsProvider
ClientSettingsProvider

Öznitelikler: SecurityCriticalAttribute

Uygulamalar: IApplicationSettingsProvider

Örnekler

Aşağıdaki örnek kod, başarıyla kaydedilmeyen ayarların listesini görüntülemek için bu olayın nasıl kullanılacağını gösterir.

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

Açıklamalar

Uygulamanızı sınıfını kullanacak şekilde yapılandırarak mevcut bir Web ayarları hizmetinden kullanıcı ayarlarını almak için ClientSettingsProvider istemci uygulama hizmetlerini kullanabilirsiniz. Yapılandırmadan sonra, sınıfından ApplicationSettingsBase türetilen ve sınıfı kullanmak ClientSettingsProvider üzere yapılandırılan bir uygulama ayarları sınıfı aracılığıyla kullanıcı ayarlarını alabilir ve ayarlayabilirsiniz. Visual Studio'yu kullanarak projeniz için bir Settings sınıf oluşturabilirsiniz (C# ve My.Settings Visual Basic'te olduğu gibi Properties.Settings.Default erişilir). Uygulama ayarları hakkında daha fazla bilgi için bkz. Uygulama Ayarlarına Genel Bakış.

Anahtar olarak tam ClientSettingsProvider sınıf adını kullanarak özelliği aracılığıyla ApplicationSettingsBase.Providers geçerli ClientSettingsProvider değerini alabilirsiniz. Olayı işlerken ApplicationSettingsBase.SettingsLoaded sağlayıcıyı SettingsLoadedEventArgs.Provider özelliği aracılığıyla da alabilirsiniz.

Not

Bu sınıf, sınıfın tüm üyeleri için geçerli olan sınıf düzeyinde bir SecurityCriticalAttribute içerir. Hemen çağıran güvenlik saydam veya kısmen güvenilir ise bir çalışma zamanı özel durumu oluşturulur. Güvenlik açısından kritik türler ve üyeler hakkında daha fazla bilgi için bkz . Güvenlik Saydam Kodu, Düzey 2.

Not

Bu sınıf, tüm üyeler için geçerli olan sınıf düzeyinde bir devralma talebi içerir. SecurityException Türetilen sınıfın tam güven izni olmadığında oluşturulur. Güvenlik talepleri hakkında ayrıntılı bilgi için bkz. Talepler ve Devralma Taleplerini Bağlama.

Oluşturucular

ClientSettingsProvider()

ClientSettingsProvider sınıfının yeni bir örneğini başlatır.

Özellikler

ApplicationName	Bu özellik bu sınıf tarafından kullanılmaz.
Description	Yönetim araçlarında veya diğer kullanıcı arabirimlerinde (UI) görüntülenmeye uygun kısa ve kolay bir açıklama alır. (Devralındığı yer: ProviderBase)
Name	Yapılandırma sırasında sağlayıcıya başvurmak için kullanılan kolay adı alır. (Devralındığı yer: ProviderBase)
ServiceUri	Web ayarları hizmet konumunu alır veya ayarlar.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetPreviousVersion(SettingsContext, SettingsProperty)	Belirtilen özelliğin önceki sürümünü alır.
GetPropertyMetadata(String)	Belirtilen Web ayarları hizmetinden alınan tüm özellikler için bir meta veri koleksiyonu alır.
GetPropertyValues(SettingsContext, SettingsPropertyCollection)	Belirtilen uygulama örneği ve ayarlar özellik grubu için ayarlar özellik değerlerinin koleksiyonunu döndürür.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
Initialize(String, NameValueCollection)	Sağlayıcıyı başlatır.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
Reset(SettingsContext)	Tüm kullanıcı ayarlarını varsayılan değerlerine sıfırlar.
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)	Belirtilen özellik ayarları grubunun değerlerini ayarlar.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
Upgrade(SettingsContext, SettingsPropertyCollection)	Bu yöntem bu sınıf tarafından kullanılmaz.

Ekinlikler

SettingsSaved

Ayarlar sağlayıcısı özellik değerlerini Web ayarları hizmetine kaydetmeye çalıştığında gerçekleşir.

Şunlara uygulanır

Aracılığıyla paylaş