Update note on XSLT support in .NET versions#51850
Conversation
Clarified note about script blocks and XSLT compiler support across .NET versions.
There was a problem hiding this comment.
Pull request overview
This PR clarifies the documentation note about script blocks and xsltc.exe support, to prevent readers from assuming XSLT-compiled assemblies can be produced on .NET Framework and then reused on modern .NET runtimes.
Changes:
- Expanded the NOTE to include XSLT compiler (
xsltc.exe) support limitations. - Added guidance that assemblies produced by
xsltc.exearen’t usable on .NET Core or .NET 5+.
|
|
||
| > [!NOTE] | ||
| > Script blocks are supported only in .NET Framework. They are _not_ supported on .NET Core or .NET 5 or later. | ||
| > Script blocks and the XSLT compiler are supported only in .NET Framework. They are _not_ supported on .NET Core or .NET 5 or later, and assemblies compiled using xsltc.exe cannot be loaded into .NET Core or .NET 5 or later. |
There was a problem hiding this comment.
The note makes an absolute compatibility claim ("assemblies ... cannot be loaded") without explaining the limitation. Consider rephrasing to the supported statement (for example, that assemblies produced by the .NET Framework xsltc.exe target .NET Framework and might fail to load on .NET Core/.NET 5+ due to missing dependencies), so the guidance stays accurate and actionable.
|
|
||
| > [!NOTE] | ||
| > Script blocks are supported only in .NET Framework. They are _not_ supported on .NET Core or .NET 5 or later. | ||
| > Script blocks and the XSLT compiler are supported only in .NET Framework. They are _not_ supported on .NET Core or .NET 5 or later, and assemblies compiled using xsltc.exe cannot be loaded into .NET Core or .NET 5 or later. |
There was a problem hiding this comment.
Format xsltc.exe as code (xsltc.exe) and consider splitting this note into shorter sentences (it currently repeats "on .NET Core or .NET 5 or later" and is hard to scan).
|
|
||
| > [!NOTE] | ||
| > Script blocks are supported only in .NET Framework. They are _not_ supported on .NET Core or .NET 5 or later. | ||
| > Script blocks and the XSLT compiler are supported only in .NET Framework. They are _not_ supported on .NET Core or .NET 5 or later, and assemblies compiled using xsltc.exe cannot be loaded into .NET Core or .NET 5 or later. |
There was a problem hiding this comment.
| > Script blocks and the XSLT compiler are supported only in .NET Framework. They are _not_ supported on .NET Core or .NET 5 or later, and assemblies compiled using xsltc.exe cannot be loaded into .NET Core or .NET 5 or later. | |
| > Script blocks and the XSLT compiler are supported only in .NET Framework. They are _not_ supported on modern .NET, and assemblies compiled using xsltc.exe cannot be loaded into .NET Core or .NET 5 and later. |
There was a problem hiding this comment.
Richard Lander was recently pointing out to me that "modern .NET" isn't a thing. It's .NET or .NET Framework.
Clarified note about script blocks and XSLT compiler support across .NET versions.
I received a question about this from a customer, citing that the documentation was misleading. They tried using xsltc.exe to create an assembly with .NET Framework and then load that into .NET 10 for processing and found it has a dependency on System.Data.SqlXml.dll.
Internal previews