ClientSettingsProvider Sınıf

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 kaydedilmemiş 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ı kullanacak ClientSettingsProvider şekilde yapılandırılmış bir uygulama ayarları sınıfı aracılığıyla kullanıcı ayarlarını alabilir ve ayarlayabilirsiniz. Projeniz için bir Settings sınıf oluşturmak için Visual Studio'yu kullanabilirsiniz (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ış.

Tam sınıf adını anahtar olarak kullanarak ClientSettingsProvider ö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.

Uyarı

Bu sınıf, sınıfın tüm üyelerine uygulanan sınıf düzeyinde bir SecurityCriticalAttribute içerir. Anlık arayan güvenlik saydam veya kısmen güvenilirse 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. Security-Transparent Code, Düzey 2.

Uyarı

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

Oluşturucular

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

Özellikler

Name	Description
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

Name	Description
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()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
Initialize(String, NameValueCollection)	Sağlayıcıyı başlatır.
MemberwiseClone()	Geçerli Objectbasit 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 bir dize döndürür. (Devralındığı yer: Object)
Upgrade(SettingsContext, SettingsPropertyCollection)	Bu yöntem bu sınıf tarafından kullanılmaz.

Ekinlikler

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

Şunlara uygulanır

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?