# 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, dont 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
Framework LeoCorpLibrary LeoCorpLibrary.Core
.NET 5
.NET Core 3.1
.NET Framework 4.7.2
.NET Framework 4.5

The IsAvailable() method allows you to check if a updates are avaialable 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

Type Argument Description Example
string version Curent version of the software "1.0.0.0"
string lastVersion Last 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
Framework LeoCorpLibrary LeoCorpLibrary.Core
.NET 5
.NET Core 3.1
.NET Framework 4.7.2
.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

Type Argument Description Example
string version Curent version of the software "1.0.0.0"
string lastVersion Last version of the software "1.1.0.0"
Form availableUpdateForm Form to show when updates are available Form1
Form noUpdateForm From 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

# 2. CheckWPF

This function is available in version 2.2 and higher.

Compatibility
Framework LeoCorpLibrary LeoCorpLibrary.Core
.NET 5
.NET Core 3.1
.NET Framework 4.7.2
.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

Type Argument Description Example
string version Curent 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
Framework LeoCorpLibrary LeoCorpLibrary.Core
.NET 5
.NET Core 3.1
.NET Framework 4.7.2
.NET Framework 4.5

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

This method has only one argument:

Type Argument Description Example
string lastVersionFileLink Link of the file that contains the last version "https://example.com/Version.txt (opens 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
Framework LeoCorpLibrary LeoCorpLibrary.Core
.NET 5
.NET Core 3.1
.NET Framework 4.7.2
.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 advice you to uise 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 Studio (opens new window). Edit this:

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

Here's this method's arguments:

Type Argument Description Example
string filePath Location of the file "C:/Programme/Program.exe"
string lastVersionLink Link of the new file "https://example.com/Program.exe (opens new window)"
bool fromAppStartupPath (Optional) Open the file from Application.StartupPath true

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:\Progtam'

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

Go to top

# e. GetLastVersionAsync

This function is available in version 2.1 and higher.

Compatibility
Framework LeoCorpLibrary LeoCorpLibrary.Core
.NET 5
.NET Core 3.1
.NET Framework 4.7.2
.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:

Type Argument Description Example
string lastVersionFileLink Link of the file where is stored the last version "https://example.com/Version.txt (opens 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