1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237
|
<?xml version="1.0" encoding="utf-8"?>
<Type Name="MimeFormatter" FullName="System.Web.Services.Protocols.MimeFormatter">
<TypeSignature Language="C#" Value="public abstract class MimeFormatter" Maintainer="auto" />
<AssemblyInfo>
<AssemblyName>System.Web.Services</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>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 <see cref="T:System.Web.Services.Protocols.MimeFormatter" /> class establishes a common interface and functionality for reader and writer classes, in both client and service-side .</para>
<para>The <see cref="T:System.Web.Services.Protocols.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.</para>
<para>A developer typically does not need to directly use <see cref="T:System.Web.Services.Protocols.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 <see cref="T:System.Web.Services.Protocols.HttpMethodAttribute" /> to each Web method and sets the attribute's <see cref="P:System.Web.Services.Protocols.HttpMethodAttribute.ParameterFormatter" /> and <see cref="P:System.Web.Services.Protocols.HttpMethodAttribute.ReturnFormatter" /> properties to the appropriate type derived from the <see cref="T:System.Web.Services.Protocols.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.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides an abstract base class for all readers and writers for Web services and clients implemented using HTTP but without SOAP.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected MimeFormatter ();" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Services.Protocols.MimeFormatter" /> class. </para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="CreateInstance">
<MemberSignature Language="C#" Value="public static System.Web.Services.Protocols.MimeFormatter CreateInstance (Type type, object initializer);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Web.Services.Protocols.MimeFormatter</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="type" Type="System.Type" />
<Parameter Name="initializer" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Web.Services.Protocols.MimeFormatter.CreateInstance(System.Type,System.Object)" /> method creates an instance of the derived class and invokes the derived class's implementation of the abstract <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method. The <see cref="M:System.Web.Services.Protocols.MimeFormatter.CreateInstance(System.Type,System.Object)" /> method is invoked at the time a request or response is processed.</para>
<para>An initializer is an object passed as a parameter to the <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method. The initializer passed as a parameter to the <see cref="M:System.Web.Services.Protocols.MimeFormatter.CreateInstance(System.Type,System.Object)" /> method is obtained from another instance of the derived class, by invoking the <see cref="Overload:System.Web.Services.Protocols.MimeFormatter.GetInitializer" /> method during client or service initialization.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates and initializes an instance of a concrete class derived from <see cref="T:System.Web.Services.Protocols.MimeFormatter" />.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Web.Services.Protocols.MimeFormatter" /> object.</para>
</returns>
<param name="type">
<attribution license="cc4" from="Microsoft" modified="false" />The Type, derived from <see cref="T:System.Web.Services.Protocols.MimeFormatter" />, of which to create an instance.</param>
<param name="initializer">
<attribution license="cc4" from="Microsoft" modified="false" />An object used to initialize the instance obtained earlier through the derived class's implementation of the <see cref="M:System.Web.Services.Protocols.MimeFormatter.GetInitializer(System.Web.Services.Protocols.LogicalMethodInfo)" /> method.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetInitializer">
<MemberSignature Language="C#" Value="public abstract object GetInitializer (System.Web.Services.Protocols.LogicalMethodInfo methodInfo);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="methodInfo" Type="System.Web.Services.Protocols.LogicalMethodInfo" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An initializer is an object passed as a parameter to the <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method.</para>
<para>A derived class's implementation of the <see cref="M:System.Web.Services.Protocols.MimeFormatter.GetInitializer(System.Web.Services.Protocols.LogicalMethodInfo)" /> instance method is invoked during client or service initialization. Later, at the time a request or response is processed, the initializer object is passed to the static <see cref="M:System.Web.Services.Protocols.MimeFormatter.CreateInstance(System.Type,System.Object)" /> method, which creates an instance of another object of the derived class, and then to the <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method to initialize it. The other object performs the actual reading or writing.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When overridden in a derived class, returns an initializer for the specified method.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Object" /> that contains the initializer for the specified method.</para>
</returns>
<param name="methodInfo">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" /> that specifies the Web method for which the initializer is obtained.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetInitializer">
<MemberSignature Language="C#" Value="public static object GetInitializer (Type type, System.Web.Services.Protocols.LogicalMethodInfo methodInfo);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="type" Type="System.Type" />
<Parameter Name="methodInfo" Type="System.Web.Services.Protocols.LogicalMethodInfo" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An initializer is an object passed as a parameter to the <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method.</para>
<para>The static <see cref="M:System.Web.Services.Protocols.MimeFormatter.GetInitializer(System.Type,System.Web.Services.Protocols.LogicalMethodInfo)" /> method invokes the derived class's <see cref="M:System.Web.Services.Protocols.MimeFormatter.GetInitializer(System.Web.Services.Protocols.LogicalMethodInfo)" /> method, implicitly creating an instance of the derived class. At the time a request or response is processed, the initializer object is passed to the <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method of another instance of the derived class. The latter object performs the actual reading or writing.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns an initializer for the specified method.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Object" /> object that contains the initializer for the specified method.</para>
</returns>
<param name="type">
<attribution license="cc4" from="Microsoft" modified="false" />The Type, derived from <see cref="T:System.Web.Services.Protocols.MimeFormatter" />,- for which an initializer is obtained.</param>
<param name="methodInfo">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" /> that specifies the Web method for which the initializer is obtained.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetInitializers">
<MemberSignature Language="C#" Value="public virtual object[] GetInitializers (System.Web.Services.Protocols.LogicalMethodInfo[] methodInfos);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object[]</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="methodInfos" Type="System.Web.Services.Protocols.LogicalMethodInfo[]" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An initializer is an object passed as a parameter to the <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method.</para>
<para>The <see cref="M:System.Web.Services.Protocols.MimeFormatter.GetInitializers(System.Web.Services.Protocols.LogicalMethodInfo[])" /> instance method invokes the <see cref="M:System.Web.Services.Protocols.MimeFormatter.GetInitializer(System.Web.Services.Protocols.LogicalMethodInfo)" /> instance method for each input Web method. This means an instance of a class derived from <see cref="T:System.Web.Services.Protocols.MimeFormatter" /> has already been created. At the time a request or response is processed, the initializer is passed to the <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method of another instance of the derived class. The latter object performs the actual reading or writing.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When overridden in a derived class, returns an array of initializer objects corresponding to an input array of method definitions.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An array of initializer objects corresponding to the input array of method definitions.</para>
</returns>
<param name="methodInfos">
<attribution license="cc4" from="Microsoft" modified="false" />An array of Web methods where, for each method, the object of the corresponding index in the returned initializer array is obtained.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetInitializers">
<MemberSignature Language="C#" Value="public static object[] GetInitializers (Type type, System.Web.Services.Protocols.LogicalMethodInfo[] methodInfos);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object[]</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="type" Type="System.Type" />
<Parameter Name="methodInfos" Type="System.Web.Services.Protocols.LogicalMethodInfo[]" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An initializer is an object passed as a parameter to the <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method.</para>
<para>The static <see cref="M:System.Web.Services.Protocols.MimeFormatter.GetInitializers(System.Type,System.Web.Services.Protocols.LogicalMethodInfo[])" /> method causes the invocation of the <see cref="M:System.Web.Services.Protocols.MimeFormatter.GetInitializer(System.Web.Services.Protocols.LogicalMethodInfo)" /> method belonging to the derived class specified by the <paramref name="type" /> parameter.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns an array of initializer objects corresponding to an input array of method definitions for a specified class derived from <see cref="T:System.Web.Services.Protocols.MimeFormatter" />.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An array of initializer objects corresponding to the input array of method definitions for a specified class derived from <see cref="T:System.Web.Services.Protocols.MimeFormatter" />.</para>
</returns>
<param name="type">
<attribution license="cc4" from="Microsoft" modified="false" />The Type, derived from <see cref="T:System.Web.Services.Protocols.MimeFormatter" />, for which initializers are obtained.</param>
<param name="methodInfos">
<attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" /> that specifies the Web methods for which the initializers are obtained.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Initialize">
<MemberSignature Language="C#" Value="public abstract void Initialize (object initializer);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="initializer" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method is invoked at the time a request or response is processed; however, the initializer is obtained by calling the <see cref="M:System.Web.Services.Protocols.MimeFormatter.GetInitializer(System.Web.Services.Protocols.LogicalMethodInfo)" /> method on another instance during client or service initialization.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When overridden in a derived class, initializes an instance.</para>
</summary>
<param name="initializer">
<attribution license="cc4" from="Microsoft" modified="false" />An object of a type appropriate to the particular class that is implementing the method. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>
|