Update

Introduction

When you create a software, you usually want to update it to add new features or correct bugs. Thanks to LeoCorpLibrary, it's very simple to implement an update system.

To use the methods and other features of LeoCorpLibrary, don't forget to add this line of code in your "using" region.

C#

using LeoCorpLibrary;

VB

Imports LeoCorpLibrary

Functions

a. IsAvailable

This function is available in version 1.1 and higher.

Compatibility
FrameworksLeoCorpLibraryLeoCorpLibrary.Core
.NET 6
.NET 5
.NET Core 3.1
.NET Framework 4.5

The IsAvailable() method allows you to check if a updates are available for your software. Returns a bool value.

LeoCorpLibrary.Update.IsAvailable()

Note

You need to place the namespace LeoCorpLibrary before the Update class because of a conflict with Control.Update.

Here's this method's arguments

TypeArgumentDescriptionExample
stringversionCurrent version of the software"1.0.0.0"
stringlastVersionLast version of the software"1.1.0.0"

Here's an example of usage that uses the GetLastVersion method:

C#

string lastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt");
if (LeoCorpLibrary.Update.IsAvailable("1.0.0.0", lastVersion)) // If updates are available
{
    MessageBox.Show("Update available");
}
else
{
    MessageBox.Show("No update available");
}

VB

Dim lastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt")
If (LeoCorpLibrary.Update.IsAvailable("1.0.0.0", lastVersion)) Then ' If updates are available
    MsgBox("Update available")
Else
    MsgBox("No update available")
End If

Go to top

b. Check

1. Check

This function is available in version 1.1 and higher.

Compatibility
FrameworkLeoCorpLibraryLeoCorpLibrary.Core
.NET 6
.NET 5
.NET Core 3.1
.NET Framework 4.5

The Check() method allows you to check updates for your software. If updates are available, a specified form will show. Same thing if no updates are available.

LeoCorpLibrary.Update.Check()

Note

You need to place the namespace LeoCorpLibrary before the Update class because of a conflict with Control.Update.

Here's this method's arguments

TypeArgumentDescriptionExample
stringversionCurrent version of the software"1.0.0.0"
stringlastVersionLast version of the software"1.1.0.0"
FormavailableUpdateFormForm to show when updates are availableForm1
FormnoUpdateFormFrom to show when no updates are availableForm2

Here's an example that uses the GetLastVersion method:

C#

string lastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt");
LeoCorpLibrary.Update.Check("1.0.0.0", lastVersion, new MAJ_AV(), new MAJ_UN());
// A window will open depending on the result

VB

Dim LastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt")
LeoCorpLibrary.Update.Check("1.0.0.0", LastVersion, new MAJ_AV, new MAJ_UN)
' A window will open depending on the result

Go to top

2. CheckWPF

This function is available in version 2.2 and higher.

Compatibility
FrameworkLeoCorpLibraryLeoCorpLibrary.Core
.NET 6
.NET 5
.NET Core 3.1
.NET Framework 4.5

The CheckWPF() method allows you to check updates for your software. If updates are available, a specified window will show. Same thing if no updates are available.

LeoCorpLibrary.Update.CheckWPF()

Note

You need to place the namespace LeoCorpLibrary before the Update class because of a conflict with Control.Update.

Here's this method's arguments

| :--: | :-------: | :---------: | :-----: | | string | version | Current version of the software | "1.0.0.0" | | string | lastVersion | Last version of the software | "1.1.0.0" | | Form | availableUpdateWindow | Window to show when updates are available | Form1 | | Form | noUpdateWindow | Window to show when no updates are available | Form2 |

Here's an example that uses the GetLastVersion method:

C#

string lastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt");
LeoCorpLibrary.Update.Check("1.0.0.0", lastVersion, new MAJ_AV(), new MAJ_UN());
// A window will open depending on the result

VB

Dim LastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt")
LeoCorpLibrary.Update.Check("1.0.0.0", LastVersion, new MAJ_AV, new MAJ_UN)
' A window will open depending on the result

Go to top

c. GetLastVersion

This function is available in version 1.1 and higher.

Compatibility
FrameworksLeoCorpLibraryLeoCorpLibrary.Core
.NET 6
.NET 5
.NET Core 3.1
.NET Framework 4.5

Obsolete

This method is obsolete, please use GetLastVersionAsync

The GetLastVersion() method download a string from a specific webpage where a .txt file that contains the last version. Returns a string.

This method has only one argument:

TypeArgumentDescriptionExample
stringlastVersionFileLinkLink of the file that contains the last version"https://example.com/Version.txtopen in new window"

Note

You need to place the namespace LeoCorpLibrary before the Update class because of a conflict with Control.Update.

Here's an example of usage:

C#

string lastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt");
// You can use the lastVersion variable in the IsAvailable() method. 
// or in the Check() method.

VB

Dim LastVersion = LeoCorpLibrary.Update.GetLastVersion("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt")
' You can use the lastVersion variable in the IsAvailable() method. 
' or in the Check() method.

Go to top

d. Install

This function is available in version 1.1 and higher.

Compatibility
FrameworkLeoCorpLibraryLeoCorpLibrary.Core
.NET 6
.NET 5
.NET Core 3.1
.NET Framework 4.5

The Install() method allow to install an update for your software. if you want to update your program using this method, we advise you to use this method in another program (Updater). This program needs admin privileges to update the software. You can enable this feature in app.manifest. You can create it in Visual Studioopen in new window. Edit this:

- <requestedExecutionLevel  level="asInvoker" uiAccess="false" />
+ <requestedExecutionLevel  level="requireAdministrator" uiAccess="false" />

Here's this method's arguments:

TypeArgumentDescriptionExample
stringfilePathLocation of the file"C:/Programme/Program.exe"
stringlastVersionLinkLink of the new file"https://example.com/Program.exeopen in new window"
boolfromAppStartupPath(Optional) Open the file from Application.StartupPathtrue

Note

You need to place the namespace LeoCorpLibrary before the Update class because of a conflict with Control.Update.

Example:

C#

string link = "https://dl.dropboxusercontent.com/s/tlekj6j834tgi3r/GestionPersoX.exe";

LeoCorpLibrary.Update.Install("C:/Programme/Programme.exe", link);
// If the program is in 'C:\Program'

LeoCorpLibrary.Update.Install("/Programme.exe", link, true)

VB

Dim link = "https://dl.dropboxusercontent.com/s/tlekj6j834tgi3r/GestionPersoX.exe"

LeoCorpLibrary.Update.Install("C:/Programme/Programme.exe", link)
' If the program is in 'C:\Program'

LeoCorpLibrary.Update.Install("/Programme.exe", link, True)

Go to top

e. GetLastVersionAsync

This function is available in version 2.1 and higher.

Compatibility
FrameworksLeoCorpLibraryLeoCorpLibrary.Core
.NET 6
.NET 5
.NET Core 3.1
.NET Framework 4.5

The GetLastVersionAsync() method allows you to obtain the last version of the software asynchronously from a *.txt file.

It's in

LeoCorpLibrary.Update.GetLastVersionAsync()

Here's this method's argument:

TypeArgumentDescriptionExample
stringlastVersionFileLinkLink of the file where is stored the last version"https://example.com/Version.txtopen in new window"

Note

You need to place the namespace LeoCorpLibrary before the Update class because of a conflict with Control.Update.

Here's an example of usage:

C#

async void GetVersion()
{
    string version = await LeoCorpLibrary.Update.GetLastVersionAsync("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt");
}

VB

Private Async Sub GetVersion()
    Dim version As String = Await LeoCorpLibrary.Update.GetLastVersionAsync("https://dl.dropboxusercontent.com/s/j3fn78x3lcmowpr/Version.txt")
End Sub

Go to top