Skip to content

Conversation

@davidortinau
Copy link
Contributor

@davidortinau davidortinau commented Aug 18, 2025

Update Messaging guidance for .NET 10: migrate from MessagingCenter to modern alternatives

What changed

  • docs/fundamentals/messagingcenter.md:
    • Added a >= net-maui-10.0 migration-first section recommending CommunityToolkit.Mvvm WeakReferenceMessenger, with minimal send/receive examples (typed message via ValueChangedMessage, registration/unregistration, and an ObservableRecipient tip).
    • Added a short “When to use events instead” section showing .NET events with Microsoft.Maui.WeakEventManager for simple local scenarios.
    • Preserved legacy MessagingCenter usage under <= net-maui-9.0.
    • Switched from page-level monikerRange to inline moniker blocks and updated ms.date/description.

Why

  • Microsoft.Maui.Controls.MessagingCenter is obsolete in .NET 10 (source has [Obsolete] attribute recommending CommunityToolkit.Mvvm.Messaging.WeakReferenceMessenger). This aligns the docs with platform guidance and promotes modern, testable patterns.

References


Internal previews

📄 File 🔗 Preview link
docs/fundamentals/messagingcenter.md docs/fundamentals/messagingcenter

…mend CommunityToolkit.Mvvm WeakReferenceMessenger; update ms.date
@davidortinau davidortinau requested a review from a team as a code owner August 18, 2025 18:58
@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 issues. Other issues are also a high priority. 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 0f8df13:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/messagingcenter.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@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 issues. Other issues are also a high priority. 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 6044991:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/messagingcenter.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@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 issues. Other issues are also a high priority. 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 564817e:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/messagingcenter.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@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 issues. Other issues are also a high priority. 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 f1c295b:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/messagingcenter.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@jfversluis jfversluis merged commit e8ef5c9 into main Aug 21, 2025
5 checks passed
@jfversluis jfversluis deleted the pr04-messagingcenter-migration-from-main branch August 21, 2025 09:28
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.

3 participants