Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Nov 27, 2025

FontImage XAML markup extension is deprecated in .NET 10. The notes-app tutorial was using the deprecated syntax.

Changes

  • Tutorial snippets: Updated all AllNotesPage.xaml files to use FontImageSource instead of FontImage
  • Tutorial text: Updated notes-app.md explanation to reference FontImageSource
  • Deprecation notes: Added deprecation warnings in image.md and consume.md
  • Moniker scoping: Wrapped FontImage reference in fonts.md with .NET 8-9 moniker range

Before/After

<!-- Before (.NET 9 and earlier syntax, now deprecated) -->
<ToolbarItem IconImageSource="{FontImage Glyph='+', Color=Black, Size=22}" />

<!-- After -->
<ToolbarItem IconImageSource="{FontImageSource Glyph='+', Color=Black, Size=22}" />
Original prompt

This section details on the original issue you should resolve

<issue_title>Issue with controls method 'FontImage' -> 'FontImageSource'</issue_title>
<issue_description>### Type of issue

Typo

Description

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:models="clr-namespace:Notes.Models"
             x:DataType="models:AllNotes"
             x:Class="Notes.Views.AllNotesPage"
             Title="AllNotesPage">

    <ContentPage.ToolbarItems>
        <ToolbarItem Text="Add" Clicked="Add_Clicked" IconImageSource="{FontImageSource Glyph='+', Color=Black, Size=22}" />
    </ContentPage.ToolbarItems>


    <CollectionView>
    </CollectionView>

</ContentPage>

In the mslearn documentation it is 'FontImage' that is obsolete with .NET 10.0.100, use 'FontImageSource'.

Page URL

https://learn.microsoft.com/en-us/dotnet/maui/tutorials/notes-app?view=net-maui-10.0

Content source URL

https://github.com/dotnet/docs-maui/blob/main/docs/tutorials/notes-app.md

Document Version Independent Id

720bf7f0-db92-f738-b864-ee149a02377b

Platform Id

295e87f0-f95d-10f0-eda0-721995eccb60

Article author

@davidortinau

Metadata

  • ID: 720bf7f0-db92-f738-b864-ee149a02377b
  • PlatformId: 295e87f0-f95d-10f0-eda0-721995eccb60
  • Service: dotnet-mobile
  • Sub-service: dotnet-maui

Related Issues</issue_description>

<agent_instructions>Correct this use of FontImage and lets inspect all of the docs for FontImage and replace it with FontImageSource, unless the mention is in the context of it being deprecated. If there is an apprpriate place, add a note box that FontImage is depreacted as of .NET 10 and will be released in a future release</agent_instructions>

Comments on the Issue (you are @copilot in this section)


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.


Internal previews

📄 File 🔗 Preview link
docs/tutorials/notes-app.md docs/tutorials/notes-app
docs/user-interface/controls/image.md docs/user-interface/controls/image
docs/user-interface/fonts.md docs/user-interface/fonts
docs/xaml/markup-extensions/consume.md docs/xaml/markup-extensions/consume

@learn-build-service-prod
Copy link

Learn Build status updates of commit 40d3607:

✅ Validation status: passed

For more details, please refer to the build report.

… notes

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
@learn-build-service-prod
Copy link

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link

Learn Build status updates of commit b40ce34:

✅ Validation status: passed

File Status Preview URL Details
docs/tutorials/notes-app.md ✅Succeeded View (>=net-maui-8.0)
docs/tutorials/snippets/notes-app/allnotes/Views/AllNotesPage.xaml ✅Succeeded View (>=net-maui-8.0)
docs/tutorials/snippets/notes-mvvm/bugs/Views/AllNotesPage.xaml ✅Succeeded View (>=net-maui-8.0)
docs/tutorials/snippets/notes-mvvm/model/Views/AllNotesPage.xaml ✅Succeeded
docs/tutorials/snippets/notes-mvvm/viewmodel-shared/Views/AllNotesPage.xaml ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/image.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/fonts.md ✅Succeeded View (>=net-maui-8.0)
docs/xaml/markup-extensions/consume.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

Copilot AI changed the title [WIP] Fix typo in FontImageSource for ToolbarItem controls Replace deprecated FontImage with FontImageSource in notes-app tutorial Nov 27, 2025
Copilot AI requested a review from jfversluis November 27, 2025 13:57
Copilot finished work on behalf of jfversluis November 27, 2025 13:57
@jfversluis jfversluis marked this pull request as ready for review November 27, 2025 13:59
@jfversluis jfversluis requested a review from a team as a code owner November 27, 2025 13:59
@jfversluis jfversluis merged commit e4b3fec into main Nov 28, 2025
6 checks passed
@jfversluis jfversluis deleted the copilot/fix-toolbaritem-fontimage-typo branch November 28, 2025 10:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Issue with <ToolbarItem /> controls method 'FontImage' -> 'FontImageSource'

3 participants