Update to Visual Studio 2026 and replace deprecated DisplayAlert with DisplayAlertAsync

Copilot · jamesmontemagno · Copilot · commit 722f1afe9e52 · 2025-11-17T22:33:26.000Z
Co-authored-by: jamesmontemagno &lt;1676321+jamesmontemagno@users.noreply.github.com&gt;
diff --git a/Community Modules/XAML/Part 1 - Fundamentals/Finish/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs b/Community Modules/XAML/Part 1 - Fundamentals/Finish/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs
@@ -26,7 +26,7 @@ async Task OpenMap()
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to launch maps: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error, no Maps app!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error, no Maps app!", ex.Message, "OK");
         }
     }
 }
diff --git a/Community Modules/XAML/Part 1 - Fundamentals/Finish/MonkeyFinder/ViewModel/MonkeysViewModel.cs b/Community Modules/XAML/Part 1 - Fundamentals/Finish/MonkeyFinder/ViewModel/MonkeysViewModel.cs
@@ -41,7 +41,7 @@ async Task GetMonkeysAsync()
         {
             if (connectivity.NetworkAccess != NetworkAccess.Internet)
             {
-                await Shell.Current.DisplayAlert("No connectivity!",
+                await Shell.Current.DisplayAlertAsync("No connectivity!",
                     $"Please check internet and try again.", "OK");
                 return;
             }
@@ -59,7 +59,7 @@ await Shell.Current.DisplayAlert("No connectivity!",
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to get monkeys: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
         finally
         {
@@ -93,14 +93,14 @@ async Task GetClosestMonkey()
                 new Location(m.Latitude, m.Longitude), DistanceUnits.Miles))
                 .FirstOrDefault();
 
-            await Shell.Current.DisplayAlert("", first.Name + " " +
+            await Shell.Current.DisplayAlertAsync("", first.Name + " " +
                 first.Location, "OK");
 
         }
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to query location: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
     }
 }
diff --git a/Community Modules/XAML/Part 2 - Responsibility/Finish/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs b/Community Modules/XAML/Part 2 - Responsibility/Finish/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs
@@ -26,7 +26,7 @@ async Task OpenMap()
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to launch maps: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error, no Maps app!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error, no Maps app!", ex.Message, "OK");
         }
     }
 }
diff --git a/Community Modules/XAML/Part 2 - Responsibility/Finish/MonkeyFinder/ViewModel/MonkeysViewModel.cs b/Community Modules/XAML/Part 2 - Responsibility/Finish/MonkeyFinder/ViewModel/MonkeysViewModel.cs
@@ -41,7 +41,7 @@ async Task GetMonkeysAsync()
         {
             if (connectivity.NetworkAccess != NetworkAccess.Internet)
             {
-                await Shell.Current.DisplayAlert("No connectivity!",
+                await Shell.Current.DisplayAlertAsync("No connectivity!",
                     $"Please check internet and try again.", "OK");
                 return;
             }
@@ -59,7 +59,7 @@ await Shell.Current.DisplayAlert("No connectivity!",
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to get monkeys: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
         finally
         {
@@ -93,14 +93,14 @@ async Task GetClosestMonkey()
                 new Location(m.Latitude, m.Longitude), DistanceUnits.Miles))
                 .FirstOrDefault();
 
-            await Shell.Current.DisplayAlert("", first.Name + " " +
+            await Shell.Current.DisplayAlertAsync("", first.Name + " " +
                 first.Location, "OK");
 
         }
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to query location: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
     }
 }
diff --git a/Community Modules/XAML/Part 3 - Magic Values/Finish/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs b/Community Modules/XAML/Part 3 - Magic Values/Finish/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs
@@ -26,7 +26,7 @@ async Task OpenMap()
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to launch maps: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error, no Maps app!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error, no Maps app!", ex.Message, "OK");
         }
     }
 }
diff --git a/Community Modules/XAML/Part 3 - Magic Values/Finish/MonkeyFinder/ViewModel/MonkeysViewModel.cs b/Community Modules/XAML/Part 3 - Magic Values/Finish/MonkeyFinder/ViewModel/MonkeysViewModel.cs
@@ -41,7 +41,7 @@ async Task GetMonkeysAsync()
         {
             if (connectivity.NetworkAccess != NetworkAccess.Internet)
             {
-                await Shell.Current.DisplayAlert("No connectivity!",
+                await Shell.Current.DisplayAlertAsync("No connectivity!",
                     $"Please check internet and try again.", "OK");
                 return;
             }
@@ -59,7 +59,7 @@ await Shell.Current.DisplayAlert("No connectivity!",
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to get monkeys: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
         finally
         {
@@ -93,14 +93,14 @@ async Task GetClosestMonkey()
                 new Location(m.Latitude, m.Longitude), DistanceUnits.Miles))
                 .FirstOrDefault();
 
-            await Shell.Current.DisplayAlert("", first.Name + " " +
+            await Shell.Current.DisplayAlertAsync("", first.Name + " " +
                 first.Location, "OK");
 
         }
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to query location: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
     }
 }
diff --git a/Community Modules/XAML/Part 4 - Naming/Finish/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs b/Community Modules/XAML/Part 4 - Naming/Finish/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs
@@ -26,7 +26,7 @@ async Task OpenMap()
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to launch maps: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error, no Maps app!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error, no Maps app!", ex.Message, "OK");
         }
     }
 }
diff --git a/Community Modules/XAML/Part 4 - Naming/Finish/MonkeyFinder/ViewModel/MonkeysViewModel.cs b/Community Modules/XAML/Part 4 - Naming/Finish/MonkeyFinder/ViewModel/MonkeysViewModel.cs
@@ -41,7 +41,7 @@ async Task GetMonkeysAsync()
         {
             if (connectivity.NetworkAccess != NetworkAccess.Internet)
             {
-                await Shell.Current.DisplayAlert("No connectivity!",
+                await Shell.Current.DisplayAlertAsync("No connectivity!",
                     $"Please check internet and try again.", "OK");
                 return;
             }
@@ -59,7 +59,7 @@ await Shell.Current.DisplayAlert("No connectivity!",
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to get monkeys: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
         finally
         {
@@ -93,14 +93,14 @@ async Task GetClosestMonkey()
                 new Location(m.Latitude, m.Longitude), DistanceUnits.Miles))
                 .FirstOrDefault();
 
-            await Shell.Current.DisplayAlert("", first.Name + " " +
+            await Shell.Current.DisplayAlertAsync("", first.Name + " " +
                 first.Location, "OK");
 
         }
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to query location: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
     }
 }
diff --git a/Community Modules/XAML/Part 5 - Custom Types/Finish/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs b/Community Modules/XAML/Part 5 - Custom Types/Finish/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs
@@ -26,7 +26,7 @@ async Task OpenMap()
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to launch maps: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error, no Maps app!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error, no Maps app!", ex.Message, "OK");
         }
     }
 }
diff --git a/Community Modules/XAML/Part 5 - Custom Types/Finish/MonkeyFinder/ViewModel/MonkeysViewModel.cs b/Community Modules/XAML/Part 5 - Custom Types/Finish/MonkeyFinder/ViewModel/MonkeysViewModel.cs
@@ -41,7 +41,7 @@ async Task GetMonkeysAsync()
         {
             if (connectivity.NetworkAccess != NetworkAccess.Internet)
             {
-                await Shell.Current.DisplayAlert("No connectivity!",
+                await Shell.Current.DisplayAlertAsync("No connectivity!",
                     $"Please check internet and try again.", "OK");
                 return;
             }
@@ -59,7 +59,7 @@ await Shell.Current.DisplayAlert("No connectivity!",
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to get monkeys: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
         finally
         {
@@ -93,14 +93,14 @@ async Task GetClosestMonkey()
                 new Location(m.Latitude, m.Longitude), DistanceUnits.Miles))
                 .FirstOrDefault();
 
-            await Shell.Current.DisplayAlert("", first.Name + " " +
+            await Shell.Current.DisplayAlertAsync("", first.Name + " " +
                 first.Location, "OK");
 
         }
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to query location: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
     }
 }
diff --git a/Finish/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs b/Finish/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs
@@ -26,7 +26,7 @@ async Task OpenMap()
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to launch maps: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error, no Maps app!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error, no Maps app!", ex.Message, "OK");
         }
     }
 }
diff --git a/Finish/MonkeyFinder/ViewModel/MonkeysViewModel.cs b/Finish/MonkeyFinder/ViewModel/MonkeysViewModel.cs
@@ -41,7 +41,7 @@ async Task GetMonkeysAsync()
         {
             if (connectivity.NetworkAccess != NetworkAccess.Internet)
             {
-                await Shell.Current.DisplayAlert("No connectivity!",
+                await Shell.Current.DisplayAlertAsync("No connectivity!",
                     $"Please check internet and try again.", "OK");
                 return;
             }
@@ -59,7 +59,7 @@ await Shell.Current.DisplayAlert("No connectivity!",
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to get monkeys: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
         finally
         {
@@ -93,14 +93,14 @@ async Task GetClosestMonkey()
                 new Location(m.Latitude, m.Longitude), DistanceUnits.Miles))
                 .FirstOrDefault();
 
-            await Shell.Current.DisplayAlert("", first.Name + " " +
+            await Shell.Current.DisplayAlertAsync("", first.Name + " " +
                 first.Location, "OK");
 
         }
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to query location: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
     }
 }
diff --git a/Part 3 - Navigation/MonkeyFinder/ViewModel/MonkeysViewModel.cs b/Part 3 - Navigation/MonkeyFinder/ViewModel/MonkeysViewModel.cs
@@ -33,7 +33,7 @@ async Task GetMonkeysAsync()
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to get monkeys: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
         finally
         {
diff --git a/Part 4 - Platform Features/MonkeyFinder/ViewModel/MonkeysViewModel.cs b/Part 4 - Platform Features/MonkeyFinder/ViewModel/MonkeysViewModel.cs
@@ -45,7 +45,7 @@ async Task GetMonkeysAsync()
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to get monkeys: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
         finally
         {
diff --git a/Part 5 - CollectionView/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs b/Part 5 - CollectionView/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs
@@ -26,7 +26,7 @@ async Task OpenMap()
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to launch maps: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error, no Maps app!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error, no Maps app!", ex.Message, "OK");
         }
     }
 }
diff --git a/Part 5 - CollectionView/MonkeyFinder/ViewModel/MonkeysViewModel.cs b/Part 5 - CollectionView/MonkeyFinder/ViewModel/MonkeysViewModel.cs
@@ -38,7 +38,7 @@ async Task GetMonkeysAsync()
         {
             if (connectivity.NetworkAccess != NetworkAccess.Internet)
             {
-                await Shell.Current.DisplayAlert("No connectivity!",
+                await Shell.Current.DisplayAlertAsync("No connectivity!",
                     $"Please check internet and try again.", "OK");
                 return;
             }
@@ -56,7 +56,7 @@ await Shell.Current.DisplayAlert("No connectivity!",
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to get monkeys: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
         finally
         {
@@ -89,14 +89,14 @@ async Task GetClosestMonkey()
                 new Location(m.Latitude, m.Longitude), DistanceUnits.Miles))
                 .FirstOrDefault();
 
-            await Shell.Current.DisplayAlert("", first.Name + " " +
+            await Shell.Current.DisplayAlertAsync("", first.Name + " " +
                 first.Location, "OK");
 
         }
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to query location: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
     }
 }
diff --git a/Part 6 - AppThemes/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs b/Part 6 - AppThemes/MonkeyFinder/ViewModel/MonkeyDetailsViewModel.cs
@@ -26,7 +26,7 @@ async Task OpenMap()
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to launch maps: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error, no Maps app!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error, no Maps app!", ex.Message, "OK");
         }
     }
 }
diff --git a/Part 6 - AppThemes/MonkeyFinder/ViewModel/MonkeysViewModel.cs b/Part 6 - AppThemes/MonkeyFinder/ViewModel/MonkeysViewModel.cs
@@ -29,7 +29,7 @@ async Task GetMonkeysAsync()
         {
             if (connectivity.NetworkAccess != NetworkAccess.Internet)
             {
-                await Shell.Current.DisplayAlert("No connectivity!",
+                await Shell.Current.DisplayAlertAsync("No connectivity!",
                     $"Please check internet and try again.", "OK");
                 return;
             }
@@ -47,7 +47,7 @@ await Shell.Current.DisplayAlert("No connectivity!",
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to get monkeys: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
         finally
         {
@@ -93,14 +93,14 @@ async Task GetClosestMonkey()
                 new Location(m.Latitude, m.Longitude), DistanceUnits.Miles))
                 .FirstOrDefault();
 
-            await Shell.Current.DisplayAlert("", first.Name + " " +
+            await Shell.Current.DisplayAlertAsync("", first.Name + " " +
                 first.Location, "OK");
 
         }
         catch (Exception ex)
         {
             Debug.WriteLine($"Unable to query location: {ex.Message}");
-            await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");
+            await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");
         }
     }
 }
diff --git a/README.md b/README.md
@@ -9,7 +9,7 @@ This workshop is available in the following languages:
 * [Chinese (Traditional)](README.zh-tw.md) - README filed ending with .zh-tw.md (Translated by [James Tsai](https://github.com/JamestsaiTW))
 
 ## Setup Guide
-Hey there! This workshop will be a hands on and a bring your own device workshop. You can develop on PC,  Mac, or Linux and all you will need to do is install Visual Studio 2022 with the .NET MAUI Workshop or Visual Studio Code with the .NET MAUI extension. It is built on .NET 10, which means you will need version 17.13 of Visual Studio 2022 or newer. See [full installation guide for .NET MAUI](https://learn.microsoft.com/dotnet/maui/get-started/installation?view=net-maui-10.0) for more information.
+Hey there! This workshop will be a hands on and a bring your own device workshop. You can develop on PC, Mac, or Linux and all you will need to do is install Visual Studio 2026 or Visual Studio Code with the C# Dev Kit extension. It is built on .NET 10. See [full installation guide for .NET MAUI](https://learn.microsoft.com/dotnet/maui/get-started/installation?view=net-maui-10.0) for more information.
 
 Before starting the workshop, I recommend going through the quick 10 minute [.NET MAUI Tutorial](https://docs.microsoft.com/dotnet/maui/get-started/first-app?WT.mc_id=friends-mauiworkshop-jamont) that will guide you through installation and also ensuring everything is configured correct.
 

Original file line number	Diff line number	Diff line change
`@@ -26,7 +26,7 @@ async Task OpenMap()`
`26`	`26`	`catch (Exception ex)`
`27`	`27`	`{`
`28`	`28`	`Debug.WriteLine($"Unable to launch maps: {ex.Message}");`
`29`		`- await Shell.Current.DisplayAlert("Error, no Maps app!", ex.Message, "OK");`
	`29`	`+ await Shell.Current.DisplayAlertAsync("Error, no Maps app!", ex.Message, "OK");`
`30`	`30`	`}`
`31`	`31`	`}`
`32`	`32`	`}`
Original file line number	Diff line number	Diff line change
`@@ -41,7 +41,7 @@ async Task GetMonkeysAsync()`
`41`	`41`	`{`
`42`	`42`	`if (connectivity.NetworkAccess != NetworkAccess.Internet)`
`43`	`43`	`{`
`44`		`- await Shell.Current.DisplayAlert("No connectivity!",`
	`44`	`+ await Shell.Current.DisplayAlertAsync("No connectivity!",`
`45`	`45`	`$"Please check internet and try again.", "OK");`
`46`	`46`	`return;`
`47`	`47`	`}`
`@@ -59,7 +59,7 @@ await Shell.Current.DisplayAlert("No connectivity!",`
`59`	`59`	`catch (Exception ex)`
`60`	`60`	`{`
`61`	`61`	`Debug.WriteLine($"Unable to get monkeys: {ex.Message}");`
`62`		`- await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");`
	`62`	`+ await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");`
`63`	`63`	`}`
`64`	`64`	`finally`
`65`	`65`	`{`
`@@ -93,14 +93,14 @@ async Task GetClosestMonkey()`
`93`	`93`	`new Location(m.Latitude, m.Longitude), DistanceUnits.Miles))`
`94`	`94`	`.FirstOrDefault();`
`95`	`95`
`96`		`- await Shell.Current.DisplayAlert("", first.Name + " " +`
	`96`	`+ await Shell.Current.DisplayAlertAsync("", first.Name + " " +`
`97`	`97`	`first.Location, "OK");`
`98`	`98`
`99`	`99`	`}`
`100`	`100`	`catch (Exception ex)`
`101`	`101`	`{`
`102`	`102`	`Debug.WriteLine($"Unable to query location: {ex.Message}");`
`103`		`- await Shell.Current.DisplayAlert("Error!", ex.Message, "OK");`
	`103`	`+ await Shell.Current.DisplayAlertAsync("Error!", ex.Message, "OK");`
`104`	`104`	`}`
`105`	`105`	`}`
`106`	`106`	`}`