ConnectivityStatus Classe

Définition

public ref class ConnectivityStatus abstract sealed

public static class ConnectivityStatus

type ConnectivityStatus = class

Public Class ConnectivityStatus

Héritage

Object

ConnectivityStatus

Exemples

L’exemple de code suivant montre comment utiliser cette classe pour mettre à jour le status hors connexion en fonction d’une valeur de zone case activée. Dans cet exemple, un gestionnaire d’événements CheckedChanged met à jour le status hors connexion. Si l’utilisateur définit l’état en ligne de l’application, le gestionnaire d’événements tente de revalider l’utilisateur. Toutefois, si le serveur d’authentification n’est pas disponible, le gestionnaire d’événements retourne l’application à l’état hors connexion.

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

Remarques

Utilisez la ConnectivityStatus classe pour spécifier la connectivité réseau des applications Windows qui utilisent des services d’application client. Lorsque vous définissez la propriété sur IsOfflinetrue, les fournisseurs de services clients utilisent le cache hors connexion au lieu de tenter d’accéder aux services Web correspondants. Le status hors connexion est stocké par utilisateur et par application. Pour plus d’informations, consultez Comment : travailler hors connexion avec les services d’application cliente.

Propriétés

S’applique à

Voir aussi

• RevalidateUser()
• Services d'application cliente