SettingsSavedEventArgs Classe

  • Referência

Definição

Namespace:
System.Web.ClientServices.Providers
Assembly:
System.Web.Extensions.dll

Fornece dados para o evento de SettingsSaved .

public ref class SettingsSavedEventArgs : EventArgs
public class SettingsSavedEventArgs : EventArgs
type SettingsSavedEventArgs = class
    inherit EventArgs
Public Class SettingsSavedEventArgs
Inherits EventArgs
Herança
Object
EventArgs
SettingsSavedEventArgs

Exemplos

O código de exemplo a seguir demonstra como usar essa classe para exibir uma lista de configurações que não foram salvas com êxito.

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

Comentários

O ClientSettingsProvider.SettingsSaved evento ocorre depois que o provedor de configurações acessa o serviço de configurações, mesmo que as configurações não tenham sido salvas com êxito. Um dos motivos pelos quais o provedor pode não conseguir salvar as configurações é se o usuário atual tiver sido desconectado. Você pode usar a FailedSettingsList propriedade para determinar se as configurações não foram salvas com êxito.

Esse evento não ocorrerá se o provedor de configurações não puder acessar o serviço de configurações, o que, em vez disso, fará com que o provedor gere um WebException.

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.

Construtores

SettingsSavedEventArgs(IEnumerable<String>)

Inicializa uma nova instância da classe SettingsSavedEventArgs.

Propriedades

FailedSettingsList

Obtém as configurações que o ClientSettingsProvider não pôde salvar no servidor.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também