WebResponse Classe

Definição

Fornece uma resposta de um URI (Uniform Resource Identifier).Provides a response from a Uniform Resource Identifier (URI). Esta é uma classe abstract.This is an abstract class.

public ref class WebResponse abstract : MarshalByRefObject, IDisposable, System::Runtime::Serialization::ISerializable
[System.Serializable]
public abstract class WebResponse : MarshalByRefObject, IDisposable, System.Runtime.Serialization.ISerializable
type WebResponse = class
    inherit MarshalByRefObject
    interface ISerializable
    interface IDisposable
Public MustInherit Class WebResponse
Inherits MarshalByRefObject
Implements IDisposable, ISerializable
Herança
Derivado
Atributos
Implementações

Exemplos

O exemplo a seguir cria uma instância de WebResponse de um WebRequest.The following example creates a WebResponse instance from a WebRequest.

// Initialize the WebRequest.
WebRequest^ myRequest = WebRequest::Create( "http://www.contoso.com" );

// Return the response. 
WebResponse^ myResponse = myRequest->GetResponse();

// Code to use the WebResponse goes here.

// Close the response to free resources.
myResponse->Close();
// Initialize the WebRequest.
WebRequest myRequest = WebRequest.Create("http://www.contoso.com");

// Return the response. 
WebResponse myResponse = myRequest.GetResponse();

// Code to use the WebResponse goes here.

// Close the response to free resources.
myResponse.Close();

' Initialize the WebRequest.
Dim myRequest As WebRequest = WebRequest.Create("http://www.contoso.com")

' Return the response. 
Dim myResponse As WebResponse = myRequest.GetResponse()

' Code to use the WebResponse goes here.
' Close the response to free resources.
myResponse.Close()

Comentários

A classe WebResponse é a classe base abstract da qual as classes de resposta específicas de protocolo são derivadas.The WebResponse class is the abstract base class from which protocol-specific response classes are derived. Os aplicativos podem participar de transações de solicitação e resposta de maneira independente de protocolo usando instâncias da classe WebResponse, enquanto as classes específicas de protocolo derivadas de WebResponse executam os detalhes da solicitação.Applications can participate in request and response transactions in a protocol-agnostic manner using instances of the WebResponse class while protocol-specific classes derived from WebResponse carry out the details of the request.

Os aplicativos cliente não criam WebResponse objetos diretamente; Eles são criados chamando o método GetResponse em uma instância de WebRequest.Client applications do not create WebResponse objects directly; they are created by calling the GetResponse method on a WebRequest instance.

Notas aos Implementadores

Ao herdar de WebResponse, você deve substituir os seguintes membros: ContentLength, ContentType, GetResponseStream(), ResponseUrie Headers.When you inherit from WebResponse, you must override the following members: ContentLength, ContentType, GetResponseStream(), ResponseUri, and Headers.

Construtores

WebResponse()

Inicializa uma nova instância da classe WebResponse.Initializes a new instance of the WebResponse class.

WebResponse(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe WebResponse das instâncias especificadas das classes SerializationInfo e StreamingContext.Initializes a new instance of the WebResponse class from the specified instances of the SerializationInfo and StreamingContext classes.

Propriedades

ContentLength

Quando substituído em uma classe descendente, obtém ou define o tamanho do conteúdo dos dados que estão sendo recebidos.When overridden in a descendant class, gets or sets the content length of data being received.

ContentType

Quando substituído em uma classe derivada, obtém ou define o tipo de conteúdo dos dados que estão sendo recebidos.When overridden in a derived class, gets or sets the content type of the data being received.

Headers

Quando substituído em uma classe derivada, obtém uma coleção de pares nome-valor de cabeçalho associados a essa solicitação.When overridden in a derived class, gets a collection of header name-value pairs associated with this request.

IsFromCache

Obtém um valor Boolean que indica se essa resposta foi obtida do cache.Gets a Boolean value that indicates whether this response was obtained from the cache.

IsMutuallyAuthenticated

Obtém um valor Boolean que indica se ocorreu uma autenticação mútua.Gets a Boolean value that indicates whether mutual authentication occurred.

ResponseUri

Quando substituído em uma classe derivada, obtém o URI do recurso da Internet que realmente respondeu à solicitação.When overridden in a derived class, gets the URI of the Internet resource that actually responded to the request.

SupportsHeaders

Obtém um valor que indica se os cabeçalhos têm suporte.Gets a value that indicates if headers are supported.

Métodos

Close()

Quando substituído por uma classe descendente, fecha o fluxo de resposta.When overridden by a descendant class, closes the response stream.

CreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Herdado de MarshalByRefObject)
Dispose()

Libera os recursos não gerenciados usados pelo objeto WebResponse.Releases the unmanaged resources used by the WebResponse object.

Dispose(Boolean)

Libera os recursos não gerenciados usados pelo objeto WebResponse e, opcionalmente, libera os recursos gerenciados.Releases the unmanaged resources used by the WebResponse object, and optionally disposes of the managed resources.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)

Preenche um SerializationInfo com os dados necessários para serializar o objeto de destino.Populates a SerializationInfo with the data that is needed to serialize the target object.

GetResponseStream()

Quando substituído em uma classe descendente, retorna o fluxo de dados do recurso da Internet.When overridden in a descendant class, returns the data stream from the Internet resource.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Herdado de MarshalByRefObject)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Implantações explícitas de interface

IDisposable.Dispose()

Quando substituído em uma classe derivada, libera todos os recursos usados pela WebResponse.When overridden in a derived class, releases all resources used by the WebResponse.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Preenche uma instância SerializationInfo com os dados necessários para serializar WebResponse.Populates a SerializationInfo instance with the data that is needed to serialize WebResponse.

Aplica-se a