DataContractSerializer 的 MSDN 文档是否不正确？

Question

MSDN documentation for DataContractSerializer 包含以下语句：

只读字段、没有 get 或 set 方法的属性以及具有内部或私有 set 或 get 方法的属性不会序列化。此类属性将被忽略且不会引发异常，除非是 get-only 集合。

但是，我刚刚创建了以下程序，它可以很好地序列化只读、仅获取和私有集属性。是我误解了什么，还是文档不正确？

using System;
using System.IO;
using System.Runtime.Serialization;
using System.Xml;

namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            string saveFile = "save.xml";
            Foo originalFoo = new Foo();
            SaveState(originalFoo, saveFile);
            Foo restoredFoo = LoadState<Foo>(saveFile);
        }
        public static void SaveState(Object o, string saveFile)
        {
            DataContractSerializer serializer = new DataContractSerializer(o.GetType());
            using (var writer = XmlWriter.Create(saveFile))
                serializer.WriteObject(writer, o);
        }
        public static T LoadState<T>(string loadFile)
        {
            using (var stream = new FileStream(loadFile, FileMode.Open))
            {
                DataContractSerializer serializer = new DataContractSerializer(typeof(T));
                T obj = (T)serializer.ReadObject(stream);
                return obj;
            }
        }
    }

    [Serializable]
    public class Foo
    {
        private readonly int X;
        private int Y { get; }
        internal int Z { get; private set; }
        public Foo()
        {
            X = Y = Z = 10;
        }
    }
}

Answer 1

您使用了Serializable 属性，它指示序列化程序序列化所有内容。来自文档：

将 SerializableAttribute 属性应用于类型时，默认情况下会序列化所有私有和公共字段。您可以通过实现 ISerializable 接口来覆盖序列化过程，从而更精细地控制序列化。

如果您省略所有属性，则仅对公共属性和字段进行序列化，如文档中所述。例如，如果您添加 W 属性：

public class Foo
{
    private readonly int X;
    private int Y { get; }
    internal int Z { get; private set; }


    public int W { get; set; }
    public Foo()
    {
        X = Y = Z = 10;
    }
}

生成的文件将包含：

<?xml version="1.0" encoding="utf-8"?>
<Foo xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SO_Serializer">
    <W>15</W>
</Foo>

如果将DataContract属性添加到类中，则只有标有DataMember的成员会被序列化

Answer 2

不，没有错！

只读字段、没有 get 或 set 方法的属性以及具有内部或私有 set 或 get 方法的属性不会序列化。此类属性将被忽略并且不会引发异常，除非是 get-only 集合。

应用 SerializableAttribute 属性，即使该类也实现了 ISerializable 接口来控制序列化过程。

将 SerializableAttribute 属性应用于类型时，默认情况下会序列化所有私有和公共字段。您可以通过实现 ISerializable 接口来覆盖序列化过程，从而更精细地控制序列化。

或者您可以通过将 NonSerializedAttribute 属性应用于字段来从序列化中排除字段。如果可序列化类型的字段包含特定于特定环境的指针、句柄或某些其他数据结构，并且无法在不同的环境中有意义地重构，则您可能希望将 NonSerializedAttribute 属性应用于该字段。