[转][WebServices] 之二：支持的数据类型

转自:http://www.rainsts.net/article.asp?id=297

ASP.NET WebService 支持绝大多数的基元类型及其数组，另外还支持自定义的结构(Struct)、类型(Class)、枚举(Enum)、DataSet、XmlElement、XmlNode、集合(IEnumerable/ICollection)等。

ASP.NET WebService 使用 XmlSerializer 进行序列化操作，对于自定义类型要注意以下几点：

1. 只能序列化可读写公共属性和字段。只读属性(get;)、只读字段(readonly)、常量(const)以及所有的非 public 数据成员都不会被序列化。
2. 自定义类型必须具有不接受任何参数的默认构造函数。
3. 不能序列化方法。客户端生成的代理对象不包含任何自定义类型方法(不是WebMethod)。

基于以上几点，因此我们最好只定义纯粹用来传输复合数据的数据类型(Data Object)。

以下是一些演示代码。

基元类型

[WebService(Namespace = "http://www.rainsts.net/", Description="我的Web服务")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
public class WebService : System.Web.Services.WebService {

    public WebService () {
    }

    [WebMethod]
    public DateTime GetNowTime()
    {
        return DateTime.Now;
    }

    [WebMethod]
    public string[] GetStringArray()
    {
        return new string[] { "a", "b", "c"};
    }

    [WebMethod]
    public float[] GetFloatArray()
    { 
        return new float[]{1F, 2F, 3F};
    }

    [WebMethod]
    public byte[] GetBytes()
    {
        return System.IO.File.ReadAllBytes(@"c:\windows\notepad.exe");
    }
}

枚举 Enum

public enum Sex
{
    Female,
    Male
}

[WebService(Namespace = "http://www.rainsts.net/", Description="我的Web服务")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
public class WebService : System.Web.Services.WebService {

    public WebService () {
    }

    [WebMethod]
    public Sex GetSex()
    {
        return Sex.Female;
    }

    [WebMethod]
    public Sex[] GetAllSex()
    {
        return Enum.GetValues(typeof(Sex)) as Sex[];
    }
}

结构 Struct 

结构体默认就会创建无参数构造方法，且不允许自定义。

public struct MyStruct
{
    public int X;
    public int Y;

    public MyStruct(int x, int y)
    {
        this.X = x;
        this.Y = y;
    }
}

[WebService(Namespace = "http://www.rainsts.net/", Description="我的Web服务")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
public class WebService : System.Web.Services.WebService {

    public WebService () {
    }

    [WebMethod]
    public MyStruct GetMyStruct()
    {
        MyStruct st = new MyStruct(15, 16);
        return st;
    }

    [WebMethod]
    public MyStruct[] GetMyStructs()
    {
        return new MyStruct[] { new MyStruct(1, 2), new MyStruct(3, 4) }; ;
    }
}

类型 Class

public struct MyStruct
{
    public int X;
    public int Y;

    public MyStruct(int x, int y)
    {
        this.X = x;
        this.Y = y;
    }
}

public class MyClass
{
    public MyClass()
    {
        myStruct = new MyStruct();
    }

    public MyClass(int x, int y, string name) : this()
    {
        myStruct.X = x;
        myStruct.Y = y;
        this.name = name;
    }

    private string name;

    public string Name
    {
        get { return name; }
        set { name = value; }
    }

    private MyStruct myStruct;

    public MyStruct MyStruct
    {
        get { return myStruct; }
        set { myStruct = value; }
    }

    public void Test() // 客户端代理不会生成该方法。
    {
        Console.WriteLine(name);
    }
}

[WebService(Namespace = "http://www.rainsts.net/", Description="我的Web服务")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
public class WebService : System.Web.Services.WebService {

    public WebService () {
    }

    [WebMethod]
    public MyClass GetMyClass()
    {
        return new MyClass(1, 2, "name1");
    }

    [WebMethod]
    public MyClass[] GetMyClassArray()
    {
        return new MyClass[] { new MyClass(1, 2, "name1"), new MyClass(2, 3, "name2") }; ;
    }
}

有关数据类型的更详细信息，请查看 MSDN 文档。

ms-help://MS.MSDNQTR.v80.chs/MS.MSDN.v80/MS.VisualStudio.v80.chs/dv_fxwebservices/html/70567d9f-6e53-42a8-bbd5-aee42b25dd28.htm