INFO: Supported Data Types for Web Services That Are Called Through the SOAP Protocol or the HTTP Protocol (326791)



The information in this article applies to:

  • Microsoft Visual Studio .NET (2003), Enterprise Architect Edition
  • Microsoft Visual Studio .NET (2003), Enterprise Developer Edition
  • Microsoft Visual Studio .NET (2003), Professional Edition
  • Microsoft Visual Studio .NET (2003), Academic Edition
  • Microsoft Visual Studio .NET (2002), Enterprise Architect Edition
  • Microsoft Visual Studio .NET (2002), Enterprise Developer Edition
  • Microsoft Visual Studio .NET (2002), Professional Edition
  • Microsoft Visual Studio .NET (2002), Academic Edition

This article was previously published under Q326791

SUMMARY

This article discusses information about the data types that are supported by an XML Web service. The data types that are supported by an XML Web service are dependant on calling the Web service through the SOAP protocol or the HTTP protocol.

MORE INFORMATION

The following table lists the supported data types for the XML Web service methods when you use SOAP.
TypeDescription
Primitive TypesStand primitive types. The complete list of the supported primitives is String, Char, Byte, Boolean, Int16, Int32, Int64, UInt16, UInt32, UInt64, Single, Double, Guid, Decimal, DateTime, and XmlQualifiedName.
Enum TypesEnumeration types.
Class and Structure TypesClass types and structure types with public fields or with properties. The public properties and the fields are serialized.
DataSet TypesADO.NET DataSet Types.
XmlNode TypesIt is an in-memory representation for an XML fragment.
Array TypesArrays of the previous types.
The previous data types are also supported for the return values of a Web service when an XML Web service is called through the SOAP protocol, the HTTP GET protocol, or the HTTP POST protocol.

The following limited data types are supported when an XML Web service is called through the HTTP GET protocol or the HTTP POST protocol.

The following supported types are limited:
TypeDescription
Primitive Types (Limited)Most stand primitive types. The complete list of the supported primitives is String, Char, Byte, Boolean, Int16, Int32, Int64, UInt16, UInt32, UInt64, Single, Double, Decimal, and DateTime.
Enum TypesEnumeration types.
Array TypesArrays of the previous types.
Both the by-value parameter and the by-reference (in and out) parameter are supported when you use the SOAP protocol. The HTTP GET protocol and the HTTP POST protocol only support the by-value parameter. The by-reference parameter sends a value both ways by sending a value to the server and then sending the value back to the client.

REFERENCES

For additional information about SOAP, visit the following Microsoft Web site:


Modification Type:MajorLast Reviewed:8/28/2003
Keywords:kbWebServices kbhttp kbinfo KB326791 kbAudDeveloper