ConnectivityStatus Klasse

Definition

Namespace:

System.Web.ClientServices

Assembly:

System.Web.Extensions.dll

Stellt den Status der Netzwerkverbindung einer Anwendung dar.

public ref class ConnectivityStatus abstract sealed

public static class ConnectivityStatus

type ConnectivityStatus = class

Public Class ConnectivityStatus

Vererbung

Object

ConnectivityStatus

Beispiele

Der folgende Beispielcode veranschaulicht, wie Diese Klasse verwendet wird, um die Offline-status abhängig von einem Kontrollkästchenwert zu aktualisieren. In diesem Beispiel aktualisiert ein CheckedChanged Ereignishandler die Offline-status. Wenn der Benutzer die Anwendung auf den Onlinezustand festlegt, versucht der Ereignishandler, den Benutzer erneut zu überprüfen. Wenn der Authentifizierungsserver jedoch nicht verfügbar ist, gibt der Ereignishandler die Anwendung in den Offlinezustand zurück.

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

Hinweise

Verwenden Sie die ConnectivityStatus -Klasse, um die Netzwerkkonnektivität von Windows-basierten Anwendungen anzugeben, die Clientanwendungsdienste verwenden. Wenn Sie die IsOffline -Eigenschaft auf truefestlegen, verwenden die Clientdienstanbieter den Offlinecache, anstatt auf die entsprechenden Webdienste zuzugreifen. Die Offline-status wird auf Benutzer- und Anwendungsbasis gespeichert. Weitere Informationen finden Sie unter Vorgehensweise: Offline arbeiten mit Clientanwendungsdiensten.

Eigenschaften

IsOffline

Ruft einen Wert ab, der angibt, ob sich eine Anwendung im Offlinemodus befindet, oder legt diesen fest.

Weitere Informationen

• RevalidateUser()
• Clientanwendungsdienste