ConnectivityStatus.IsOffline Eigenschaft

Referenz

Definition

Namespace:: System.Web.ClientServices

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public:
 static property bool IsOffline { bool get(); void set(bool value); };

public static bool IsOffline { get; set; }

static member IsOffline : bool with get, set

Public Shared Property IsOffline As Boolean

Eigenschaftswert

Boolean

true, wenn sich die Anwendung im Offlinemodus befindet, andernfalls false.

Beispiele

Der folgende Beispielcode veranschaulicht, wie diese Eigenschaft verwendet wird, 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 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

Wenn Sie die IsOffline -Eigenschaft festlegen, speichert die ConnectivityStatus -Klasse den Wert im lokalen Dateisystem zwischen. Die Clientdienstanbieter im System.Web.ClientServices.Providers Namespace überprüfen diesen Wert, um zu bestimmen, ob der Offlinedatencache verwendet werden soll, anstatt auf die zugeordneten Microsoft AJAX-Authentifizierungs-, Rollen- und Profildienste zuzugreifen.

Gilt für:

Freigeben über