ConnectivityStatus Classe

Definição

public ref class ConnectivityStatus abstract sealed

public static class ConnectivityStatus

type ConnectivityStatus = class

Public Class ConnectivityStatus

Herança

Object

ConnectivityStatus

Exemplos

O seguinte código de exemplo demonstra como usar esta classe para atualizar o estado offline dependendo do valor de uma caixa de seleção. Neste exemplo, um CheckedChanged gestor de eventos atualiza o estado offline. Se o utilizador definir a aplicação para o estado online, o gestor de eventos tenta revalidar o utilizador. No entanto, se o servidor de autenticação não estiver disponível, o gestor de eventos devolve a aplicação ao estado offline.

private void workOfflineCheckBox_CheckedChanged(
    object sender, EventArgs e)
{
    ConnectivityStatus.IsOffline = workOfflineCheckBox.Checked;
    if (!ConnectivityStatus.IsOffline)
    {
        try
        {
            // Silently re-validate the user.
            ((ClientFormsIdentity)
                System.Threading.Thread.CurrentPrincipal.Identity)
                .RevalidateUser();

            // If any settings have been changed locally, save the new
            // new values to the Web settings service.
            SaveSettings();

            // If any settings have not been changed locally, check 
            // the Web settings service for updates. 
            Properties.Settings.Default.Reload();
        }
        catch (System.Net.WebException)
        {
            MessageBox.Show(
                "Unable to access the authentication service. " +
                Environment.NewLine + "Staying in offline mode.",
                "Warning", MessageBoxButtons.OK, 
                MessageBoxIcon.Warning);
            workOfflineCheckBox.Checked = true;
        }
    }
}

Private Sub workOfflineCheckBox_CheckedChanged( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles workOfflineCheckBox.CheckedChanged

    ConnectivityStatus.IsOffline = workOfflineCheckBox.Checked
    If Not ConnectivityStatus.IsOffline Then

        Try

            ' Silently re-validate the user.
            CType(System.Threading.Thread.CurrentPrincipal.Identity,  _
                ClientFormsIdentity).RevalidateUser()

            ' If any settings have been changed locally, save the new
            ' new values to the Web settings service.
            SaveSettings()

            ' If any settings have not been changed locally, check 
            ' the Web settings service for updates. 
            My.Settings.Reload()

        Catch ex As System.Net.WebException

            MessageBox.Show( _
                "Unable to access the authentication service. " & _
                Environment.NewLine + "Staying in offline mode.", _
                "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)
            workOfflineCheckBox.Checked = True

        End Try

    End If
End Sub

Observações

Use a classe ConnectivityStatus para especificar a conectividade de rede de aplicações baseadas em Windows que utilizam serviços de aplicação cliente. Quando defines a IsOffline propriedade para true, os fornecedores de serviços clientes usam a cache offline em vez de tentarem aceder aos serviços Web correspondentes. O estado offline é armazenado por utilizador e por aplicação. Para mais informações, consulte Como: Trabalhar Offline com Serviços de Aplicações para Clientes.

Ver também

• RevalidateUser()
• Serviços de Aplicações para Clientes