BinaryFormatter序列化实例（一）

前几天写了一篇.NET序列化概述性的文章，有朋友说对技术的描述不够详细，因此准备写一系列文章，以一个实例为基础，详细描述各种序列化的使用方法和注意事项。这一系列文章是为不熟悉序列化的读者准备的，已用过序列化的可以只看一下每篇中加粗的一句话，感兴趣再阅读全文。文中的示例类Voucher和VoucherItem非常简化，实际中的凭证包含更多的信息。 
　　财务系统中经常要与凭证打交道，在这篇文章里，我们要实现一个Voucher类，它包含凭证和业务信息，并且能够保存为磁盘文件，以便于没有专用网络的分布式企业中，可以在终端输入凭证，然后通过拨号的方式将凭证批量更新到中心业务系统中。 
　　凭证中除了包含凭证号，制单人，制单时间等外，还包含多条项目。假设凭证项目也由其他人完成，以Assembly的方式提供，类名为VoucherItem，其定义如下： 

public   class  VoucherItem 
{ 
    public VoucherItem() {} 
 
    public string AccountId {get;set;} 
    public decimal DebitAmount {get;set;} 
    public decimal CreaditAmount {get;set;} 
}

　　首先，我们要实现Voucher的主体类及其序列化，然后再把VoucherItem加到Voucher类上。  

public   class  Voucher 
{ 
    private string voucherId; 
    private string creator; 
    private DateTime createTime; 
    private string description; 
     
    public Voucher(string voucherId, string creator, DateTime createTime) 
    { 
        this.voucherId = voucherId; 
        this.creator = creator; 
        this.createTime = createTime; 
    } 
 
    public string VoucherId 
    { 
        get 
        { 
            return voucherId; 
        } 
    } 
 
    public string Creator 
    { 
        get 
        { 
            return creator; 
        } 
    } 
 
    public DateTime CreateTime 
    { 
        get 
        { 
            return createTime; 
        } 
    } 
 
    public string Description 
    { 
        get 
        { 
            return description; 
        } 
        set 
        { 
            description = value; 
        } 
    } 
}

　　为了将Voucher保存到磁盘，考虑最直接的方法是序列化，而为了通过拨号传到业务中心的需要，应当保存较小的磁盘文件，所以使用二进制序列化。  
序列化代码如下：  

public   class  VoucherSerializer 
{ 
    public VoucherSerializer() 
    { 
         
    } 
 
    public void Serialize(string filename, Voucher voucher) 
    { 
        BinaryFormatter formatter = new BinaryFormatter(); 
        FileStream fs = new FileStream(filename, FileMode.Create); 
        formatter.Serialize(fs, voucher); 
        fs.Close(); 
    } 
}

　　从上面的代码可以看出，借助.NET Framework的帮助，实现类的二进制序列化是非常容易的。序列化方法写好后，马上用NUnit做一个测试类。  

 

[TestFixture] 
public   class  VoucherTest 
{ 
    public VoucherTest() 
    { 
 
    } 
 
    [Test] 
    public void TestSerializeVoucher() 
    { 
        Voucher voucher = new Voucher("2005012900001", "xingd", DateTime.Now); 
 
        VoucherSerializer serializer = new VoucherSerializer(); 
        serializer.Serialize("voucher.dat", voucher); 
    } 
}

　　兴冲冲地打开NUnit GUI，选中Assembly，运行测试。 
　　啊，怎么会有错误呢，这么简单的类。 
GeneralLedger.VoucherTest.TestSerializeVoucher : System.Runtime.Serialization.SerializationException : The type GeneralLedger.Voucher in Assembly Voucher, Version=1.0.1855.38026, Culture=neutral, PublicKeyToken=null is not marked as serializable. 

　　原来是这个错。能够进行二进制序列化的类必须在类定义中添加SerializableAttribute。对Voucher类进行如下修改： 

[Serializable] 
public   class  Voucher

　　  
　　运行NUnit，测试通过，生成的文件内容如下：   
 

　　后面的随笔将会对此文件的格式进行分析。