DataContractSerializer 範例

DataContractSerializer 範例示範 DataContractSerializer，這會執行資料合約類別的一般序列化與還原序列化服務。 此範例會建立 Record 物件，將其序列化為記憶體資料流，然後將該記憶體資料流還原序列化為另一個 Record 物件，以示範 DataContractSerializer 的使用方式。 此範例會接著會序列化使用二進位寫入器的 Record 物件，以便示範該寫入器會如何影響序列化。

下列範例程式碼示範 Record 的資料合約。

[DataContract(Namespace="http://Microsoft.ServiceModel.Samples")]
internal class Record
{
    private double n1;
    private double n2;
    private string operation;
    private double result;

    internal Record(double n1, double n2, string operation, double result)
    {
        this.n1 = n1;
        this.n2 = n2;
        this.operation = operation;
        this.result = result;
    }

    [DataMember]
    internal double OperandNumberOne
    {
        get { return n1; }
        set { n1 = value; }
    }

    [DataMember]
    internal double OperandNumberTwo
    {
        get { return n2; }
        set { n2 = value; }
    }

    [DataMember]
    internal string Operation
    {
        get { return operation; }
        set { operation = value; }
    }

    [DataMember]
    internal double Result
    {
        get { return result; }
        set { result = value; }
    }

    public override string ToString()
    {
        return $"Record: {n1} {operation} {n2} = {result}";
    }
}

此段範例程式碼會建立名為 Record 的 record1 物件，並接著顯示該物件。

Record record1 = new Record(1, 2, "+", 3);
Console.WriteLine("Original record: {0}", record1.ToString());

此範例會接著使用 DataContractSerializer，將 record1 序列化為記憶體資料流。

MemoryStream stream1 = new MemoryStream();

//Serialize the Record object to a memory stream using DataContractSerializer.
DataContractSerializer serializer = new DataContractSerializer(typeof(Record));
serializer.WriteObject(stream1, record1);

接下來，此範例會使用 DataContractSerializer，將記憶體資料流還原序列化為新 Record 物件，並顯示該物件。

stream1.Position = 0;

//Deserialize the Record object back into a new record object.
Record record2 = (Record)serializer.ReadObject(stream1);

Console.WriteLine("Deserialized record: {0}", record2.ToString());

根據預設，DataContractSerializer 會將物件編碼為使用 XML 文字表示法的資料流。 但是，您可以傳遞不同的寫入器來決定 XML 編碼的方式。 此範例會透過呼叫 CreateBinaryWriter 來建立二進位寫入器。 接著此範例會在呼叫 WriteObjectContent 時，將寫入器與記錄物件傳遞至序列化程式。 最後，此範例會清除寫入器，並報告關於資料流長度的資訊。

MemoryStream stream2 = new MemoryStream();

XmlDictionaryWriter binaryDictionaryWriter = XmlDictionaryWriter.CreateBinaryWriter(stream2);
serializer.WriteObject(binaryDictionaryWriter, record1);
binaryDictionaryWriter.Flush();

//report the length of the streams
Console.WriteLine("Text Stream is {0} bytes long", stream1.Length);
Console.WriteLine("Binary Stream is {0} bytes long", stream2.Length);

當執行範例時，原始記錄與已還原序列化的記錄會顯示出來，之後會顯示文字編碼與二進位編碼長度之間的比較結果。 在用戶端視窗中按下 ENTER 鍵，即可關閉用戶端。

Original record: Record: 1 + 2 = 3
Deserialized record: Record: 1 + 2 = 3
Text Stream is 233 bytes long
Binary Stream is 156 bytes long

Press <ENTER> to terminate client.

若要安裝、建置及執行範例

1. 確定您已執行 Windows Communication Foundation 範例的一次性安裝程序。

2. 若要建置方案的 C# 或 Visual Basic .NET 版本，請遵循 Building the Windows Communication Foundation Samples中的指示。

3. 若要執行範例，請從命令提示字元輸入 client\bin\client.exe 以啟動用戶端。