IHttpFilter.SendRequestAsync(HttpRequestMessage) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Envíe una solicitud HTTP en la instancia de IHttpFilter como una operación asincrónica.
public:
IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ SendRequestAsync(HttpRequestMessage ^ request);/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> SendRequestAsync(HttpRequestMessage const& request);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> SendRequestAsync(HttpRequestMessage request);function sendRequestAsync(request)Public Function SendRequestAsync (request As HttpRequestMessage) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)Parámetros
- request
- HttpRequestMessage
Mensaje de la solicitud HTTP que se va a enviar.
Devoluciones
Objeto que representa la operación asincrónica.
- Atributos
Comentarios
Los filtros personalizados se implementan en el método SendRequestAsync en su interfaz IHttpFilter .
Las clases del espacio de nombres Windows.Web.Http admiten el uso de filtros basados en las clases del espacio de nombres Windows.Web.Http.Filters . La clase HttpClient del espacio de nombres Windows.Web.Http proporciona una clase base para enviar solicitudes HTTP y recibir respuestas HTTP. Los filtros proporcionan un mecanismo de controlador para ayudar con problemas comunes del servicio HTTP. Los filtros simples se pueden encadenar en una secuencia para controlar problemas de servicio HTTP más complejos.
Un filtro HTTP es un cuadro negro que toma un mensaje de solicitud HTTP y genera un mensaje de respuesta HTTP. El desarrollador del filtro determina cómo obtiene una respuesta HTTP. Una aplicación puede crear la respuesta inmediatamente, puede enviar la solicitud a través de TCP a un servidor, incluso puede enviar varias solicitudes a un servidor (o a más de un servidor) antes de generar un mensaje de respuesta. Puesto que no se especifica cómo un filtro llega a un mensaje de respuesta, un filtro puede pasar el mensaje de solicitud a otro filtro (denominado filtro interno), de modo que se delega la creación de un mensaje de respuesta al filtro interno.
Los filtros suelen agregar o cambiar encabezados, controlar la autorización (posiblemente mediante WebAuthenticationBroker) o permitir o denegar una solicitud en función de las condiciones de red. Normalmente, los filtros realizan cambios y, a continuación, pasan la solicitud a un filtro interno, que normalmente se establece cuando se construye un filtro.
Este enfoque permite que los filtros solo sean responsables de un aspecto específico de la ejecución de una solicitud HTTP y delegue otros aspectos a otros filtros. Un filtro puede implementar el almacenamiento en caché, la autenticación, las redireccionamientos, las cookies, la comunicación real con el servidor o una combinación de estos. El filtro de la parte inferior (base) suele ser el que realiza la comunicación real con la red.
A continuación se muestran algunas excepciones que produce esta función.
E_INVALIDARG
El parámetro request era una referencia nula (Nothing en Visual Basic).
E_ILLEGAL_METHOD_CALL
La instancia de IHttpFilter ya envió el mensaje de solicitud.