HTTP-ondersteuning in .NET

Hypertext Transfer Protocol (of HTTP) is een protocol voor het aanvragen van resources vanaf een webserver. De System.Net.Http.HttpClient-klasse biedt de mogelijkheid om HTTP-aanvragen te verzenden en HTTP-antwoorden te ontvangen van een resource die is geïdentificeerd door een URI. Veel typen resources zijn beschikbaar op internet en HTTP definieert een set aanvraagmethoden voor toegang tot deze resources.

HTTP-aanvraagmethoden

De aanvraagmethoden worden onderscheiden via verschillende factoren, eerst door hun werkwoord, maar ook door de volgende kenmerken:

• Een aanvraagmethode wordt idempotent als deze meerdere keren kan worden verwerkt zonder het resultaat te wijzigen. Zie RFC 9110: 9.2.2 voor meer informatie. Idempotent Methods.
• Een aanvraagmethode is cachebare wanneer het bijbehorende antwoord kan worden opgeslagen voor hergebruik. Zie RFC 9110: Sectie 9.2.3 voor meer informatie. Methoden en caching.
• Een aanvraagmethode wordt beschouwd als een veilige methode als deze de status van een resource niet wijzigt. Alle veilige methoden zijn ook idempotente, maar niet alle idempotente methoden worden beschouwd als veilige. Zie RFC 9110: Sectie 9.2.1 voor meer informatie. Veilige methoden.

^†De methode POST kan alleen worden opgeslagen in de cache wanneer de juiste Cache-Control of Expires antwoordheaders aanwezig zijn. Dit is in de praktijk zeer ongebruikelijk.

HTTP-statuscodes

.NET biedt uitgebreide ondersteuning voor het HTTP-protocol, dat rekening houdt met het meeste internetverkeer, met de HttpClient. Zie HTTP-aanvragen maken met de HttpClient-klassevoor meer informatie. Toepassingen ontvangen HTTP-protocolfouten door een HttpRequestExceptionte vangen. HTTP-statuscodes worden gerapporteerd in HttpResponseMessage met de HttpResponseMessage.StatusCode of in HttpRequestException met de HttpRequestException.StatusCode als de aangeroepen methode geen antwoordbericht retourneert. Zie voor meer informatie over foutafhandeling HTTP-foutafhandelingen zie RFC 9110, HTTP-semantiek: Statuscodesvoor meer informatie over statuscodes.

Informatieve statuscodes

De informatieve statuscodes weerspiegelen een tussentijdse reactie. De meeste tussentijdse antwoorden, bijvoorbeeld HttpStatusCode.Continue, worden intern verwerkt met HttpClient en worden nooit aan de gebruiker blootgesteld.

Succesvolle statuscodes

De geslaagde statuscodes geven aan dat de aanvraag van de client is ontvangen, begrepen en geaccepteerd.

Omleidingsstatuscodes

Omleidingsstatuscodes vereisen dat de gebruikersagent actie onderneemt om te voldoen aan de aanvraag. Automatische omleiding is standaard ingeschakeld. Deze kan worden gewijzigd met HttpClientHandler.AllowAutoRedirect of SocketsHttpHandler.AllowAutoRedirect.

Client foutstatuscodes

De foutcodes van de client geven aan dat de aanvraag van de client ongeldig is.

Statuscodes voor serverfouten

De foutcodes van de server geven aan dat de server een onverwachte voorwaarde heeft aangetroffen waardoor deze niet aan de aanvraag kan voldoen.

Zie ook

• HTTP-aanvragen maken met de HttpClient-klasse
• HTTP-clientfactory in combinatie met .NET
• richtlijnen voor het gebruik van HttpClient-
• .NET-netwerkverbeteringen