SettingsSavedEventArgs Třída

Reference

Definice

Obor názvů:: System.Web.ClientServices.Providers

Sestavení:: System.Web.Extensions.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje data pro událost SettingsSaved.

public ref class SettingsSavedEventArgs : EventArgs

public class SettingsSavedEventArgs : EventArgs

type SettingsSavedEventArgs = class
    inherit EventArgs

Public Class SettingsSavedEventArgs
Inherits EventArgs

Dědičnost: Object

EventArgs
SettingsSavedEventArgs

Příklady

Následující příklad kódu ukazuje, jak použít tuto třídu k zobrazení seznamu nastavení, které nebyly úspěšně uloženy.

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

Poznámky

Událost ClientSettingsProvider.SettingsSaved nastane, když zprostředkovatel nastavení přistupuje ke službě nastavení, i když se nastavení úspěšně neuložila. Jedním z důvodů, proč se zprostředkovateli nemusí podařit uložit nastavení, je, že byl aktuální uživatel odhlášený. Pomocí vlastnosti můžete FailedSettingsList zjistit, jestli se některá nastavení úspěšně neuložila.

K této události nedojde, pokud zprostředkovatel nastavení nemá přístup ke službě nastavení, což místo toho způsobí, že zprostředkovatel vyvolá WebExceptionvýjimku .

Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.

Konstruktory

SettingsSavedEventArgs(IEnumerable<String>)

Inicializuje novou instanci SettingsSavedEventArgs třídy .

Vlastnosti

FailedSettingsList

Získá nastavení, které ClientSettingsProvider nelze uložit na server.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Platí pro