Documentazione di giUpdater

Proprietà

DimensioneSetup

Ritorna un intero che indica la dimensione del pacchetto di installazione da scaricare in byte.

NOTA: Il valore di questa proprietà è valido solo dopo aver chiamato il metodo run. Il valore di questa proprietà è pari al valore della variabile $length_byte dello script php.

DownloadCancelled

Ritorna un valore booleano che indica se il download è stato cancellato.

ErrorList

Imposta o ritorna la lista di eccezioni verificatesi durante il funzionamento della DLL.

IsTimeToUpdate

Ritorna un valore booleano che indica se è disponibile una nuova versione del software.

LastVersion

Ritorna un valore di tipo Version e rappresenta l'ultima versione del software disponibile. Il valore di questa proprietà è pari al valore della variabile $last_version dello script php.

Priority

Ritorna un valore intero che determina la priorità del pacchetto di aggiornamento. Il valore di questa proprietà è pari al valore della variabile $priority dello script php.

Script

Ritorna una stringa contenente l'intero script remoto.

ScriptVersion

Ritorna un valore di tipo Version e rappresenta la versione dello script. Il valore di questa proprietà è pari al valore della variabile $script_version dello script php.

VersionDLL

Ritorna un valore di tipo Version e rappresenta la versione della DLL.

Metodi

New

Costruttore così dichiarato:

Public Sub New(ByVal URItoUpdate As String, ByVal LocalVersion As Version)

URItoUpdate: stringa che identifica l'indirizzo dello script;LocalVersion: versione corrente del software. (Es:My.Application.Info.Version)

CancelDownload

Interrompe il download in corso e setta la proprietà DownloadCancelled.

DownoadNewVersion

Public Sub DownloadNewVersion(ByVal destination As String)

Esegue il download nella directory specificata da destination del pacchetto di aggiornamento. E' possibile controllare lo stato di avanzamento del download tramite l'evento UpdateProgress. Al termine del download viene scatenato l'evento DownloadCompleted.

Run

Esegue il download e l'elaborazione dello script. Dopo la chiamata di questo metodo è possibile stabilire la disponibilità di un aggiornamento controllando il valore della proprietà IsTimeToUpdate. Se viene rilevata la disponibilità di una nuova versione viene scatenato l'evento Update.

Eventi

DownloadCompleted

Evento scatenato al termine di un download.

SendMessage

Evento scatenato nel caso di gravi errori.

Update

Evento scatenato al rilevamento di una nuova versione.

UpdateProgess

Evento scatenato durante il download del pacchetto di installazione.

Esempio di utilizzo:

Private Sub UpdateProgress(ByVal sender As System.Object, ByVal e As DownloadProgressChangedEventArgs)

Me.Text = e.ProgressPercentage & "%"

End Sub