dotnet / dotnet/docs

CodeDomComponentSerializationService does not support loading store from a stream or saving it to a stream.

Open
#40,440 1 comment 0 reactions 0 assignees View on GitHub
winforms/subsvc
Dominant language
No language data
Stars
4.8k
Forks
6.1k
Avg merge
19h 10m
Merged PRs (30d)
268

Description

### Describe the issue or suggestion

1. Update https://learn.microsoft.com/dotnet/api/system.componentmodel.design.serialization.codedomcomponentserializationservice?view=windowsdesktop-8.0 article for .NET 3.1 - NET 9.0 versions to reflect that this service no longer supports serialization or deserialization and is provided on the .NET platform only for binary compatibility with the .NET Framework to support application migration.

The current remarks section is applicable only to the .NET Framework. I suggest prefixing the first paragraph with `On .NET Framework,..`. And adding a 3rd paragraph that describes what is available on .NET:
```
On .NET, class can create a and serialize objects into it or deserialize collection of objects from it,
but that store can't be saved to a stream, nor can a new store be loaded from a stream, as the
and methods are not supported on this platform.
```

2. Update https://learn.microsoft.com/dotnet/api/system.componentmodel.design.serialization.codedomcomponentserializationservice.loadstore?view=windowsdesktop-8.0#system-componentmodel-design-serialization-codedomcomponentserializationservice-loadstore(system-io-stream) articles as applicable to .NET 3.1-.NET9 to say that this method is not supported on .NET and is provided only for binary compatibility to facilitate migration of application from the .NET Framework. This method always throws `PlatformNotSupportedException` on .NET.

Documentation for other methods in CodeDomComponentSerializationService class looks good, it does not mention serialization to / from a stream, and these methods are still supported.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.