Jo Shields a575963da9 Imported Upstream version 3.6.0
Former-commit-id: da6be194a6b1221998fc28233f2503bd61dd9d14
2014-08-13 10:39:27 +01:00

865 lines
47 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<Type Name="HttpWebResponse" FullName="System.Net.HttpWebResponse" FullNameSP="System_Net_HttpWebResponse" Maintainer="ecma">
<TypeSignature Language="ILASM" Value=".class public serializable HttpWebResponse extends System.Net.WebResponse" />
<TypeSignature Language="C#" Value="public class HttpWebResponse : System.Net.WebResponse, IDisposable, System.Runtime.Serialization.ISerializable" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable beforefieldinit HttpWebResponse extends System.Net.WebResponse implements class System.IDisposable, class System.Runtime.Serialization.ISerializable" />
<MemberOfLibrary>Networking</MemberOfLibrary>
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ]</AssemblyPublicKey>
<AssemblyVersion>1.0.x.x</AssemblyVersion>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadingSafetyStatement>All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.</ThreadingSafetyStatement>
<Base>
<BaseTypeName>System.Net.WebResponse</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.IDisposable</InterfaceName>
</Interface>
<Interface>
<InterfaceName>System.Runtime.Serialization.ISerializable</InterfaceName>
</Interface>
</Interfaces>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This class contains support for HTTP-specific uses of the properties and methods of the <see cref="T:System.Net.WebResponse" /> class. The <see cref="T:System.Net.HttpWebResponse" /> class is used to build HTTP stand-alone client applications that send HTTP requests and receive HTTP responses.</para>
<block subset="none" type="note">
<para>Do not confuse <see cref="T:System.Net.HttpWebResponse" /> with the <see cref="T:System.Web.HttpResponse" /> class that is used in ASP.NET applications and whose methods and properties are exposed through ASP.NET's intrinsic Response object.</para>
</block>
<para>You should never directly create an instance of the <see cref="T:System.Net.HttpWebResponse" /> class. Instead, use the instance returned by a call to <see cref="M:System.Net.HttpWebRequest.GetResponse" />. You must call either the <see cref="M:System.IO.Stream.Close" /> or the <see cref="M:System.Net.HttpWebResponse.Close" /> method to close the response and release the connection for reuse. It is not necessary to call both <see cref="M:System.IO.Stream.Close" /> and <see cref="M:System.Net.HttpWebResponse.Close" />, but doing so does not cause an error.</para>
<para>Common header information returned from the Internet resource is exposed as properties of the class. See the following table for a complete list. Other headers can be read from the <see cref="P:System.Net.HttpWebResponse.Headers" /> property as name/value pairs.</para>
<para>The following table shows the common HTTP headers that are available through properties of the <see cref="T:System.Net.HttpWebResponse" /> class.</para>
<list type="table">
<listheader>
<item>
<term>
<para>Header </para>
</term>
<description>
<para>Property </para>
</description>
</item>
</listheader>
<item>
<term>
<para>Content-Encoding </para>
</term>
<description>
<para>
<see cref="P:System.Net.HttpWebResponse.ContentEncoding" /> </para>
</description>
</item>
<item>
<term>
<para>Content-Length </para>
</term>
<description>
<para>
<see cref="P:System.Net.HttpWebResponse.ContentLength" /> </para>
</description>
</item>
<item>
<term>
<para>Content-Type </para>
</term>
<description>
<para>
<see cref="P:System.Net.HttpWebResponse.ContentType" /> </para>
</description>
</item>
<item>
<term>
<para>Last-Modified </para>
</term>
<description>
<para>
<see cref="P:System.Net.HttpWebResponse.LastModified" /> </para>
</description>
</item>
<item>
<term>
<para>Server </para>
</term>
<description>
<para>
<see cref="P:System.Net.HttpWebResponse.Server" /> </para>
</description>
</item>
</list>
<para>The contents of the response from the Internet resource are returned as a <see cref="T:System.IO.Stream" /> by calling the <see cref="M:System.Net.HttpWebResponse.GetResponseStream" /> method.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides an HTTP-specific implementation of the <see cref="T:System.Net.WebResponse" /> class.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected HttpWebResponse (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);" />
<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" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete("Serialization is obsoleted for this type", false)</AttributeName>
</Attribute>
</Attributes>
<Parameters>
<Parameter Name="serializationInfo" Type="System.Runtime.Serialization.SerializationInfo" />
<Parameter Name="streamingContext" Type="System.Runtime.Serialization.StreamingContext" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor implements the <see cref="T:System.Runtime.Serialization.ISerializable" /> interface for the <see cref="T:System.Net.HttpWebRequest" /> class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Net.HttpWebResponse" /> class from the specified <see cref="T:System.Runtime.Serialization.SerializationInfo" /> and <see cref="T:System.Runtime.Serialization.StreamingContext" /> instances.</para>
</summary>
<param name="serializationInfo">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.Serialization.SerializationInfo" /> that contains the information required to serialize the new <see cref="T:System.Net.HttpWebRequest" />. </param>
<param name="streamingContext">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.Serialization.StreamingContext" /> that contains the source of the serialized stream that is associated with the new <see cref="T:System.Net.HttpWebRequest" />. </param>
</Docs>
</Member>
<Member MemberName="CharacterSet">
<MemberSignature Language="ILASM" Value=".property string CharacterSet { public hidebysig specialname instance string get_CharacterSet() }" />
<MemberSignature Language="C#" Value="public string CharacterSet { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string CharacterSet" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.String" /> that
represents the character set used for the current instance.</para>
</value>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.HttpWebResponse.CharacterSet" /> property contains a value that describes the character set of the response. This character set information is taken from the header returned with the response.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the character set of the response.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Close">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual void Close()" />
<MemberSignature Language="C#" Value="public override void Close ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void Close() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.HttpWebResponse.Close" /> method closes the response stream and releases the connection to the resource for reuse by other requests.</para>
<para>You must call either the <see cref="M:System.IO.Stream.Close" /> or the <see cref="M:System.Net.HttpWebResponse.Close" /> 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" /> and <see cref="M:System.Net.HttpWebResponse.Close" />, but doing so does not cause an error. Failure to close the stream can cause your application to run out of connections.</para>
<block subset="none" type="note">
<para>This member outputs trace information when you enable network tracing in your application. For more information, see <format type="text/html"><a href="E993B7C3-087F-45D8-9C02-9DDED936D804">[&lt;topic://conUsingNetworkTracing&gt;]</a></format>.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Closes the response stream.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="ContentEncoding">
<MemberSignature Language="ILASM" Value=".property string ContentEncoding { public hidebysig specialname instance string get_ContentEncoding() }" />
<MemberSignature Language="C#" Value="public string ContentEncoding { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string ContentEncoding" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.String" /> that describes the method used to encode the body of the response.</para>
</value>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.HttpWebResponse.ContentEncoding" /> property contains the value of the Content-Encoding header returned with the response.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the method that is used to encode the body of the response.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="ContentLength">
<MemberSignature Language="ILASM" Value=".property int64 ContentLength { public hidebysig virtual specialname int64 get_ContentLength() }" />
<MemberSignature Language="C#" Value="public override long ContentLength { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance int64 ContentLength" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int64</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.Int64" />
containing the number of bytes returned from the Internet resource. This
value does not include header information.</para>
</value>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.HttpWebResponse.ContentLength" /> property contains the value of the Content-Length header returned with the response. If the Content-Length header is not set in the response, <see cref="P:System.Net.HttpWebResponse.ContentLength" /> is set to the value -1.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the length of the content returned by the request.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="ContentType">
<MemberSignature Language="ILASM" Value=".property string ContentType { public hidebysig virtual specialname string get_ContentType() }" />
<MemberSignature Language="C#" Value="public override string ContentType { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string ContentType" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.String" /> that
represents the content type of the response data.</para>
</value>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.HttpWebResponse.ContentType" /> property contains the value of the Content-Type header returned with the response.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the content type of the response.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Cookies">
<MemberSignature Language="C#" Value="public virtual System.Net.CookieCollection Cookies { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Net.CookieCollection Cookies" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.CookieCollection</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.HttpWebResponse.Cookies" /> property provides an instance of the <see cref="T:System.Net.CookieCollection" /> class that holds the cookies associated with this response.</para>
<para>If the <see cref="P:System.Net.HttpWebRequest.CookieContainer" /> property of the associated <see cref="T:System.Net.HttpWebRequest" /> is null, the <see cref="P:System.Net.HttpWebResponse.Cookies" /> property will also be null. Any cookie information sent by the server will be available in the <see cref="P:System.Net.HttpWebResponse.Headers" /> property, however.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the cookies that are associated with this response.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Dispose">
<MemberSignature Language="ILASM" Value=".method family hidebysig virtual void Dispose(bool disposing)" />
<MemberSignature Language="C#" Value="protected override void Dispose (bool disposing);" />
<MemberSignature Language="ILAsm" Value=".method familyhidebysig virtual instance void Dispose(bool disposing) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="disposing" Type="System.Boolean" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is called by the public Dispose() method and the <see cref="M:System.Object.Finalize" /> method. Dispose() invokes the protected Dispose(Boolean) method with the <paramref name="disposing" /> parameter set to true. <see cref="M:System.Object.Finalize" /> invokes Dispose with <paramref name="disposing" /> set to false.</para>
<para>When the <paramref name="disposing" /> parameter is true, this method releases all resources held by any managed objects that this <see cref="T:System.Net.WebResponse" /> references. This method invokes the Dispose() method of each referenced object.</para>
<block subset="none" type="note">
<para>This member outputs trace information when you enable network tracing in your application. For more information, see <format type="text/html"><a href="E993B7C3-087F-45D8-9C02-9DDED936D804">[&lt;topic://conUsingNetworkTracing&gt;]</a></format>.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Releases the unmanaged resources used by the <see cref="T:System.Net.HttpWebResponse" />, and optionally disposes of the managed resources.</para>
</summary>
<param name="disposing">
<attribution license="cc4" from="Microsoft" modified="false" />true to release both managed and unmanaged resources; false to releases only unmanaged resources. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="GetHashCode">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual int32 GetHashCode()" />
<MemberSignature Language="C#" Value="public override int GetHashCode ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.HttpWebResponse.GetHashCode" /> method returns a hash code of the web response instance. This value can be used as a key in hash tables.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns a hash value for a <see cref="T:System.Net.HttpWebResponse" /> instance.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An integer hash value.</para>
</returns>
</Docs>
<Excluded>0</Excluded>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetObjectData">
<MemberSignature Language="C#" Value="protected override void GetObjectData (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);" />
<MemberSignature Language="ILAsm" Value=".method familyhidebysig virtual instance void GetObjectData(class System.Runtime.Serialization.SerializationInfo serializationInfo, valuetype System.Runtime.Serialization.StreamingContext streamingContext) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="serializationInfo" Type="System.Runtime.Serialization.SerializationInfo" />
<Parameter Name="streamingContext" Type="System.Runtime.Serialization.StreamingContext" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Any objects that are included in the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> are automatically tracked and serialized by the formatter.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo" /> with the data needed to serialize the target object.</para>
</summary>
<param name="serializationInfo">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Serialization.SerializationInfo" /> to populate with data. </param>
<param name="streamingContext">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.Serialization.StreamingContext" /> that specifies the destination for this serialization.</param>
</Docs>
</Member>
<Member MemberName="GetResponseHeader">
<MemberSignature Language="ILASM" Value=".method public hidebysig instance string GetResponseHeader(string headerName)" />
<MemberSignature Language="C#" Value="public string GetResponseHeader (string headerName);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance string GetResponseHeader(string headerName) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="headerName" Type="System.String" />
</Parameters>
<Docs>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use <see cref="M:System.Net.HttpWebResponse.GetResponseHeader(System.String)" /> to retrieve the contents of particular headers. You must specify which header you want to return.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the contents of a header that was returned with the response.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The contents of the specified header.</para>
</returns>
<param name="headerName">
<attribution license="cc4" from="Microsoft" modified="false" />The header value to return. </param>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="GetResponseStream">
<MemberSignature Language="ILASM" Value=".method public hidebysig virtual class System.IO.Stream GetResponseStream()" />
<MemberSignature Language="C#" Value="public override System.IO.Stream GetResponseStream ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class System.IO.Stream GetResponseStream() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.IO.Stream</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Net.HttpWebResponse.GetResponseStream" /> method returns the data stream from the requested Internet resource.</para>
<block subset="none" type="note">
<para>You must call either the <see cref="M:System.IO.Stream.Close" /> or the <see cref="M:System.Net.HttpWebResponse.Close" /> 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" /> and <see cref="M:System.Net.HttpWebResponse.Close" />, but doing so does not cause an error. Failure to close the stream will cause your application to run out of connections.</para>
</block>
<block subset="none" type="note">
<para>This member outputs trace information when you enable network tracing in your application. For more information, see <format type="text/html"><a href="E993B7C3-087F-45D8-9C02-9DDED936D804">[&lt;topic://conUsingNetworkTracing&gt;]</a></format>.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the stream that is used to read the body of the response from the server.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.IO.Stream" /> containing the body of the response.</para>
</returns>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Headers">
<MemberSignature Language="ILASM" Value=".property class System.Net.WebHeaderCollection Headers { public hidebysig virtual specialname class System.Net.WebHeaderCollection get_Headers() }" />
<MemberSignature Language="C#" Value="public override System.Net.WebHeaderCollection Headers { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Net.WebHeaderCollection Headers" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.WebHeaderCollection</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.Net.WebHeaderCollection" /> containing the header information returned with the
response.</para>
</value>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.HttpWebResponse.Headers" /> property is a collection of name/value pairs that contain the HTTP header values returned with the response. Common header information returned from the Internet resource is exposed as properties of the <see cref="T:System.Net.HttpWebResponse" /> class. The following table lists common headers that the API exposes as properties.</para>
<list type="table">
<listheader>
<item>
<term>
<para>Header </para>
</term>
<description>
<para>Property </para>
</description>
</item>
</listheader>
<item>
<term>
<para>Content-Encoding </para>
</term>
<description>
<para>
<see cref="P:System.Net.HttpWebResponse.ContentEncoding" /> </para>
</description>
</item>
<item>
<term>
<para>Content-Length </para>
</term>
<description>
<para>
<see cref="P:System.Net.HttpWebResponse.ContentLength" /> </para>
</description>
</item>
<item>
<term>
<para>Content-Type </para>
</term>
<description>
<para>
<see cref="P:System.Net.HttpWebResponse.ContentType" /> </para>
</description>
</item>
<item>
<term>
<para>Last-Modified </para>
</term>
<description>
<para>
<see cref="P:System.Net.HttpWebResponse.LastModified" /> </para>
</description>
</item>
<item>
<term>
<para>Server </para>
</term>
<description>
<para>
<see cref="P:System.Net.HttpWebResponse.Server" /> </para>
</description>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the headers that are associated with this response from the server.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="IsMutuallyAuthenticated">
<MemberSignature Language="C#" Value="public override bool IsMutuallyAuthenticated { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool IsMutuallyAuthenticated" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.MonoTODO</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You can specify mutual authentication using the <see cref="P:System.Net.WebRequest.AuthenticationLevel" /> property.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a <see cref="T:System.Boolean" /> value that indicates whether both client and server were authenticated.</para>
</summary>
</Docs>
</Member>
<Member MemberName="LastModified">
<MemberSignature Language="ILASM" Value=".property valuetype System.DateTime LastModified { public hidebysig specialname instance valuetype System.DateTime get_LastModified() }" />
<MemberSignature Language="C#" Value="public DateTime LastModified { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.DateTime LastModified" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.DateTime</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.DateTime" />
value containing the date and time the contents of the response were
modified.</para>
</value>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.HttpWebResponse.LastModified" /> property contains the value of the Last-Modified header received with the response. The date and time are assumed to be local time.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the last date and time that the contents of the response were modified.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Method">
<MemberSignature Language="ILASM" Value=".property string Method { public hidebysig specialname instance string get_Method() }" />
<MemberSignature Language="C#" Value="public virtual string Method { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Method" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.String" /> that represents the HTTP method used to return the response.</para>
</value>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>
<see cref="P:System.Net.HttpWebResponse.Method" /> returns the method that is used to return the response. Common HTTP methods are GET, HEAD, POST, PUT, and DELETE.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the method that is used to return the response.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="ProtocolVersion">
<MemberSignature Language="ILASM" Value=".property class System.Version ProtocolVersion { public hidebysig specialname instance class System.Version get_ProtocolVersion() }" />
<MemberSignature Language="C#" Value="public Version ProtocolVersion { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Version ProtocolVersion" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Version</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.Version" />
that contains the HTTP protocol version of the response.</para>
</value>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.HttpWebResponse.ProtocolVersion" /> property contains the HTTP protocol version number of the response sent by the Internet resource.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the version of the HTTP protocol that is used in the response.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="ResponseUri">
<MemberSignature Language="ILASM" Value=".property class System.Uri ResponseUri { public hidebysig virtual specialname class System.Uri get_ResponseUri() }" />
<MemberSignature Language="C#" Value="public override Uri ResponseUri { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Uri ResponseUri" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Uri</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.Uri" />
representing the resource that actually responded to the request.</para>
</value>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.HttpWebResponse.ResponseUri" /> property contains the URI of the Internet resource that actually responded to the request. This URI might not be the same as the originally requested URI, if the original server redirected the request.</para>
<para>The <see cref="P:System.Net.HttpWebResponse.ResponseUri" /> property will use the Content-Location header if present.</para>
<para>Applications that need to access the last redirected <see cref="P:System.Net.HttpWebResponse.ResponseUri" /> should use the <see cref="P:System.Net.HttpWebRequest.Address" /> property rather than <see cref="P:System.Net.HttpWebResponse.ResponseUri" />, since the use of <see cref="P:System.Net.HttpWebResponse.ResponseUri" /> property may open security vulnerabilities.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the URI of the Internet resource that responded to the request.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="Server">
<MemberSignature Language="ILASM" Value=".property string Server { public hidebysig specialname instance string get_Server() }" />
<MemberSignature Language="C#" Value="public string Server { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Server" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.String" /> containing the name of the server that sent the response.</para>
</value>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.HttpWebResponse.Server" /> property contains the value of the Server header returned with the response.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the name of the server that sent the response.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="StatusCode">
<MemberSignature Language="ILASM" Value=".property valuetype System.Net.HttpStatusCode StatusCode { public hidebysig specialname instance valuetype System.Net.HttpStatusCode get_StatusCode() }" />
<MemberSignature Language="C#" Value="public virtual System.Net.HttpStatusCode StatusCode { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Net.HttpStatusCode StatusCode" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Net.HttpStatusCode</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para> A <see cref="T:System.Net.HttpStatusCode" /> value.</para>
</value>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Net.HttpWebResponse.StatusCode" /> parameter is a number that indicates the status of the HTTP response. The expected values for status are defined in the <see cref="T:System.Net.HttpStatusCode" /> class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the status of the response.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="StatusDescription">
<MemberSignature Language="ILASM" Value=".property string StatusDescription { public hidebysig specialname instance string get_StatusDescription() }" />
<MemberSignature Language="C#" Value="public virtual string StatusDescription { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string StatusDescription" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<value>
<para>A <see cref="T:System.String" /> that describes the status of the response.</para>
</value>
<exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A common status message is OK.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the status description returned with the response.</para>
</summary>
</Docs>
<Excluded>0</Excluded>
</Member>
<Member MemberName="System.IDisposable.Dispose">
<MemberSignature Language="C#" Value="void IDisposable.Dispose ();" />
<MemberSignature Language="ILAsm" Value=".method hidebysig newslot virtual instance void System.IDisposable.Dispose() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Call <see cref="M:System.Net.HttpWebResponse.System#IDisposable#Dispose" /> when you are finished using the <see cref="T:System.Net.HttpWebResponse" />. The <see cref="M:System.Net.HttpWebResponse.System#IDisposable#Dispose" /> method leaves the <see cref="T:System.Net.HttpWebResponse" /> in an unusable state. After calling <see cref="M:System.Net.HttpWebResponse.System#IDisposable#Dispose" />, you must release all references to the <see cref="T:System.Net.HttpWebResponse" /> so the garbage collector can reclaim the memory that the <see cref="T:System.Net.HttpWebResponse" /> was occupying. For more information, see <format type="text/html"><a href="A17B0066-71C2-4BA4-9822-8E19332FC213">[&lt;topic://cpconCleaningUpUnmanagedResources&gt;]</a></format> and <format type="text/html"><a href="EB4E1AF0-3B48-4FBC-AD4E-FC2F64138BF9">[&lt;topic://cpconImplementingDisposeMethod&gt;]</a></format>. </para>
<para>Note: Always call <see cref="M:System.Net.HttpWebResponse.System#IDisposable#Dispose" /> before you release your last reference to the <see cref="T:System.Net.HttpWebResponse" />. Otherwise, the resources it is using will not be freed until the garbage collector calls the <see cref="T:System.Net.HttpWebResponse" /> object's Finalize method.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Releases all resources used by the <see cref="T:System.Net.HttpWebResponse" />.</para>
</summary>
</Docs>
</Member>
<Member MemberName="System.Runtime.Serialization.ISerializable.GetObjectData">
<MemberSignature Language="C#" Value="void ISerializable.GetObjectData (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);" />
<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" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="serializationInfo" Type="System.Runtime.Serialization.SerializationInfo" />
<Parameter Name="streamingContext" Type="System.Runtime.Serialization.StreamingContext" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Serializes this instance into the specified <see cref="T:System.Runtime.Serialization.SerializationInfo" /> object.</para>
</summary>
<param name="serializationInfo">
<attribution license="cc4" from="Microsoft" modified="false" />The object into which this <see cref="T:System.Net.HttpWebResponse" /> will be serialized. </param>
<param name="streamingContext">
<attribution license="cc4" from="Microsoft" modified="false" />The destination of the serialization. </param>
</Docs>
</Member>
</Members>
<TypeExcluded>0</TypeExcluded>
</Type>