Export (0) Print
Expand All

MimeFormatter Class

Provides an abstract base class for all readers and writers for Web services and clients implemented using HTTP but without SOAP.

Namespace:  System.Web.Services.Protocols
Assembly:  System.Web.Services (in System.Web.Services.dll)

public abstract class MimeFormatter

The MimeFormatter type exposes the following members.

  NameDescription
Protected methodMimeFormatterInitializes a new instance of the MimeFormatter class.
Top

  NameDescription
Public methodStatic memberCreateInstanceCreates and initializes an instance of a concrete class derived from MimeFormatter.
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetInitializer(LogicalMethodInfo)When overridden in a derived class, returns an initializer for the specified method.
Public methodStatic memberGetInitializer(Type, LogicalMethodInfo)Returns an initializer for the specified method.
Public methodGetInitializers(LogicalMethodInfo[])When overridden in a derived class, returns an array of initializer objects corresponding to an input array of method definitions.
Public methodStatic memberGetInitializers(Type, LogicalMethodInfo[])Returns an array of initializer objects corresponding to an input array of method definitions for a specified class derived from MimeFormatter.
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodInitializeWhen overridden in a derived class, initializes an instance.
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

Web service writers and readers serialize and deserialize, respectively, between the parameter or return objects of Web methods and the HTTP request or response streams. The MimeFormatter class establishes a common interface and functionality for reader and writer classes, in both client and service-side .

The MimeFormatter class supports the .NET Framework's implementations of Web services via the HTTP-GET and HTTP-POST operations. In HTTP-GET operations request parameters are encoded in the HTTP request's Uniform Resource Locator (URL). In HTTP-POST operations, request parameters are encoded in the HTTP request body, as with an HTML form. With both implementations, the return value appears in the HTTP response body as a non-SOAP XML document.

A developer typically does not need to directly use MimeFormatter or its descendant classes. Instead, when the Wsdl.exe tool generates client proxy code according to the HTTP-GET or HTTP-POST implementations, it applies the HttpMethodAttribute to each Web method and sets the attribute's ParameterFormatter and ReturnFormatter properties to the appropriate type derived from the MimeFormatter class. On the server, the appropriate derived types are used according to settings in an ASP.NET configuration file (Web.config). On the client the appropriate derived types are determined from the WSDL.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft