C# Class NetSparkle.Sparkle

Class to communicate with a sparkle-based appcast
Inheritance: IDisposable
Afficher le fichier Open project: Deadpikle/NetSparkle Class Usage Examples

Méthodes publiques

Méthode Description
CancelFileDownload ( ) : void

Cancels the install

CheckForUpdatesAtUserRequest ( ) : Task

Check for updates, using interaction appropriate for if the user just said "check for updates".

CheckForUpdatesQuietly ( ) : Task

Check for updates, using interaction appropriate for where the user doesn't know you're doing it, so be polite

CheckOnFirstApplicationIdle ( ) : void

The app will check once, after the app settles down.

Dispose ( ) : void

Is called in the using context and will stop all background activities

GetAbsoluteUrl ( string url ) : Uri

Converts an relative url to an absolute url based on the

GetApplicationConfig ( ) : NetSparkle.NetSparkleConfiguration

This method reads the local sparkle configuration for the given reference assembly

GetUpdateStatus ( NetSparkle.NetSparkleConfiguration config ) : Task

This method checks if an update is required. During this process the appcast will be downloaded and checked against the reference assembly. Ensure that the calling process has read access to the reference assembly. This method is also called from the background loops.

GetWebContentResponse ( string Url ) : WebResponse

TODO

GetWebContentStream ( string Url ) : Stream

TODO

ReportDiagnosticMessage ( string message ) : void

This method reports a message in the diagnostic window

ShowUpdateNeededUI ( NetSparkleAppCastItem updates ) : void

This method shows the update ui and allows to perform the update process

Sparkle ( String appcastUrl ) : System

ctor which needs the appcast url

Sparkle ( String appcastUrl, Icon applicationIcon ) : System

ctor which needs the appcast url

Sparkle ( String appcastUrl, Icon applicationIcon, SecurityMode securityMode ) : System

ctor which needs the appcast url

Sparkle ( String appcastUrl, Icon applicationIcon, SecurityMode securityMode, String dsaPublicKey ) : System

ctor which needs the appcast url

Sparkle ( String appcastUrl, Icon applicationIcon, SecurityMode securityMode, String dsaPublicKey, String referenceAssembly ) : System

ctor which needs the appcast url and a referenceassembly

Sparkle ( String appcastUrl, Icon applicationIcon, SecurityMode securityMode, String dsaPublicKey, String referenceAssembly, INetSparkleUIFactory factory ) : System

ctor which needs the appcast url and a referenceassembly

StartLoop ( System.Boolean doInitialCheck ) : void

The method starts a NetSparkle background loop If NetSparkle is configured to check for updates on startup, proceeds to perform the check. You should only call this function when your app is initialized and shows its main window.

StartLoop ( System.Boolean doInitialCheck, System.Boolean forceInitialCheck ) : void

The method starts a NetSparkle background loop If NetSparkle is configured to check for updates on startup, proceeds to perform the check. You should only call this function when your app is initialized and shows its main window.

StartLoop ( System.Boolean doInitialCheck, System.Boolean forceInitialCheck, System.TimeSpan checkFrequency ) : void

The method starts a NetSparkle background loop If NetSparkle is configured to check for updates on startup, proceeds to perform the check. You should only call this function when your app is initialized and shows its main window.

StartLoop ( System.Boolean doInitialCheck, System.TimeSpan checkFrequency ) : void

The method starts a NetSparkle background loop If NetSparkle is configured to check for updates on startup, proceeds to perform the check. You should only call this function when your app is initialized and shows its main window.

StopLoop ( ) : void

This method will stop the sparkle background loop and is called through the disposable interface automatically

UpdateSystemProfileInformation ( NetSparkle.NetSparkleConfiguration config ) : void

This method updates the profile information which can be sended to the server if enabled

Méthodes protégées

Méthode Description
GetInstallerCommand ( string downloadFileName ) : string

Return installer runner command. May throw InvalidDataException

Private Methods

Méthode Description
AskApplicationToSafelyCloseUp ( ) : Task

Apps may need, for example, to let user save their work

CheckForUpdates ( bool useNotificationToast ) : Task

Does a one-off check for updates

InitDownloadAndInstallProcess ( NetSparkleAppCastItem item ) : void

Starts the download process

OnDownloadFinished ( object sender, AsyncCompletedEventArgs e ) : void

Called when the installer is downloaded

OnFirstApplicationIdle ( object sender, EventArgs e ) : void
OnProgressWindowInstallAndRelaunch ( object sender, EventArgs e ) : void

Called when the progress bar fires the update event

OnToastClick ( NetSparkleAppCastItem updates ) : void
OnUserWindowUserResponded ( object sender, EventArgs e ) : void

Called when the user responds to the "skip, later, install" question.

OnWindowsFormsApplicationExit ( object sender, EventArgs e ) : void

Called when a Windows forms application exits. Starts the installer.

OnWorkerDoWork ( object sender, DoWorkEventArgs e ) : void

This method will be executed as worker thread

OnWorkerProgressChanged ( object sender, ProgressChangedEventArgs e ) : void

This method will be notified

ProfileDataThreadStart ( object obj ) : void

Profile data thread

RemoteCertificateValidation ( object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors sslPolicyErrors ) : bool

Determine if the remote X509 certificate is validate

RunDownloadedInstaller ( ) : System.Threading.Task

Runs the downloaded installer

ShowUpdateNeededUIInner ( NetSparkleAppCastItem updates ) : void
UnregisterEvents ( ) : void

Unregisters events so that we don't have multiple items updating

Update ( NetSparkleAppCastItem updates ) : void

Updates from appcast

Method Details

CancelFileDownload() public méthode

Cancels the install
public CancelFileDownload ( ) : void
Résultat void

CheckForUpdatesAtUserRequest() public méthode

Check for updates, using interaction appropriate for if the user just said "check for updates".
public CheckForUpdatesAtUserRequest ( ) : Task
Résultat Task

CheckForUpdatesQuietly() public méthode

Check for updates, using interaction appropriate for where the user doesn't know you're doing it, so be polite
public CheckForUpdatesQuietly ( ) : Task
Résultat Task

CheckOnFirstApplicationIdle() public méthode

The app will check once, after the app settles down.
public CheckOnFirstApplicationIdle ( ) : void
Résultat void

Dispose() public méthode

Is called in the using context and will stop all background activities
public Dispose ( ) : void
Résultat void

GetAbsoluteUrl() public méthode

Converts an relative url to an absolute url based on the
public GetAbsoluteUrl ( string url ) : Uri
url string relative or absolute url
Résultat System.Uri

GetApplicationConfig() public méthode

This method reads the local sparkle configuration for the given reference assembly
public GetApplicationConfig ( ) : NetSparkle.NetSparkleConfiguration
Résultat NetSparkle.NetSparkleConfiguration

GetInstallerCommand() protected méthode

Return installer runner command. May throw InvalidDataException
protected GetInstallerCommand ( string downloadFileName ) : string
downloadFileName string
Résultat string

GetUpdateStatus() public méthode

This method checks if an update is required. During this process the appcast will be downloaded and checked against the reference assembly. Ensure that the calling process has read access to the reference assembly. This method is also called from the background loops.
public GetUpdateStatus ( NetSparkle.NetSparkleConfiguration config ) : Task
config NetSparkle.NetSparkleConfiguration the configuration
Résultat Task

GetWebContentResponse() public méthode

TODO
public GetWebContentResponse ( string Url ) : WebResponse
Url string
Résultat System.Net.WebResponse

GetWebContentStream() public méthode

TODO
public GetWebContentStream ( string Url ) : Stream
Url string
Résultat Stream

ReportDiagnosticMessage() public méthode

This method reports a message in the diagnostic window
public ReportDiagnosticMessage ( string message ) : void
message string
Résultat void

ShowUpdateNeededUI() public méthode

This method shows the update ui and allows to perform the update process
public ShowUpdateNeededUI ( NetSparkleAppCastItem updates ) : void
updates NetSparkleAppCastItem updates to show UI for
Résultat void

Sparkle() public méthode

ctor which needs the appcast url
public Sparkle ( String appcastUrl ) : System
appcastUrl String the URL for the appcast file
Résultat System

Sparkle() public méthode

ctor which needs the appcast url
public Sparkle ( String appcastUrl, Icon applicationIcon ) : System
appcastUrl String the URL for the appcast file
applicationIcon System.Drawing.Icon If you're invoking this from a form, this would be this.Icon
Résultat System

Sparkle() public méthode

ctor which needs the appcast url
public Sparkle ( String appcastUrl, Icon applicationIcon, SecurityMode securityMode ) : System
appcastUrl String the URL for the appcast file
applicationIcon System.Drawing.Icon If you're invoking this from a form, this would be this.Icon
securityMode SecurityMode Sparkle Security mode
Résultat System

Sparkle() public méthode

ctor which needs the appcast url
public Sparkle ( String appcastUrl, Icon applicationIcon, SecurityMode securityMode, String dsaPublicKey ) : System
appcastUrl String the URL for the appcast file
applicationIcon System.Drawing.Icon If you're invoking this from a form, this would be this.Icon
securityMode SecurityMode
dsaPublicKey String The dsa public key to verfiy the sigatures.
Résultat System

Sparkle() public méthode

ctor which needs the appcast url and a referenceassembly
public Sparkle ( String appcastUrl, Icon applicationIcon, SecurityMode securityMode, String dsaPublicKey, String referenceAssembly ) : System
appcastUrl String the URL for the appcast file
applicationIcon System.Drawing.Icon If you're invoking this from a form, this would be this.Icon
securityMode SecurityMode
dsaPublicKey String
referenceAssembly String the name of the assembly to use for comparison
Résultat System

Sparkle() public méthode

ctor which needs the appcast url and a referenceassembly
public Sparkle ( String appcastUrl, Icon applicationIcon, SecurityMode securityMode, String dsaPublicKey, String referenceAssembly, INetSparkleUIFactory factory ) : System
appcastUrl String the URL for the appcast file
applicationIcon System.Drawing.Icon If you're invoking this from a form, this would be this.Icon
securityMode SecurityMode
dsaPublicKey String
referenceAssembly String the name of the assembly to use for comparison
factory INetSparkleUIFactory UI factory to use
Résultat System

StartLoop() public méthode

The method starts a NetSparkle background loop If NetSparkle is configured to check for updates on startup, proceeds to perform the check. You should only call this function when your app is initialized and shows its main window.
public StartLoop ( System.Boolean doInitialCheck ) : void
doInitialCheck System.Boolean
Résultat void

StartLoop() public méthode

The method starts a NetSparkle background loop If NetSparkle is configured to check for updates on startup, proceeds to perform the check. You should only call this function when your app is initialized and shows its main window.
public StartLoop ( System.Boolean doInitialCheck, System.Boolean forceInitialCheck ) : void
doInitialCheck System.Boolean true if this instance should do an initial check.
forceInitialCheck System.Boolean true if this instance should force an initial check.
Résultat void

StartLoop() public méthode

The method starts a NetSparkle background loop If NetSparkle is configured to check for updates on startup, proceeds to perform the check. You should only call this function when your app is initialized and shows its main window.
public StartLoop ( System.Boolean doInitialCheck, System.Boolean forceInitialCheck, System.TimeSpan checkFrequency ) : void
doInitialCheck System.Boolean true if this instance should do an initial check.
forceInitialCheck System.Boolean true if this instance should force an initial check.
checkFrequency System.TimeSpan the frequency between checks.
Résultat void

StartLoop() public méthode

The method starts a NetSparkle background loop If NetSparkle is configured to check for updates on startup, proceeds to perform the check. You should only call this function when your app is initialized and shows its main window.
public StartLoop ( System.Boolean doInitialCheck, System.TimeSpan checkFrequency ) : void
doInitialCheck System.Boolean true if this instance should do an initial check.
checkFrequency System.TimeSpan the frequency between checks.
Résultat void

StopLoop() public méthode

This method will stop the sparkle background loop and is called through the disposable interface automatically
public StopLoop ( ) : void
Résultat void

UpdateSystemProfileInformation() public méthode

This method updates the profile information which can be sended to the server if enabled
public UpdateSystemProfileInformation ( NetSparkle.NetSparkleConfiguration config ) : void
config NetSparkle.NetSparkleConfiguration the configuration
Résultat void