Udostępnij za pośrednictwem

ConnectivityStatus.IsOffline Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.ClientServices
Zestaw:
System.Web.Extensions.dll

Pobiera lub ustawia wartość wskazującą, czy aplikacja jest w trybie offline.

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

Wartość właściwości

Boolean

true jeśli aplikacja jest w trybie offline; w przeciwnym razie , false.

Przykłady

Poniższy przykładowy kod pokazuje, jak za pomocą tej właściwości zaktualizować stan offline w zależności od wartości pola wyboru. W tym przykładzie CheckedChanged program obsługi zdarzeń aktualizuje stan offline. Jeśli użytkownik ustawi aplikację na stan online, program obsługi zdarzeń próbuje ponownie odnowić użytkownika. Jeśli jednak serwer uwierzytelniania jest niedostępny, program obsługi zdarzeń zwraca aplikację do stanu 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

Uwagi

Po ustawieniu IsOffline właściwości ConnectivityStatus klasa buforuje wartość w lokalnym systemie plików. Dostawcy usług klienckich w System.Web.ClientServices.Providers przestrzeni nazw sprawdzają tę wartość, aby określić, czy używać pamięci podręcznej danych offline, zamiast próbować uzyskać dostęp do skojarzonego uwierzytelniania, ról i usług profilu firmy Microsoft.

Dotyczy

Zobacz też