WebErrorStatus Enumeration

Referenz

Definition

Namespace:: Windows.Web

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Definiert Fehler, die bei Vorgängen mit Webdiensten auftreten, z. B. Authentifizierung, Proxykonfiguration und Ziel-URIs.

public enum class WebErrorStatus

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class WebErrorStatus

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum WebErrorStatus

var value = Windows.Web.WebErrorStatus.unknown

Public Enum WebErrorStatus

Vererbung: Enum
WebErrorStatus

Attribute: ContractVersionAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Felder

BadGateway	502	Der Server fungierte als Gateway oder Proxy und erhielt eine ungültige Antwort vom Upstream-Server.
BadRequest	400	Die Anforderung kann aufgrund einer fehlerhaften Syntax nicht erfüllt werden.
CannotConnect	14	Es kann keine Verbindung mit dem Ziel hergestellt werden.
CertificateCommonNameIsIncorrect	1	Der allgemeine Name des SSL-Zertifikats stimmt nicht mit der Webadresse überein.
CertificateContainsErrors	3	Das SSL-Zertifikat enthält Fehler.
CertificateExpired	2	Das SSL-Zertifikat ist abgelaufen.
CertificateIsInvalid	5	Das SSL-Zertifikat ist ungültig.
CertificateRevoked	4	Das SSL-Zertifikat wurde widerrufen.
Conflict	409	Gibt an, dass die Anforderung aufgrund eines Konflikts in der Anforderung nicht verarbeitet werden konnte.
ConnectionAborted	9	Die Verbindung wurde abgebrochen.
ConnectionReset	10	Die Verbindung wurde zurückgesetzt.
Disconnected	11	Die Verbindung wurde beendet.
ErrorHttpInvalidServerResponse	8	Der Server hat eine ungültige oder nicht erkannte Antwort zurückgegeben.
ExpectationFailed	417	Der Server kann die Anforderungen des Felds Anforderungsheader erwarten nicht erfüllen.
Forbidden	403	Der Server hat die Anforderung abgelehnt.
Found	302	Die Ressource wurde gefunden, ist aber an einem anderen Speicherort als in der Anforderung verfügbar.
GatewayTimeout	504	Der Server fungierte als Gateway oder Proxy und erhielt keine rechtzeitige Antwort vom Upstream-Server.
Gone	410	Gibt an, dass die angeforderte Ressource nicht mehr verfügbar ist und nicht wieder verfügbar ist.
HostNameNotResolved	15	Der angegebene Hostname konnte nicht aufgelöst werden.
HttpsToHttpOnRedirection	13	Von einem sicheren Standort an einen unsicheren Standort umgeleitet.
HttpToHttpsOnRedirection	12	Von einem Standort an einen sicheren Standort umgeleitet.
HttpVersionNotSupported	505	Der Server unterstützt die in der Anforderung verwendete HTTP-Protokollversion nicht.
InsufficientRangeSupport	22	Die Anforderung unterstützt den Bereich nicht.
InternalServerError	500	Eine generische Fehlermeldung, die angegeben wird, wenn keine spezifischere Nachricht geeignet ist.
LengthRequired	411	Die Anforderung hat nicht die Länge ihres Inhalts angegeben, die für die angeforderte Ressource erforderlich ist.
MethodNotAllowed	405	Eine Anforderung wurde an eine Ressource mit einer Anforderungsmethode gestellt, die von dieser Ressource nicht unterstützt wird.
MissingContentLengthSupport	23	Bei der Anforderung wird die Dateigröße falsch angegeben.
MovedPermanently	301	Diese und alle zukünftigen Anforderungen sollten an den angegebenen URI weitergeleitet werden.
MultipleChoices	300	Die angeforderte URL stellt eine allgemeine Gruppierung dar, deren Auswahl auf niedrigerer Ebene erfolgen muss.
NotAcceptable	406	Die angeforderte Ressource kann nur Inhalte generieren, die gemäß den in der Anforderung gesendeten Accept-Headern nicht akzeptabel sind.
NotFound	404	Die angeforderte Ressource konnte nicht gefunden werden, ist aber möglicherweise in Zukunft wieder verfügbar.
NotImplemented	501	Der Server erkennt entweder die Anforderungsmethode nicht oder es fehlt die Fähigkeit, die Anforderung zu erfüllen.
NotModified	304	Gibt an, dass die Ressource seit der letzten Anforderung nicht geändert wurde.
OperationCanceled	16	Der Vorgang wurde abgebrochen.
PaymentRequired	402	Reserviert.
PreconditionFailed	412	Der Server erfüllt keine der Voraussetzungen, die der Anforderer für die Anforderung gestellt hat.
ProxyAuthenticationRequired	407	Der Client muss sich zuerst beim Proxy authentifizieren.
RedirectFailed	17	Fehler bei der Anforderungsumleitung.
RequestedRangeNotSatisfiable	416	Der Client hat einen Teil der Datei angefordert, aber der Server kann diesen Teil nicht bereitstellen.
RequestEntityTooLarge	413	Die Anforderung ist größer als der Server verarbeiten willens oder in der Lage ist.
RequestTimeout	408	Das Zeitlimit wurde beim Warten auf die Anforderung vom Server überschritten.
RequestUriTooLong	414	Vorausgesetzt, die URI-Länge überschreitet die maximale Länge, die der Server verarbeiten kann.
SeeOther	303	Die Antwort auf die Anforderung kann unter einem anderen URI mithilfe einer GET-Methode gefunden werden.
ServerUnreachable	6	Der Server reagiert nicht.
ServiceUnavailable	503	Der Server ist zurzeit nicht verfügbar.
TemporaryRedirect	307	Die angeforderte Ressource befindet sich vorübergehend unter einem anderen URI.
Timeout	7	Für die Verbindung ist ein Timeout aufgetreten.
Unauthorized	401	Die Authentifizierung ist fehlgeschlagen, oder es wurden noch keine Anmeldeinformationen angegeben.
UnexpectedClientError	20	Ein unerwarteter clientseitiger Fehler ist aufgetreten.
UnexpectedRedirection	19	Eine Anforderung wurde unerwartet umgeleitet.
UnexpectedServerError	21	Es ist ein unerwarteter serverseitiger Fehler aufgetreten.
UnexpectedStatusCode	18	Ein unerwarteter status Code, der angibt, dass ein Fehler empfangen wurde.
Unknown	0	Ein unbekannter Fehler ist aufgetreten.
UnsupportedMediaType	415	Die Anforderungsentität verfügt über einen Medientyp, den der Server oder die Ressource nicht unterstützt.
UseProxy	305	Auf die angeforderte Ressource muss über den Proxy des Felds Speicherort zugegriffen werden.

Hinweise

Ein WebErrorStatus-Wert wird von Windows.Web.WebError.GetStatus, Windows.Networking.WebSocketError.GetStatus und Windows.Networking.BackgroundTransfer.GetStatus zurückgegeben.

In diesem Beispiel wird veranschaulicht, wie Sie mithilfe von WebErrorStatus je nach Fehlertyp eine andere Fehlermeldung anzeigen. In diesem Beispiel wird der WebErrorStatus-Wert von Windows.Networking.WebSocketError.GetStatus zurückgegeben.

using Windows.Web;
using Windows.Networking.Sockets;

// Pointer back to the main page. Needed to call methods in MainPage such as NotifyUser()
MainPage rootPage = MainPage.Current;

WebErrorStatus status = WebSocketError.GetStatus(ex.GetBaseException().HResult);

if (status == WebErrorStatus.CannotConnect ||
    status == WebErrorStatus.NotFound || 
    status == WebErrorStatus.RequestTimeout)
{
    rootPage.NotifyUser("Cannot connect to the server", NotifyType.ErrorMessage);
}
else
{
    rootPage.NotifyUser("Error: " + status, NotifyType.ErrorMessage);
}

// Pointer back to the main page. Needed to call methods in MainPage such as NotifyUser().
m_rootPage = MainPage::Current();

Windows::Web::WebErrorStatus status{ Windows::Networking::Sockets::WebSocketError::GetStatus(exception.to_abi()) };

if (status == Windows::Web::WebErrorStatus::CannotConnect ||
    status == Windows::Web::WebErrorStatus::NotFound ||
    status == Windows::Web::WebErrorStatus::RequestTimeout)
{
    m_rootPage.NotifyUser(L"Cannot connect to the server", NotifyType::ErrorMessage);
}
else
{
    m_rootPage.NotifyUser(std::wstring(L"Error: ") + exception.message().c_str(), NotifyType::ErrorMessage);
}

using namespace Windows::Web;
using namespace Windows::Networking::Sockets;

// Pointer back to the main page. Needed to call methods in MainPage such as NotifyUser()
rootPage = MainPage::Current;

WebErrorStatus status = WebSocketError::GetStatus(exception->HResult);

if (status == WebErrorStatus::CannotConnect || 
    status == WebErrorStatus::NotFound || 
    status == WebErrorStatus::RequestTimeout)
{
    rootPage->NotifyUser("Cannot connect to the server", NotifyType::ErrorMessage);
}
else
{
    rootPage->NotifyUser("Error: " + status.ToString(), NotifyType::ErrorMessage);
}

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1709	16299	InsufficientRangeSupport
1709	16299	MissingContentLengthSupport

Gilt für:

Freigeben über