Update Reflection.Emit docs to clarify framework support#51035
Merged
gewarren merged 3 commits intodotnet:mainfrom Jan 15, 2026
Merged
Update Reflection.Emit docs to clarify framework support#51035gewarren merged 3 commits intodotnet:mainfrom
gewarren merged 3 commits intodotnet:mainfrom
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This pull request updates Reflection.Emit documentation to clarify .NET Framework vs. modern .NET support. The main changes rename reflection.md to overview.md and add important notices to reflection emit how-to articles indicating they show .NET Framework-specific APIs not available in modern .NET.
Changes:
- Renamed
docs/fundamentals/reflection/reflection.mdtooverview.mdwith redirect configuration - Added important notices to reflection emit how-to articles clarifying .NET Framework-only support
- Updated cross-references throughout documentation from
reflection.mdtooverview.md - Added new C# code snippets for generic type instantiation and updated existing reflection emit samples
- Modernized code syntax (collection expressions, target-typed new, improved formatting)
- Updated table formatting in dynamically-loading-and-using-types.md
Reviewed changes
Copilot reviewed 24 out of 29 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/fundamentals/reflection/overview.md | Renamed from reflection.md (frontmatter cleanup) |
| docs/fundamentals/reflection/how-to-define-a-generic-type-with-reflection-emit.md | Added .NET Framework-only notice, updated title, and modernized content structure |
| docs/fundamentals/reflection/how-to-define-a-generic-method-with-reflection-emit.md | Added .NET Framework-only notice and updated title |
| docs/fundamentals/reflection/how-to-examine-and-instantiate-generic-types-with-reflection.md | Updated code snippet references to new directory structure |
| docs/fundamentals/reflection/snippets/csharp/instantiate-generic-type/* | New code samples demonstrating generic type instantiation |
| docs/fundamentals/reflection/snippets/csharp/emit-generic-type/* | Modernized existing code with new C# syntax features |
| docs/fundamentals/reflection/snippets/csharp/construct-generic-method/* | New complete code sample for generic method construction |
| docs/fundamentals/runtime-libraries/system-reflection-emit-persistedassemblybuilder.md | Minor wording improvements for clarity |
| docs/fundamentals/reflection/dynamically-loading-and-using-types.md | Improved table formatting with code formatting for type names |
| Multiple cross-reference files | Updated links from reflection.md to overview.md |
| .openpublishing.redirection.fundamentals.json | Added redirect rule for renamed file |
BillWagner
approved these changes
Jan 15, 2026
Member
BillWagner
left a comment
There was a problem hiding this comment.
This LGTM, but we should point out the use of an unsupported scenario.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #50740.
Internal previews
Toggle expand/collapse