mcs/class/System/Documentation/en/System.Net/HttpWebResponse.xml

   1 <Type Name="HttpWebResponse" FullName="System.Net.HttpWebResponse" FullNameSP="System_Net_HttpWebResponse" Maintainer="ecma">
   2   <TypeSignature Language="ILASM" Value=".class public serializable HttpWebResponse extends System.Net.WebResponse" />
   3   <TypeSignature Language="C#" Value="public class HttpWebResponse : System.Net.WebResponse, IDisposable, System.Runtime.Serialization.ISerializable" />
   4   <TypeSignature Language="ILAsm" Value=".class public auto ansi serializable beforefieldinit HttpWebResponse extends System.Net.WebResponse implements class System.IDisposable, class System.Runtime.Serialization.ISerializable" />
   5   <MemberOfLibrary>Networking</MemberOfLibrary>
   6   <AssemblyInfo>
   7     <AssemblyName>System</AssemblyName>
   8     <AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey>
   9     <AssemblyVersion>1.0.x.x</AssemblyVersion>
  10     <AssemblyVersion>1.0.5000.0</AssemblyVersion>
  11     <AssemblyVersion>2.0.0.0</AssemblyVersion>
  12     <AssemblyVersion>4.0.0.0</AssemblyVersion>
  13   </AssemblyInfo>
  14   <ThreadingSafetyStatement>All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.</ThreadingSafetyStatement>
  15   <Base>
  16     <BaseTypeName>System.Net.WebResponse</BaseTypeName>
  17   </Base>
  18   <Interfaces>
  19     <Interface>
  20       <InterfaceName>System.IDisposable</InterfaceName>
  21     </Interface>
  22     <Interface>
  23       <InterfaceName>System.Runtime.Serialization.ISerializable</InterfaceName>
  24     </Interface>
  25   </Interfaces>
  26   <Docs>
  27     <summary>
  28       <para>Provides an HTTP-specific implementation of the
  29    <see cref="T:System.Net.WebResponse" />
  30    class.</para>
  31     </summary>
  32     <remarks>
  33       <block subset="none" type="note">
  34         <para>The <see cref="T:System.Net.HttpWebResponse" /> class contains support for the
  35       properties and methods included in <see cref="T:System.Net.WebResponse" /> with
  36       additional
  37       elements that
  38       enable the user to interact directly with the Hypertext Transfer Protocol (HTTP).</para>
  39         <para>Expected usage is that instances of this class are not created directly but
  40       are obtained by calling
  41    <see cref="M:System.Net.HttpWebRequest.GetResponse" qualify="true" /> . To obtain the response from the Internet resource as a
  42    <see cref="T:System.IO.Stream" />
  43    , call the <see cref="M:System.Net.HttpWebResponse.GetResponseStream" /> method.
  44    </para>
  45         <para>Certain HTTP headers are protected such that the user
  46    cannot set them directly in the header collection. Instead, these headers can be
  47    set via the properties of the <see cref="T:System.Net.HttpWebRequest" /> class or are set by the system. The following table
  48    details these protected headers.</para>
  49         <list type="table">
  50           <listheader>
  51             <term>Header</term>
  52             <description>Set by</description>
  53           </listheader>
  54           <item>
  55             <term> Accept</term>
  56             <description>
  57               <see cref="P:System.Net.HttpWebRequest.Accept" />
  58             </description>
  59           </item>
  60           <item>
  61             <term> Connection</term>
  62             <description>
  63               <para>
  64                 <see cref="P:System.Net.HttpWebRequest.Connection" />
  65               </para>
  66               <para>
  67                 <see cref="P:System.Net.HttpWebRequest.KeepAlive" />
  68               </para>
  69             </description>
  70           </item>
  71           <item>
  72             <term> Content-Length</term>
  73             <description>
  74               <see cref="P:System.Net.HttpWebRequest.ContentLength" />
  75             </description>
  76           </item>
  77           <item>
  78             <term> Content-Type</term>
  79             <description>
  80               <see cref="P:System.Net.HttpWebRequest.ContentType" />
  81             </description>
  82           </item>
  83           <item>
  84             <term> Expect</term>
  85             <description>
  86               <see cref="P:System.Net.HttpWebRequest.Expect" />
  87             </description>
  88           </item>
  89           <item>
  90             <term> Date</term>
  91             <description>Set to current date by the system.</description>
  92           </item>
  93           <item>
  94             <term> Host</term>
  95             <description>Set to current host by the system.</description>
  96           </item>
  97           <item>
  98             <term> if-Modified-since</term>
  99             <description>
 100               <see cref="P:System.Net.HttpWebRequest.IfModifiedSince" />
 101             </description>
 102           </item>
 103           <item>
 104             <term> Range</term>
 105             <description>
 106               <see cref="M:System.Net.HttpWebRequest.AddRange(System.Int32,System.Int32)" />
 107             </description>
 108           </item>
 109           <item>
 110             <term> Referer</term>
 111             <description>
 112               <see cref="P:System.Net.HttpWebRequest.Referer" />
 113             </description>
 114           </item>
 115           <item>
 116             <term> Transfer-Encoding</term>
 117             <description>
 118               <para>
 119                 <see cref="P:System.Net.HttpWebRequest.TransferEncoding" />
 120               </para>
 121               <para>
 122                 <see cref="P:System.Net.HttpWebRequest.SendChunked" />
 123               </para>
 124             </description>
 125           </item>
 126           <item>
 127             <term> User-Agent</term>
 128             <description>
 129               <see cref="P:System.Net.HttpWebRequest.UserAgent" />
 130             </description>
 131           </item>
 132         </list>
 133       </block>
 134     </remarks>
 135   </Docs>
 136   <Members>
 137     <Member MemberName=".ctor">
 138       <MemberSignature Language="C#" Value="protected HttpWebResponse (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);" />
 139       <MemberSignature Language="ILAsm" Value=".method familyhidebysig specialname rtspecialname instance void .ctor(class System.Runtime.Serialization.SerializationInfo serializationInfo, valuetype System.Runtime.Serialization.StreamingContext streamingContext) cil managed" />
 140       <MemberType>Constructor</MemberType>
 141       <AssemblyInfo>
 142         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 143         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 144         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 145       </AssemblyInfo>
 146       <Attributes>
 147         <Attribute>
 148           <AttributeName>System.Obsolete("Serialization is obsoleted for this type", false)</AttributeName>
 149         </Attribute>
 150       </Attributes>
 151       <Parameters>
 152         <Parameter Name="serializationInfo" Type="System.Runtime.Serialization.SerializationInfo" />
 153         <Parameter Name="streamingContext" Type="System.Runtime.Serialization.StreamingContext" />
 154       </Parameters>
 155       <Docs>
 156         <param name="serializationInfo">To be added.</param>
 157         <param name="streamingContext">To be added.</param>
 158         <summary>To be added.</summary>
 159         <remarks>To be added.</remarks>
 160       </Docs>
 161     </Member>
 162     <Member MemberName="CharacterSet">
 163       <MemberSignature Language="ILASM" Value=".property string CharacterSet { public hidebysig specialname instance string get_CharacterSet() }" />
 164       <MemberSignature Language="C#" Value="public string CharacterSet { get; }" />
 165       <MemberSignature Language="ILAsm" Value=".property instance string CharacterSet" />
 166       <MemberType>Property</MemberType>
 167       <AssemblyInfo>
 168         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 169         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 170         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 171       </AssemblyInfo>
 172       <ReturnValue>
 173         <ReturnType>System.String</ReturnType>
 174       </ReturnValue>
 175       <Parameters />
 176       <Docs>
 177         <summary>
 178           <para>Gets the character set used for the current instance.</para>
 179         </summary>
 180         <value>
 181           <para>A <see cref="T:System.String" /> that
 182    represents the character set used for the current instance.</para>
 183         </value>
 184         <remarks>
 185           <para>This property is read-only.</para>
 186           <para>
 187             <block subset="none" type="note">For detailed
 188       information about character sets, see Section 3.4 of RFC 2616.</block>
 189           </para>
 190         </remarks>
 191         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 192       </Docs>
 193       <Excluded>0</Excluded>
 194     </Member>
 195     <Member MemberName="Close">
 196       <MemberSignature Language="ILASM" Value=".method public hidebysig virtual void Close()" />
 197       <MemberSignature Language="C#" Value="public override void Close ();" />
 198       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void Close() cil managed" />
 199       <MemberType>Method</MemberType>
 200       <AssemblyInfo>
 201         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 202         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 203         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 204       </AssemblyInfo>
 205       <ReturnValue>
 206         <ReturnType>System.Void</ReturnType>
 207       </ReturnValue>
 208       <Parameters />
 209       <Docs>
 210         <summary>
 211           <para>Closes the response stream.</para>
 212         </summary>
 213         <remarks>
 214           <para>The <see cref="M:System.Net.HttpWebResponse.Close" /> method closes the response stream and releases the connection to the Internet resource for reuse by other requests.</para>
 215           <block subset="none" type="note">
 216             <para>Call either the <see cref="M:System.IO.Stream.Close" qualify="true" /> or <see cref="M:System.Net.HttpWebResponse.Close" qualify="true" /> method to close the stream and release the connection for reuse. It is not necessary to call both <see cref="M:System.IO.Stream.Close" qualify="true" /> and <see cref="M:System.Net.HttpWebResponse.Close" qualify="true" /> , but
 217  doing so does not cause an error. Failure to close the stream might cause an
 218  application to run out of connections. </para>
 219             <para>This method overrides <see cref="M:System.Net.WebResponse.Close" />.</para>
 220           </block>
 221         </remarks>
 222       </Docs>
 223       <Excluded>0</Excluded>
 224     </Member>
 225     <Member MemberName="ContentEncoding">
 226       <MemberSignature Language="ILASM" Value=".property string ContentEncoding { public hidebysig specialname instance string get_ContentEncoding() }" />
 227       <MemberSignature Language="C#" Value="public string ContentEncoding { get; }" />
 228       <MemberSignature Language="ILAsm" Value=".property instance string ContentEncoding" />
 229       <MemberType>Property</MemberType>
 230       <AssemblyInfo>
 231         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 232         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 233         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 234       </AssemblyInfo>
 235       <ReturnValue>
 236         <ReturnType>System.String</ReturnType>
 237       </ReturnValue>
 238       <Parameters />
 239       <Docs>
 240         <summary>
 241           <para>Gets the
 242       method used to encode the body of the response.</para>
 243         </summary>
 244         <value>
 245           <para>A <see cref="T:System.String" /> that describes the method used to encode the body of the response.</para>
 246         </value>
 247         <remarks>
 248           <para> This property is read-only.</para>
 249           <para>The <see cref="P:System.Net.HttpWebResponse.ContentEncoding" /> property contains the value of the
 250 <see langword="Content-Encoding" />
 251 header returned with the response.</para>
 252           <para>
 253             <block subset="none" type="note">For detailed information about content encoding,
 254    see Section 3.5 of RFC 2616.</block>
 255           </para>
 256         </remarks>
 257         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 258       </Docs>
 259       <Excluded>0</Excluded>
 260     </Member>
 261     <Member MemberName="ContentLength">
 262       <MemberSignature Language="ILASM" Value=".property int64 ContentLength { public hidebysig virtual specialname int64 get_ContentLength() }" />
 263       <MemberSignature Language="C#" Value="public override long ContentLength { get; }" />
 264       <MemberSignature Language="ILAsm" Value=".property instance int64 ContentLength" />
 265       <MemberType>Property</MemberType>
 266       <AssemblyInfo>
 267         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 268         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 269         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 270       </AssemblyInfo>
 271       <ReturnValue>
 272         <ReturnType>System.Int64</ReturnType>
 273       </ReturnValue>
 274       <Parameters />
 275       <Docs>
 276         <summary>
 277           <para> Gets the content length of the response data being received.</para>
 278         </summary>
 279         <value>
 280           <para>A <see cref="T:System.Int64" />
 281 containing the number of bytes returned from the Internet resource. This
 282 value does not include header information.</para>
 283         </value>
 284         <remarks>
 285           <para>This property is read-only.</para>
 286           <para>The <see cref="P:System.Net.HttpWebResponse.ContentLength" /> property contains the value of the
 287 <see langword="Content-length" /> header returned with the response. If the
 288 <see langword="Content-length" />
 289 header
 290 is not set in the response, <see cref="P:System.Net.HttpWebResponse.ContentLength" />
 291 is set to the value -1.</para>
 292           <para>
 293             <block subset="none" type="note">This property
 294    overrides <see cref="P:System.Net.WebResponse.ContentLength" />
 295    .</block>
 296           </para>
 297         </remarks>
 298         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 299       </Docs>
 300       <Excluded>0</Excluded>
 301     </Member>
 302     <Member MemberName="ContentType">
 303       <MemberSignature Language="ILASM" Value=".property string ContentType { public hidebysig virtual specialname string get_ContentType() }" />
 304       <MemberSignature Language="C#" Value="public override string ContentType { get; }" />
 305       <MemberSignature Language="ILAsm" Value=".property instance string ContentType" />
 306       <MemberType>Property</MemberType>
 307       <AssemblyInfo>
 308         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 309         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 310         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 311       </AssemblyInfo>
 312       <ReturnValue>
 313         <ReturnType>System.String</ReturnType>
 314       </ReturnValue>
 315       <Parameters />
 316       <Docs>
 317         <summary>
 318           <para> Gets the content type of the
 319       response.
 320       </para>
 321         </summary>
 322         <value>
 323           <para>A <see cref="T:System.String" /> that
 324    represents the content type of the response data.</para>
 325         </value>
 326         <remarks>
 327           <para>This property is read-only.</para>
 328           <para> The <see cref="P:System.Net.HttpWebResponse.ContentType" /> property contains the value of the
 329 <see langword="Content-Type" />
 330 header returned with the response.</para>
 331           <para>
 332             <block subset="none" type="note">This property
 333    overrides <see cref="P:System.Net.WebResponse.ContentType" />
 334    .</block>
 335           </para>
 336         </remarks>
 337         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 338       </Docs>
 339       <Excluded>0</Excluded>
 340     </Member>
 341     <Member MemberName="Cookies">
 342       <MemberSignature Language="C#" Value="public virtual System.Net.CookieCollection Cookies { get; set; }" />
 343       <MemberSignature Language="ILAsm" Value=".property instance class System.Net.CookieCollection Cookies" />
 344       <MemberType>Property</MemberType>
 345       <AssemblyInfo>
 346         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 347         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 348         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 349       </AssemblyInfo>
 350       <ReturnValue>
 351         <ReturnType>System.Net.CookieCollection</ReturnType>
 352       </ReturnValue>
 353       <Docs>
 354         <summary>To be added.</summary>
 355         <value>To be added.</value>
 356         <remarks>To be added.</remarks>
 357       </Docs>
 358     </Member>
 359     <Member MemberName="Dispose">
 360       <MemberSignature Language="ILASM" Value=".method family hidebysig virtual void Dispose(bool disposing)" />
 361       <MemberSignature Language="C#" Value="protected override void Dispose (bool disposing);" />
 362       <MemberSignature Language="ILAsm" Value=".method familyhidebysig virtual instance void Dispose(bool disposing) cil managed" />
 363       <MemberType>Method</MemberType>
 364       <AssemblyInfo>
 365         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 366         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 367       </AssemblyInfo>
 368       <ReturnValue>
 369         <ReturnType>System.Void</ReturnType>
 370       </ReturnValue>
 371       <Parameters>
 372         <Parameter Name="disposing" Type="System.Boolean" />
 373       </Parameters>
 374       <Docs>
 375         <param name="disposing">
 376           <see langword="true" /> to release both managed and unmanaged resources; <see langword="false" /> to release only unmanaged resources.</param>
 377         <summary>
 378           <para>Releases the unmanaged resources used by the current
 379       instance and optionally releases the managed resources.</para>
 380         </summary>
 381         <remarks>
 382           <para>
 383             <block subset="none" type="behaviors">When <paramref name="disposing" /> is <see langword="true" />,
 384    this method releases all resources held by any managed objects that the current
 385    instance references.</block>
 386           </para>
 387           <para>
 388             <block subset="none" type="overrides">When
 389    overriding <see cref="M:System.Net.HttpWebResponse.Dispose(System.Boolean)" />(<see cref="T:System.Boolean" />), be careful not to reference objects that have been
 390    previously disposed in an earlier call to <see cref="M:System.Net.HttpWebResponse.Dispose(System.Boolean)" /> as
 391 <see cref="M:System.Net.HttpWebResponse.Dispose(System.Boolean)" /> may be called multiple times by
 392    other objects. . </block>
 393           </para>
 394         </remarks>
 395       </Docs>
 396       <Excluded>0</Excluded>
 397     </Member>
 398     <Member MemberName="GetHashCode">
 399       <MemberSignature Language="ILASM" Value=".method public hidebysig virtual int32 GetHashCode()" />
 400       <MemberSignature Language="C#" Value="public override int GetHashCode ();" />
 401       <MemberType>Method</MemberType>
 402       <ReturnValue>
 403         <ReturnType>System.Int32</ReturnType>
 404       </ReturnValue>
 405       <Parameters />
 406       <Docs>
 407         <summary>
 408           <para>Generates a hash code for the current instance.</para>
 409         </summary>
 410         <returns>
 411           <para>A <see cref="T:System.Int32" />
 412 containing the hash code for the current instance.</para>
 413         </returns>
 414         <remarks>
 415           <para>The algorithm used to generate the hash code is
 416       unspecified.</para>
 417           <para>
 418             <block subset="none" type="note">This method overrides <see cref="M:System.Object.GetHashCode" qualify="true" />.</block>
 419           </para>
 420         </remarks>
 421         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 422       </Docs>
 423       <Excluded>0</Excluded>
 424       <AssemblyInfo>
 425         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 426       </AssemblyInfo>
 427     </Member>
 428     <Member MemberName="GetObjectData">
 429       <MemberSignature Language="C#" Value="protected override void GetObjectData (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);" />
 430       <MemberSignature Language="ILAsm" Value=".method familyhidebysig virtual instance void GetObjectData(class System.Runtime.Serialization.SerializationInfo serializationInfo, valuetype System.Runtime.Serialization.StreamingContext streamingContext) cil managed" />
 431       <MemberType>Method</MemberType>
 432       <AssemblyInfo>
 433         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 434         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 435       </AssemblyInfo>
 436       <ReturnValue>
 437         <ReturnType>System.Void</ReturnType>
 438       </ReturnValue>
 439       <Parameters>
 440         <Parameter Name="serializationInfo" Type="System.Runtime.Serialization.SerializationInfo" />
 441         <Parameter Name="streamingContext" Type="System.Runtime.Serialization.StreamingContext" />
 442       </Parameters>
 443       <Docs>
 444         <param name="serializationInfo">To be added.</param>
 445         <param name="streamingContext">To be added.</param>
 446         <summary>To be added.</summary>
 447         <remarks>To be added.</remarks>
 448       </Docs>
 449     </Member>
 450     <Member MemberName="GetResponseHeader">
 451       <MemberSignature Language="ILASM" Value=".method public hidebysig instance string GetResponseHeader(string headerName)" />
 452       <MemberSignature Language="C#" Value="public string GetResponseHeader (string headerName);" />
 453       <MemberSignature Language="ILAsm" Value=".method public hidebysig instance string GetResponseHeader(string headerName) cil managed" />
 454       <MemberType>Method</MemberType>
 455       <AssemblyInfo>
 456         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 457         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 458         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 459       </AssemblyInfo>
 460       <ReturnValue>
 461         <ReturnType>System.String</ReturnType>
 462       </ReturnValue>
 463       <Parameters>
 464         <Parameter Name="headerName" Type="System.String" />
 465       </Parameters>
 466       <Docs>
 467         <param name="headerName">A <see cref="T:System.String" /> that specifies the header value to return. </param>
 468         <summary>
 469           <para> Returns a specified header from the current response.
 470       </para>
 471         </summary>
 472         <returns>
 473           <para> A <see cref="T:System.String" /> containing the value of the specified header.
 474    </para>
 475         </returns>
 476         <remarks>To be added.</remarks>
 477         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 478       </Docs>
 479       <Excluded>0</Excluded>
 480     </Member>
 481     <Member MemberName="GetResponseStream">
 482       <MemberSignature Language="ILASM" Value=".method public hidebysig virtual class System.IO.Stream GetResponseStream()" />
 483       <MemberSignature Language="C#" Value="public override System.IO.Stream GetResponseStream ();" />
 484       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.IO.Stream GetResponseStream() cil managed" />
 485       <MemberType>Method</MemberType>
 486       <AssemblyInfo>
 487         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 488         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 489         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 490       </AssemblyInfo>
 491       <ReturnValue>
 492         <ReturnType>System.IO.Stream</ReturnType>
 493       </ReturnValue>
 494       <Parameters />
 495       <Docs>
 496         <summary>
 497           <para>Returns a <see cref="T:System.IO.Stream" /> for reading the body of the response from the
 498    server.</para>
 499         </summary>
 500         <returns>
 501           <para>A <see cref="T:System.IO.Stream" /> containing the body of the response.</para>
 502         </returns>
 503         <remarks>
 504           <para>The <see cref="M:System.Net.HttpWebResponse.GetResponseStream" />
 505 method returns the data stream from the requested Internet
 506 resource.</para>
 507           <block subset="none" type="note">
 508             <para>
 509       Call either the <see cref="M:System.IO.Stream.Close" qualify="true" /> or <see cref="M:System.Net.HttpWebResponse.Close" qualify="true" /> method to close the stream and release the
 510       connection for reuse. It is not necessary to call both <see cref="M:System.IO.Stream.Close" qualify="true" /> and <see cref="M:System.Net.HttpWebResponse.Close" qualify="true" /> , but doing so does
 511       not cause an error. Failure to close the stream might cause an application
 512       to run out of connections.
 513       </para>
 514             <para>This method overrides <see cref="M:System.Net.WebResponse.GetResponseStream" /> .</para>
 515           </block>
 516         </remarks>
 517         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 518       </Docs>
 519       <Excluded>0</Excluded>
 520     </Member>
 521     <Member MemberName="Headers">
 522       <MemberSignature Language="ILASM" Value=".property class System.Net.WebHeaderCollection Headers { public hidebysig virtual specialname class System.Net.WebHeaderCollection get_Headers() }" />
 523       <MemberSignature Language="C#" Value="public override System.Net.WebHeaderCollection Headers { get; }" />
 524       <MemberSignature Language="ILAsm" Value=".property instance class System.Net.WebHeaderCollection Headers" />
 525       <MemberType>Property</MemberType>
 526       <AssemblyInfo>
 527         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 528         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 529         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 530       </AssemblyInfo>
 531       <ReturnValue>
 532         <ReturnType>System.Net.WebHeaderCollection</ReturnType>
 533       </ReturnValue>
 534       <Parameters />
 535       <Docs>
 536         <summary>
 537           <para>Gets the
 538       headers associated with the current response from the server.</para>
 539         </summary>
 540         <value>
 541           <para>A <see cref="T:System.Net.WebHeaderCollection" /> containing the header information returned with the
 542    response.</para>
 543         </value>
 544         <remarks>
 545           <para>This property is read-only.</para>
 546           <block subset="none" type="note">
 547             <para>The <see cref="P:System.Net.HttpWebResponse.Headers" /> property is a collection
 548       of name/value pairs containing the HTTP header values returned
 549       with the response. The following table lists common headers and
 550       the properties that store their values.</para>
 551             <list type="table">
 552               <listheader>
 553                 <term>Header</term>
 554                 <description>Property</description>
 555               </listheader>
 556               <item>
 557                 <term> Content-Encoding</term>
 558                 <description>
 559                   <see cref="P:System.Net.HttpWebResponse.ContentEncoding" />
 560                 </description>
 561               </item>
 562               <item>
 563                 <term> Content-Length</term>
 564                 <description>
 565                   <see cref="P:System.Net.HttpWebResponse.ContentLength" />
 566                 </description>
 567               </item>
 568               <item>
 569                 <term> Content-Type</term>
 570                 <description>
 571                   <see cref="P:System.Net.HttpWebResponse.ContentType" />
 572                 </description>
 573               </item>
 574               <item>
 575                 <term> Last-Modified</term>
 576                 <description>
 577                   <see cref="P:System.Net.HttpWebResponse.LastModified" />
 578                 </description>
 579               </item>
 580               <item>
 581                 <term> Server</term>
 582                 <description>
 583                   <see cref="P:System.Net.HttpWebResponse.Server" />
 584                 </description>
 585               </item>
 586             </list>
 587             <para>This property overrides <see cref="P:System.Net.WebResponse.Headers" />.</para>
 588           </block>
 589         </remarks>
 590         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 591       </Docs>
 592       <Excluded>0</Excluded>
 593     </Member>
 594     <Member MemberName="IsMutuallyAuthenticated">
 595       <MemberSignature Language="C#" Value="public override bool IsMutuallyAuthenticated { get; }" />
 596       <MemberSignature Language="ILAsm" Value=".property instance bool IsMutuallyAuthenticated" />
 597       <MemberType>Property</MemberType>
 598       <AssemblyInfo>
 599         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 600         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 601       </AssemblyInfo>
 602       <Attributes>
 603         <Attribute>
 604           <AttributeName>System.MonoTODO</AttributeName>
 605         </Attribute>
 606       </Attributes>
 607       <ReturnValue>
 608         <ReturnType>System.Boolean</ReturnType>
 609       </ReturnValue>
 610       <Docs>
 611         <summary>To be added.</summary>
 612         <value>To be added.</value>
 613         <remarks>To be added.</remarks>
 614       </Docs>
 615     </Member>
 616     <Member MemberName="LastModified">
 617       <MemberSignature Language="ILASM" Value=".property valuetype System.DateTime LastModified { public hidebysig specialname instance valuetype System.DateTime get_LastModified() }" />
 618       <MemberSignature Language="C#" Value="public DateTime LastModified { get; }" />
 619       <MemberSignature Language="ILAsm" Value=".property instance valuetype System.DateTime LastModified" />
 620       <MemberType>Property</MemberType>
 621       <AssemblyInfo>
 622         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 623         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 624         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 625       </AssemblyInfo>
 626       <ReturnValue>
 627         <ReturnType>System.DateTime</ReturnType>
 628       </ReturnValue>
 629       <Parameters />
 630       <Docs>
 631         <summary>
 632           <para>Gets the last
 633       date and time that the contents of the response were modified.</para>
 634         </summary>
 635         <value>
 636           <para>A <see cref="T:System.DateTime" />
 637 value containing the date and time the contents of the response were
 638 modified.</para>
 639         </value>
 640         <remarks>
 641           <para> This property is read-only.</para>
 642           <para>The <see cref="P:System.Net.HttpWebResponse.LastModified" /> property contains the value of the
 643 <see langword="Last-Modified" /> header
 644    received with the response.</para>
 645         </remarks>
 646         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 647       </Docs>
 648       <Excluded>0</Excluded>
 649     </Member>
 650     <Member MemberName="Method">
 651       <MemberSignature Language="ILASM" Value=".property string Method { public hidebysig specialname instance string get_Method() }" />
 652       <MemberSignature Language="C#" Value="public virtual string Method { get; }" />
 653       <MemberSignature Language="ILAsm" Value=".property instance string Method" />
 654       <MemberType>Property</MemberType>
 655       <AssemblyInfo>
 656         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 657         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 658         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 659       </AssemblyInfo>
 660       <ReturnValue>
 661         <ReturnType>System.String</ReturnType>
 662       </ReturnValue>
 663       <Parameters />
 664       <Docs>
 665         <summary>
 666           <para> Gets the method used to return the response.
 667       </para>
 668         </summary>
 669         <value>
 670           <para>A <see cref="T:System.String" /> that represents the HTTP method used to return the response.</para>
 671         </value>
 672         <remarks>
 673           <para>This property is read-only.</para>
 674           <block subset="none" type="note">
 675             <para>The <see cref="P:System.Net.HttpWebRequest.Method" /> property can be set to any of the
 676       HTTP 1.1 protocol methods: GET, HEAD, POST, PUT, DELETE, TRACE, or OPTIONS. The
 677       following table describes these methods.</para>
 678             <list type="table">
 679               <listheader>
 680                 <term>Item</term>
 681                 <description>Description</description>
 682               </listheader>
 683               <item>
 684                 <term> GET</term>
 685                 <description>Retrieves in entity-body form the
 686             information identified by the <see cref="P:System.Net.HttpWebRequest.RequestUri" /> property of the request
 687             associated with the current instance.</description>
 688               </item>
 689               <item>
 690                 <term> HEAD</term>
 691                 <description>Identical to GET except that the
 692             message-body is not returned in the response.</description>
 693               </item>
 694               <item>
 695                 <term> POST</term>
 696                 <description>Requests that the origin server accept the
 697             entity enclosed in the request as a new subordinate of the resource
 698             identified the Request-URI in the Request-Line.</description>
 699               </item>
 700               <item>
 701                 <term> PUT</term>
 702                 <description>Requests that the enclosed entity be stored
 703             under the supplied Request-URI.</description>
 704               </item>
 705               <item>
 706                 <term> DELETE</term>
 707                 <description>Requests that the origin server delete the
 708             resource identified by the Request-URI.</description>
 709               </item>
 710               <item>
 711                 <term> TRACE</term>
 712                 <description>Invokes a remote, application-layer loopback
 713             of the request message.</description>
 714               </item>
 715               <item>
 716                 <term> OPTIONS</term>
 717                 <description>Requests information about the communication
 718             options available on the request/response chain identified by the
 719             Request-URI. <block subset="none" type="note">This allows the client
 720             to determine the options and/or requirements associated with a resource,
 721             or the capabilities of a server, without implying a resource action or
 722             initiating a resource
 723             retrieval.</block></description>
 724               </item>
 725             </list>
 726             <para>For detailed information regarding these methods, see sections 9.2 to 9.8 of
 727       RFC 2616.</para>
 728           </block>
 729         </remarks>
 730         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 731       </Docs>
 732       <Excluded>0</Excluded>
 733     </Member>
 734     <Member MemberName="ProtocolVersion">
 735       <MemberSignature Language="ILASM" Value=".property class System.Version ProtocolVersion { public hidebysig specialname instance class System.Version get_ProtocolVersion() }" />
 736       <MemberSignature Language="C#" Value="public Version ProtocolVersion { get; }" />
 737       <MemberSignature Language="ILAsm" Value=".property instance class System.Version ProtocolVersion" />
 738       <MemberType>Property</MemberType>
 739       <AssemblyInfo>
 740         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 741         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 742         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 743       </AssemblyInfo>
 744       <ReturnValue>
 745         <ReturnType>System.Version</ReturnType>
 746       </ReturnValue>
 747       <Parameters />
 748       <Docs>
 749         <summary>
 750           <para> Gets
 751       the version of the HTTP protocol used in the response.
 752       </para>
 753         </summary>
 754         <value>
 755           <para>A <see cref="T:System.Version" />
 756 that contains the HTTP protocol version of the response.</para>
 757         </value>
 758         <remarks>
 759           <para>This property is read-only.</para>
 760           <para>The <see cref="P:System.Net.HttpWebResponse.ProtocolVersion" /> property contains the <see cref="T:System.Net.HttpVersion" /> number
 761    of the response sent by the Internet resource.</para>
 762         </remarks>
 763         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 764       </Docs>
 765       <Excluded>0</Excluded>
 766     </Member>
 767     <Member MemberName="ResponseUri">
 768       <MemberSignature Language="ILASM" Value=".property class System.Uri ResponseUri { public hidebysig virtual specialname class System.Uri get_ResponseUri() }" />
 769       <MemberSignature Language="C#" Value="public override Uri ResponseUri { get; }" />
 770       <MemberSignature Language="ILAsm" Value=".property instance class System.Uri ResponseUri" />
 771       <MemberType>Property</MemberType>
 772       <AssemblyInfo>
 773         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 774         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 775         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 776       </AssemblyInfo>
 777       <ReturnValue>
 778         <ReturnType>System.Uri</ReturnType>
 779       </ReturnValue>
 780       <Parameters />
 781       <Docs>
 782         <summary>
 783           <para>Gets the <see cref="T:System.Uri" />
 784 of the Internet resource that actually responded to the request.</para>
 785         </summary>
 786         <value>
 787           <para>A <see cref="T:System.Uri" />
 788 representing the resource that actually responded to the request.</para>
 789         </value>
 790         <remarks>
 791           <para>This property is read-only.</para>
 792           <block subset="none" type="note">
 793             <para>The <see cref="P:System.Net.HttpWebResponse.ResponseUri" /> property contains the URI of the Internet resource that
 794       actually responded to the request. This URI might not be the same as the
 795       originally requested URI if the request was redirected by the original
 796       server.</para>
 797             <para>This method overrides <see cref="P:System.Net.WebResponse.ResponseUri" qualify="true" />
 798 .</para>
 799           </block>
 800         </remarks>
 801         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 802       </Docs>
 803       <Excluded>0</Excluded>
 804     </Member>
 805     <Member MemberName="Server">
 806       <MemberSignature Language="ILASM" Value=".property string Server { public hidebysig specialname instance string get_Server() }" />
 807       <MemberSignature Language="C#" Value="public string Server { get; }" />
 808       <MemberSignature Language="ILAsm" Value=".property instance string Server" />
 809       <MemberType>Property</MemberType>
 810       <AssemblyInfo>
 811         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 812         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 813         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 814       </AssemblyInfo>
 815       <ReturnValue>
 816         <ReturnType>System.String</ReturnType>
 817       </ReturnValue>
 818       <Parameters />
 819       <Docs>
 820         <summary>
 821           <para> Gets the name of the server that sent the response.
 822       </para>
 823         </summary>
 824         <value>
 825           <para>A <see cref="T:System.String" /> containing the name of the server that sent the response.</para>
 826         </value>
 827         <remarks>
 828           <para> This property is read-only.</para>
 829           <para> The <see cref="P:System.Net.HttpWebResponse.Server" />
 830 property contains the value of the <see langword="Server" /> header
 831 returned with the response.</para>
 832         </remarks>
 833         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 834       </Docs>
 835       <Excluded>0</Excluded>
 836     </Member>
 837     <Member MemberName="StatusCode">
 838       <MemberSignature Language="ILASM" Value=".property valuetype System.Net.HttpStatusCode StatusCode { public hidebysig specialname instance valuetype System.Net.HttpStatusCode get_StatusCode() }" />
 839       <MemberSignature Language="C#" Value="public virtual System.Net.HttpStatusCode StatusCode { get; }" />
 840       <MemberSignature Language="ILAsm" Value=".property instance valuetype System.Net.HttpStatusCode StatusCode" />
 841       <MemberType>Property</MemberType>
 842       <AssemblyInfo>
 843         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 844         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 845         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 846       </AssemblyInfo>
 847       <ReturnValue>
 848         <ReturnType>System.Net.HttpStatusCode</ReturnType>
 849       </ReturnValue>
 850       <Parameters />
 851       <Docs>
 852         <summary>
 853           <para> Gets the status of the response.</para>
 854         </summary>
 855         <value>
 856           <para> A <see cref="T:System.Net.HttpStatusCode" /> value.</para>
 857         </value>
 858         <remarks>
 859           <para>This property is read-only.</para>
 860           <para>The <see cref="P:System.Net.HttpWebResponse.StatusCode" /> value
 861    indicates the status of the HTTP response. The expected values are defined in the <see cref="T:System.Net.HttpStatusCode" /> enumeration.</para>
 862         </remarks>
 863         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 864       </Docs>
 865       <Excluded>0</Excluded>
 866     </Member>
 867     <Member MemberName="StatusDescription">
 868       <MemberSignature Language="ILASM" Value=".property string StatusDescription { public hidebysig specialname instance string get_StatusDescription() }" />
 869       <MemberSignature Language="C#" Value="public virtual string StatusDescription { get; }" />
 870       <MemberSignature Language="ILAsm" Value=".property instance string StatusDescription" />
 871       <MemberType>Property</MemberType>
 872       <AssemblyInfo>
 873         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 874         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 875         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 876       </AssemblyInfo>
 877       <ReturnValue>
 878         <ReturnType>System.String</ReturnType>
 879       </ReturnValue>
 880       <Parameters />
 881       <Docs>
 882         <summary>
 883           <para> Gets the status description returned with the response.
 884       </para>
 885         </summary>
 886         <value>
 887           <para>A <see cref="T:System.String" /> that describes the status of the response.</para>
 888         </value>
 889         <remarks>
 890           <para>This property is read-only.</para>
 891         </remarks>
 892         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
 893       </Docs>
 894       <Excluded>0</Excluded>
 895     </Member>
 896     <Member MemberName="System.IDisposable.Dispose">
 897       <MemberSignature Language="C#" Value="void IDisposable.Dispose ();" />
 898       <MemberSignature Language="ILAsm" Value=".method hidebysig newslot virtual instance void System.IDisposable.Dispose() cil managed" />
 899       <MemberType>Method</MemberType>
 900       <AssemblyInfo>
 901         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 902         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 903         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 904       </AssemblyInfo>
 905       <ReturnValue>
 906         <ReturnType>System.Void</ReturnType>
 907       </ReturnValue>
 908       <Parameters />
 909       <Docs>
 910         <summary>To be added.</summary>
 911         <remarks>To be added.</remarks>
 912       </Docs>
 913     </Member>
 914     <Member MemberName="System.Runtime.Serialization.ISerializable.GetObjectData">
 915       <MemberSignature Language="C#" Value="void ISerializable.GetObjectData (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);" />
 916       <MemberSignature Language="ILAsm" Value=".method hidebysig newslot virtual instance void System.Runtime.Serialization.ISerializable.GetObjectData(class System.Runtime.Serialization.SerializationInfo serializationInfo, valuetype System.Runtime.Serialization.StreamingContext streamingContext) cil managed" />
 917       <MemberType>Method</MemberType>
 918       <AssemblyInfo>
 919         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 920         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 921         <AssemblyVersion>4.0.0.0</AssemblyVersion>
 922       </AssemblyInfo>
 923       <ReturnValue>
 924         <ReturnType>System.Void</ReturnType>
 925       </ReturnValue>
 926       <Parameters>
 927         <Parameter Name="serializationInfo" Type="System.Runtime.Serialization.SerializationInfo" />
 928         <Parameter Name="streamingContext" Type="System.Runtime.Serialization.StreamingContext" />
 929       </Parameters>
 930       <Docs>
 931         <param name="serializationInfo">To be added.</param>
 932         <param name="streamingContext">To be added.</param>
 933         <summary>To be added.</summary>
 934         <remarks>To be added.</remarks>
 935       </Docs>
 936     </Member>
 937   </Members>
 938   <TypeExcluded>0</TypeExcluded>
 939 </Type>