支援的資料類型

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") }; ;

  }

}