SettingsSavedEventArgs 類別

  • 參考

定義

命名空間:
System.Web.ClientServices.Providers
組件:
System.Web.Extensions.dll

提供 SettingsSaved 事件的資料。

public ref class SettingsSavedEventArgs : EventArgs
public class SettingsSavedEventArgs : EventArgs
type SettingsSavedEventArgs = class
    inherit EventArgs
Public Class SettingsSavedEventArgs
Inherits EventArgs
繼承
Object
EventArgs
SettingsSavedEventArgs

範例

下列範例程式碼示範如何使用這個類別來顯示未成功儲存的設定清單。

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

備註

此 ClientSettingsProvider.SettingsSaved 事件會在設定提供者存取設定服務之後發生，即使設定未成功儲存也一樣。 提供者可能無法儲存設定的其中一個原因是目前使用者已登出。您可以使用 FailedSettingsList 屬性來判斷是否未成功儲存任何設定。

如果設定提供者無法存取設定服務，這會導致提供者擲回 WebException ，則不會發生此事件。

如需如何處理事件的詳細資訊，請參閱 處理和引發事件。

建構函式

SettingsSavedEventArgs(IEnumerable<String>)

初始化 SettingsSavedEventArgs 類別的新執行個體。

屬性

FailedSettingsList

取得 ClientSettingsProvider 無法儲存至伺服器的設定。

方法

Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetType()

取得目前執行個體的 Type。

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)

適用於

另請參閱