Freigeben über

ConnectivityStatus Klasse

  • Referenz

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 Sie diese Klasse verwenden, um den Offlinestatus abhängig von einem Kontrollkästchenwert zu aktualisieren. In diesem Beispiel aktualisiert ein CheckedChanged Ereignishandler den Offlinestatus. Wenn der Benutzer die Anwendung auf den Onlinestatus 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. Der Offlinestatus 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.

Gilt für:

Weitere Informationen