HttpStatusCode-Enumeration

Artikel
08/20/2007

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.

Freigeben über

HttpStatusCode-Enumeration

Syntax

Member

Hinweise

Beispiel

Plattformen

Versionsinformationen

.NET Framework

.NET Compact Framework

Siehe auch

Referenz

Zusätzliche Ressourcen