HttpStatusCode-Enumeration
Enthält die Werte von Statuscodes, die für HTTP definiert sind.
Namespace: System.Net
Assembly: System (in system.dll)
Syntax
'Declaration
Public Enumeration HttpStatusCode
'Usage
Dim instance As HttpStatusCode
public enum HttpStatusCode
public enum class HttpStatusCode
public enum HttpStatusCode
public enum HttpStatusCode
Member
Membername | Beschreibung | |
---|---|---|
Accepted | Äquivalent zu HTTP-Status 202. Accepted gibt an, dass die Anforderung akzeptiert wurde und weiter verarbeitet werden kann. | |
Ambiguous | Äquivalent zu HTTP-Status 300. Ambiguous gibt an, dass für die angeforderten Informationen mehrere Darstellungen vorhanden sind. Üblicherweise wird dieser Status als Umleitung behandelt und der Inhalt des Location-Headers befolgt, der dieser Antwort zugeordnet ist.
Wenn die HttpWebRequest.AllowAutoRedirect-Eigenschaft false ist, löst Ambiguous eine Ausnahme aus. Ambiguous ist ein Synonym für MultipleChoices. |
|
BadGateway | Äquivalent zu HTTP-Status 502. BadGateway gibt an, dass ein zwischengeschalteter Proxyserver eine fehlerhafte Antwort von einem anderen Proxyserver oder dem Ausgangsserver erhalten hat. | |
BadRequest | Äquivalent zu HTTP-Status 400. BadRequest gibt an, dass die Anforderung vom Server nicht interpretiert werden konnte. BadRequest wird gesendet, wenn kein anderer Fehler zutrifft oder der genaue Fehler nicht bekannt bzw. für diesen kein Fehlercode definiert ist. | |
Conflict | Äquivalent zu HTTP-Status 409. Conflict gibt an, dass die Anforderung wegen eines Konflikts auf dem Server nicht ausgeführt werden konnte. | |
Continue | Äquivalent zu HTTP-Status 100. Continue gibt an, dass der Client mit der Anforderung fortfahren kann. | |
Created | Äquivalent zu HTTP-Status 201. Created gibt an, dass durch die Anforderung eine neue Ressource vor dem Senden der Antwort erstellt wurde. | |
ExpectationFailed | Äquivalent zu HTTP-Status 417. ExpectationFailed gibt an, dass eine im Expect-Header angegebene Erwartung nicht vom Server erfüllt werden konnte. | |
Forbidden | Äquivalent zu HTTP-Status 403. Forbidden gibt an, dass der Server das Erfüllen der Anforderung verweigert. | |
Found | Äquivalent zu HTTP-Status 302. Found gibt an, dass sich die angeforderten Informationen unter dem im Location-Header angegebenen URI befinden. Als Standardaktion wird beim Erhalt dieses Status der Location-Header befolgt, der der Antwort zugeordnet ist. Wenn die ursprüngliche Anforderungsmethode POST war, wird für die umgeleitete Anforderung die GET-Methode verwendet.
Wenn die HttpWebRequest.AllowAutoRedirect-Eigenschaft false ist, löst Found eine Ausnahme aus. Found ist ein Synonym für Redirect. |
|
GatewayTimeout | Äquivalent zu HTTP-Status 504. GatewayTimeout gibt an, dass auf einem zwischengeschalteten Proxyserver beim Warten auf die Antwort von einem anderen Proxyserver oder dem Ausgangsserver ein Timeout aufgetreten ist. | |
Gone | Äquivalent zu HTTP-Status 410. Gone gibt an, dass die angeforderte Ressource nicht mehr verfügbar ist. | |
HttpVersionNotSupported | Äquivalent zu HTTP-Status 505. HttpVersionNotSupported gibt an, dass die angeforderte HTTP-Version vom Server nicht unterstützt wird. | |
InternalServerError | Äquivalent zu HTTP-Status 500. InternalServerError gibt an, dass auf dem Server ein allgemeiner Fehler aufgetreten ist. | |
LengthRequired | Äquivalent zu HTTP-Status 411. LengthRequired gibt an, dass der angeforderte Content-Length-Header fehlt. | |
MethodNotAllowed | Äquivalent zu HTTP-Status 405. MethodNotAllowed gibt an, dass die Anforderungsmethode (POST oder GET) für die angeforderte Ressource nicht zulässig ist. | |
Moved | Äquivalent zu HTTP-Status 301. Moved gibt an, dass die angeforderten Informationen zu dem URI verschoben wurden, der im Location-Header angegeben ist. Als Standardaktion wird beim Erhalt dieses Status der Location-Header befolgt, der der Antwort zugeordnet ist. Wenn die ursprüngliche Anforderungsmethode POST war, wird für die umgeleitete Anforderung die GET-Methode verwendet.
Moved ist ein Synonym für MovedPermanently. |
|
MovedPermanently | Äquivalent zu HTTP-Status 301. MovedPermanently gibt an, dass die angeforderten Informationen zu dem URI verschoben wurden, der im Location-Header angegeben ist. Als Standardaktion wird beim Erhalt dieses Status der Location-Header befolgt, der der Antwort zugeordnet ist.
MovedPermanently ist ein Synonym für Moved. |
|
MultipleChoices | Äquivalent zu HTTP-Status 300. MultipleChoices gibt an, dass für die angeforderten Informationen mehrere Darstellungen vorhanden sind. Üblicherweise wird dieser Status als Umleitung behandelt und der Inhalt des Location-Headers befolgt, der dieser Antwort zugeordnet ist.
Wenn die HttpWebRequest.AllowAutoRedirect-Eigenschaft false ist, löst MultipleChoices eine Ausnahme aus. MultipleChoices ist ein Synonym für Ambiguous. |
|
NoContent | Äquivalent zu HTTP-Status 204. NoContent gibt an, dass die Anforderung erfolgreich verarbeitet wurde und eine leere Antwort ergeben hat. | |
NonAuthoritativeInformation | Äquivalent zu HTTP-Status 203. NonAuthoritativeInformation gibt an, dass die zurückgegebenen Metainformationen statt vom Ausgangsserver aus einer zwischengespeicherten Kopie stammen und deshalb fehlerhaft sein können. | |
NotAcceptable | Äquivalent zu HTTP-Status 406. NotAcceptable gibt an, dass der Client mit Accept-Headern angegeben hat, dass er keine der verfügbaren Darstellungen der Ressource akzeptiert. | |
NotFound | Äquivalent zu HTTP-Status 404. NotFound gibt an, dass die angeforderte Ressource auf dem Server nicht vorhanden ist. | |
NotImplemented | Äquivalent zu HTTP-Status 501. NotImplemented gibt an, dass der Server die angeforderte Funktion nicht unterstützt. | |
NotModified | Äquivalent zu HTTP-Status 304. NotModified gibt an, dass die zwischengespeicherte Kopie des Clients aktuell ist. Der Inhalt der Ressource wird nicht übertragen. | |
OK | Äquivalent zu HTTP-Status 200. OK gibt an, dass die Anforderung erfolgreich war und die angeforderten Informationen in der Antwort enthalten sind. Dieser Statuscode wird am häufigsten empfangen. | |
PartialContent | Äquivalent zu HTTP-Status 206. PartialContent gibt an, dass entsprechend der Anforderung über eine GET-Methode, die einen Bytebereich enthält, ein unvollständiger Inhalt in der Antwort zurückgegeben wurde. | |
PaymentRequired | Äquivalent zu HTTP-Status 402. PaymentRequired ist für eine zukünftige Verwendung reserviert. | |
PreconditionFailed | Äquivalent zu HTTP-Status 412. PreconditionFailed gibt an, dass eine für diese Anforderung festgelegte Bedingung nicht erfüllt wurde und die Anforderung nicht ausgeführt werden kann. Bedingungen werden über Header für bedingte Anforderungen festgelegt (z. B. If-Match, If-None-Match oder If-Unmodified-Since). | |
ProxyAuthenticationRequired | Äquivalent zu HTTP-Status 407. ProxyAuthenticationRequired gibt an, dass der angeforderte Proxy eine Authentifizierung erfordert. Der Proxy-Authenticate-Header enthält die Details zum Durchführen der Authentifizierung. | |
Redirect | Äquivalent zu HTTP-Status 302. Redirect gibt an, dass sich die angeforderten Informationen unter dem im Location-Header angegebenen URI befinden. Als Standardaktion wird beim Erhalt dieses Status der Location-Header befolgt, der der Antwort zugeordnet ist. Wenn die ursprüngliche Anforderungsmethode POST war, wird für die umgeleitete Anforderung die GET-Methode verwendet.
Wenn die HttpWebRequest.AllowAutoRedirect-Eigenschaft false ist, löst Redirect eine Ausnahme aus. Redirect ist ein Synonym für Found. |
|
RedirectKeepVerb | Äquivalent zu HTTP-Status 307. RedirectKeepVerb gibt an, dass sich die Anforderungsinformationen unter dem im Location-Header angegebenen URI befinden. Als Standardaktion wird beim Erhalt dieses Status der Location-Header befolgt, der der Antwort zugeordnet ist. Wenn die ursprüngliche Anforderungsmethode POST war, wird für die umgeleitete Anforderung ebenfalls die POST-Methode verwendet.
Wenn die HttpWebRequest.AllowAutoRedirect-Eigenschaft false ist, löst RedirectKeepVerb eine Ausnahme aus. RedirectKeepVerb ist ein Synonym für TemporaryRedirect. |
|
RedirectMethod | Äquivalent zu HTTP-Status 303. RedirectMethod leitet den Client als Ergebnis eines POST-Vorgangs automatisch zum im Location-Header angegebenen URI um. Die Anforderung an die vom Location-Header angegebene Ressource wird mit GET ausgeführt.
Wenn die HttpWebRequest.AllowAutoRedirect-Eigenschaft false ist, löst RedirectMethod eine Ausnahme aus. RedirectMethod ist ein Synonym für SeeOther. |
|
RequestedRangeNotSatisfiable | Äquivalent zu HTTP-Status 416. RequestedRangeNotSatisfiable gibt an, dass der von der Ressource angeforderte Datenbereich nicht zurückgegeben werden kann, da der Bereichsanfang vor dem Anfang der Ressource oder das Bereichsende hinter dem Ende der Ressource liegt. | |
RequestEntityTooLarge | Äquivalent zu HTTP-Status 413. RequestEntityTooLarge gibt an, dass die Anforderung zu umfangreich ist und vom Server nicht verarbeitet werden kann. | |
RequestTimeout | Äquivalent zu HTTP-Status 408. RequestTimeout gibt an, dass der Client keine Anforderung in dem Zeitraum gesendet hat, in dem der Server diese erwartet hat. | |
RequestUriTooLong | Äquivalent zu HTTP-Status 414. RequestUriTooLong gibt an, dass der URI zu lang ist. | |
ResetContent | Äquivalent zu HTTP-Status 205. ResetContent gibt an, dass der Client die aktuelle Ressource zurücksetzen (nicht erneut laden) muss. | |
SeeOther | Äquivalent zu HTTP-Status 303. SeeOther leitet den Client als Ergebnis eines POST-Vorgangs automatisch zum im Location-Header angegebenen URI um. Die Anforderung an die vom Location-Header angegebene Ressource wird mit GET ausgeführt.
Wenn die HttpWebRequest.AllowAutoRedirect-Eigenschaft false ist, löst SeeOther eine Ausnahme aus. SeeOther ist ein Synonym für RedirectMethod. |
|
ServiceUnavailable | Äquivalent zu HTTP-Status 503. ServiceUnavailable gibt an, dass der Server vorübergehend nicht verfügbar ist, i. d. R. aufgrund einer zu großen Serverlast oder aus Wartungsgründen. | |
SwitchingProtocols | Äquivalent zu HTTP-Status 101. SwitchingProtocols gibt an, dass die Protokollversion bzw. das Protokoll geändert wird. | |
TemporaryRedirect | Äquivalent zu HTTP-Status 307. TemporaryRedirect gibt an, dass sich die Anforderungsinformationen unter dem im Location-Header angegebenen URI befinden. Als Standardaktion wird beim Erhalt dieses Status der Location-Header befolgt, der der Antwort zugeordnet ist. Wenn die ursprüngliche Anforderungsmethode POST war, wird für die umgeleitete Anforderung ebenfalls die POST-Methode verwendet.
Wenn die HttpWebRequest.AllowAutoRedirect-Eigenschaft false ist, löst TemporaryRedirect eine Ausnahme aus. TemporaryRedirect ist ein Synonym für RedirectKeepVerb. |
|
Unauthorized | Äquivalent zu HTTP-Status 401. Unauthorized gibt an, dass die angeforderte Ressource eine Authentifizierung erfordert. Der WWW-Authenticate-Header enthält die Details zum Durchführen der Authentifizierung. | |
UnsupportedMediaType | Äquivalent zu HTTP-Status 415. UnsupportedMediaType gibt an, dass es sich bei der Anforderung um einen nicht unterstützten Typ handelt. | |
Unused | Äquivalent zu HTTP-Status 306. Unused ist eine vorgeschlagene Erweiterung der HTTP/1.1-Spezifikation, die nicht vollständig spezifiziert ist. | |
UseProxy | Äquivalent zu HTTP-Status 305. UseProxy gibt an, dass für die Anforderung der Proxyserver an dem im Location-Header angegebenen URI zu verwenden ist. |
Hinweise
Die HttpStatusCode-Enumeration enthält die Werte der in RFC 2616 für HTTP 1.1 definierten Statuscodes.
Der Status einer HTTP-Anforderung ist in der HttpWebResponse.StatusCode-Eigenschaft enthalten.
Beispiel
Im folgenden Beispiel wird der von HttpWebResponse zurückgegebene Status mit einem Member der HttpStatusCode-Klasse verglichen, um den Status einer Antwort zu bestimmen.
Dim httpReq As HttpWebRequest = CType(WebRequest.Create("https://www.contoso.com"), HttpWebRequest)
httpReq.AllowAutoRedirect = False
Dim httpRes As HttpWebResponse = CType(httpReq.GetResponse(), HttpWebResponse)
If httpRes.StatusCode = HttpStatusCode.Moved Then
' Code for moved resources goes here.
End If
httpRes.Close()
HttpWebRequest httpReq = (HttpWebRequest)WebRequest.Create("https://www.contoso.com");
httpReq.AllowAutoRedirect = false;
HttpWebResponse httpRes = (HttpWebResponse)httpReq.GetResponse();
if (httpRes.StatusCode==HttpStatusCode.Moved)
{
// Code for moved resources goes here.
}
// Close the response.
httpRes.Close();
HttpWebRequest^ httpReq = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "https://www.contoso.com" ));
httpReq->AllowAutoRedirect = false;
HttpWebResponse^ httpRes = dynamic_cast<HttpWebResponse^>(httpReq->GetResponse());
if ( httpRes->StatusCode == HttpStatusCode::Moved )
{
// Code for moved resources goes here.
}
// Close the response.
httpRes->Close();
HttpWebRequest httpReq =
((HttpWebRequest)(WebRequest.Create("https://www.contoso.com")));
httpReq.set_AllowAutoRedirect(false);
HttpWebResponse httpRes = ((HttpWebResponse)(httpReq.GetResponse()));
if (httpRes.get_StatusCode().Equals(HttpStatusCode.Moved)) {
// Code for moved resources goes here.
}
// Close the response.
httpRes.Close();
var httpReq : HttpWebRequest = HttpWebRequest(WebRequest.Create("https://www.contoso.com"))
httpReq.AllowAutoRedirect = false
var httpRes : HttpWebResponse = HttpWebResponse(httpReq.GetResponse())
if(httpRes.StatusCode == HttpStatusCode.Moved){
// Code for moved resources goes here.
}
httpRes.Close()
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0