(0) exportieren Drucken
Alle erweitern

UpdateCheckInfo-Klasse

Aktualisiert: November 2007

Stellt ausführliche, durch einen Aufruf von CheckForDetailedUpdate erhaltene Aktualisierungsinformationen dar.

Namespace:  System.Deployment.Application
Assembly:  System.Deployment (in System.Deployment.dll)

public class UpdateCheckInfo
public class UpdateCheckInfo
public class UpdateCheckInfo

Mithilfe von UpdateCheckInfo können Sie entscheiden, ob Ihre ClickOnce-Anwendung abhängig von Informationen über die neueste Version aktualisiert werden soll. UpdateAvailable gibt einen booleschen Wert zurück, der angibt, ob überhaupt eine neue Aktualisierung vorliegt. Die AvailableVersion-Eigenschaft ermittelt die Versionsnummer der neuen Version. MinimumRequiredVersion dagegen ermittelt die älteste Version, die der Benutzer installiert haben muss. IsUpdateRequired drückt aus, ob der Benutzer das neueste verfügbare Update benötigt. UpdateSizeBytes schließlich drückt die Gesamtgröße der Aktualisierung aus.

ms137123.alert_note(de-de,VS.90).gifHinweis:

Visual Studio fügt dem Manifest das <deploymentProvider>-Element nur zu, wenn die Anwendung auf das Suchen nach Updates festgelegt ist. Daher müssen Sie das Kontrollkästchen Die Anwendung soll nach Updates suchen aktivieren oder im Dialogfeld "Anwendungsupdates" unter Aktualisierungspfad eine Update-URL angeben.

Im folgenden Codebeispiel wird mithilfe von UpdateAvailable ermittelt, ob ein neues Anwendungsupdate vorliegt, und mithilfe von IsUpdateRequired wird ermittelt, ob der Benutzer aufgefordert werden soll, das Update zu installieren.

private void InstallUpdateSyncWithInfo()
{
    UpdateCheckInfo info = null;

    if (ApplicationDeployment.IsNetworkDeployed)
    {
        ApplicationDeployment ad = ApplicationDeployment.CurrentDeployment;

        try
        {
            info = ad.CheckForDetailedUpdate();

        }
        catch (DeploymentDownloadException dde)
        {
            MessageBox.Show("The new version of the application cannot be downloaded at this time. \n\nPlease check your network connection, or try again later. Error: " + dde.Message);
            return;
        }
        catch (InvalidDeploymentException ide)
        {
            MessageBox.Show("Cannot check for a new version of the application. The ClickOnce deployment is corrupt. Please redeploy the application and try again. Error: " + ide.Message);
            return;
        }
        catch (InvalidOperationException ioe)
        {
            MessageBox.Show("This application cannot be updated. It is likely not a ClickOnce application. Error: " + ioe.Message);
            return;
        }

        if (info.UpdateAvailable)
        {
            Boolean doUpdate = true;

            if (!info.IsUpdateRequired)
            {
                DialogResult dr = MessageBox.Show("An update is available. Would you like to update the application now?", "Update Available", MessageBoxButtons.OKCancel);
                if (!(DialogResult.OK == dr))
                {
                    doUpdate = false;
                }
            }
            else
            {
                // Display a message that the app MUST reboot. Display the minimum required version.
                MessageBox.Show("This application has detected a mandatory update from your current " + 
                    "version to version " + info.MinimumRequiredVersion.ToString() + 
                    ". The application will now install the update and restart.", 
                    "Update Available", MessageBoxButtons.OK, 
                    MessageBoxIcon.Information);
            }

            if (doUpdate)
            {
                try
                {
                    ad.Update();
                    MessageBox.Show("The application has been upgraded, and will now restart.");
                    Application.Restart();
                }
                catch (DeploymentDownloadException dde)
                {
                    MessageBox.Show("Cannot install the latest version of the application. \n\nPlease check your network connection, or try again later. Error: " + dde);
                    return;
                }
            }
        }
    }
}


System.Object
  System.Deployment.Application.UpdateCheckInfo

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft