Microsoft.AspNetCore.Http Przestrzeń nazw
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zawiera typy do obsługi żądań HTTP i odpowiedzi.
Klasy
| Nazwa | Opis |
|---|---|
| AllowCookieRedirectAttribute |
Określa, że przekierowania uwierzytelniania oparte na plikach cookie są dozwolone dla punktu końcowego. Jest to zwykle zachowanie domyślne, ale istnieje, aby zastąpić IDisableCookieRedirectMetadata niezależnie od kolejności. Jeśli jest obecny, program obsługi uwierzytelniania plików cookie preferuje logowanie przeglądarki lub odmowa dostępu przekierowania powyżej 401 i 403 kodów stanu. |
| AsParametersAttribute |
Określa, że parametr delegata procedury obsługi tras reprezentuje listę parametrów strukturalnych. |
| BadHttpRequestException |
Reprezentuje błąd żądania HTTP |
| BindingAddress |
Adres, z którego może być powiązany serwer HTTP. |
| BrowserConfigurationHttpContextExtensions |
Metody rozszerzeń na HttpContext potrzeby uzyskiwania BrowserConfigurationdostępu do elementu . |
| ConnectionInfo |
Reprezentuje połączenie bazowe dla żądania. |
| CookieBuilder |
Definiuje ustawienia używane do tworzenia pliku cookie. |
| CookieOptions |
Opcje używane do tworzenia nowego pliku cookie. |
| DefaultEndpointFilterInvocationContext |
Udostępnia domyślną implementację zawijania HttpContext parametrów i dostarczonych do procedury obsługi tras. |
| DefaultHttpContext |
Reprezentuje implementację klasy kontekstu HTTP. |
| DefaultHttpContextFactory |
Fabryka do tworzenia HttpContext wystąpień. |
| DisableHttpMetricsAttribute |
Określa, że metryki czasu trwania żądania HTTP są wyłączone dla punktu końcowego. |
| Endpoint |
Reprezentuje logiczny punkt końcowy w aplikacji. |
| EndpointDescriptionAttribute |
Określa opis punktu końcowego w pliku Metadata. |
| EndpointFilterExtensions |
Metody rozszerzenia służące do dodawania IEndpointFilter do procedury obsługi tras. |
| EndpointFilterFactoryContext |
Reprezentuje informacje dostępne za pośrednictwem interfejsu API filtru procedury obsługi tras, gdy użytkownik tworzy nową procedurę obsługi tras. |
| EndpointFilterInvocationContext |
Zapewnia abstrakcję do zawijania HttpContext argumentów i dostarczonych do procedury obsługi tras. |
| EndpointHttpContextExtensions |
Metody rozszerzenia umożliwiające uwidocznienie punktu końcowego w obiekcie HttpContext. |
| EndpointMetadataCollection |
Kolekcja dowolnych metadanych skojarzonych z punktem końcowym. |
| EndpointSummaryAttribute |
Określa podsumowanie w pliku Metadata. |
| FormCollection |
Zawiera przeanalizowane wartości formularza HTTP. |
| FormFile |
Domyślna implementacja elementu IFormFile. |
| FormFileCollection |
Domyślna implementacja elementu IFormFileCollection. |
| HeaderDictionary |
Reprezentuje otokę dla elementu RequestHeaders i ResponseHeaders. |
| HeaderDictionaryExtensions |
Zawiera metody rozszerzenia do modyfikowania IHeaderDictionary wystąpienia. |
| HeaderDictionaryTypeExtensions |
Metody rozszerzenia umożliwiające uzyskiwanie dostępu do silnie typiowanych nagłówków żądań HTTP i odpowiedzi. |
| HeaderParsingHttpRequestExtensions |
Rozszerzenia do analizowania nagłówków. |
| HttpContext |
Hermetyzuje wszystkie informacje specyficzne dla protokołu HTTP dotyczące pojedynczego żądania HTTP. |
| HttpContextAccessor |
Zapewnia implementację IHttpContextAccessor opartą na bieżącym kontekście wykonywania. |
| HttpContextFactory |
Reprezentuje metody używane do tworzenia obiektu kontekstu HTTP. |
| HttpContextFeaturesExtensions |
Metody rozszerzenia służące do pobierania konfiguracji serwera proxy z bieżącego obiektu HttpContext. |
| HttpContextServerVariableExtensions |
Rozszerzenia do odczytywania zmiennych serwera HTTP. |
| HttpMethods |
Zawiera metody weryfikowania metody żądania żądania żądania HTTP. |
| HttpProtocol |
Zawiera metody weryfikowania wersji protokołu żądania HTTP. |
| HttpRequest |
Reprezentuje przychodzącą stronę pojedynczego żądania HTTP. |
| HttpRequestJsonExtensions |
Metody rozszerzenia do odczytywania treści żądania jako kodu JSON. |
| HttpRequestRewindExtensions |
Metody rozszerzeń umożliwiające buforowanie w obiekcie HttpRequest. |
| HttpResponse |
Reprezentuje wychodzącą stronę pojedynczego żądania HTTP. |
| HttpResponseJsonExtensions |
Udostępnia metody rozszerzenia do zapisywania wartości serializowanej JSON do odpowiedzi HTTP. |
| HttpResponseWritingExtensions |
Wygodne metody zapisywania w odpowiedzi. |
| HttpValidationProblemDetails |
Element ProblemDetails dla błędów walidacji. |
| MiddlewareFactory |
Domyślna implementacja dla elementu IMiddlewareFactory. |
| OpenApiRouteHandlerBuilderExtensions |
Metody rozszerzenia do dodawania Metadata , które mają być używane przez biblioteki OpenAPI. |
| ProblemDetailsContext |
Reprezentują bieżący kontekst szczegółów problemu dla żądania. |
| ProblemDetailsOptions |
Opcje kontrolowania WriteAsync(ProblemDetailsContext) zachowania metod i podobnych metod. |
| ProducesResponseTypeMetadata |
Określa typ wartości i kod stanu zwrócony przez akcję. |
| QueryCollection |
Kolekcja ciągów zapytania HttpRequest |
| RequestDelegateFactory |
Tworzy RequestDelegate implementacje z Delegate procedur obsługi żądań. |
| RequestDelegateFactoryOptions |
Opcje kontrolowania zachowania RequestDelegate obiektu podczas tworzenia przy użyciu polecenia RequestDelegateFactory. |
| RequestDelegateMetadataResult |
Metadane wnioskowane przez element InferMetadata(MethodInfo, RequestDelegateFactoryOptions). EndpointBuilder w przypadku podania tych metadanych zostaną wypełnione automatycznie. Jeśli zostanie ono przekazane do Create(Delegate, RequestDelegateFactoryOptions, RequestDelegateMetadataResult)elementu , nie będzie powtarzać wnioskowania metadanych. Wszystkie metadane, które zostaną wywnioskowane, powinny być już przechowywane w programie EndpointBuilder. |
| RequestDelegateResult |
Wynik utworzenia obiektu RequestDelegate na podstawie elementu Delegate |
| RequestFormReaderExtensions |
Rozszerzenie dla .HttpRequest |
| RequestTrailerExtensions |
Rozszerzenia HttpRequest do pracy z nagłówkami końcowymi żądań. |
| ResponseExtensions |
Metody rozszerzeń dla programu HttpResponse. |
| ResponseTrailerExtensions |
Zawiera metody rozszerzenia do modyfikowania nagłówka |
| Results |
Fabryka dla programu IResult. |
| SendFileFallback |
Typ pomocnika, który umożliwia kopiowanie pliku do usługi Stream. Ten typ jest częścią infrastruktury ASP.NET Core i nie powinien być używany przez kod aplikacji. |
| SendFileResponseExtensions |
Udostępnia rozszerzenia httpResponse uwidaczniające rozszerzenie SendFile. |
| SessionExtensions |
Metody rozszerzeń dla programu ISession. |
| StatusCodes |
Kolekcja stałych dla kodów stanu HTTP. |
| StreamResponseBodyFeature |
Implementacja IHttpResponseBodyFeature tego aproximates wszystkich interfejsów API w danym strumieniu. |
| TagsAttribute |
Określa kolekcję tagów w pliku Metadata. |
| TypedResults |
Typizowane fabryki typów IResult w systemie Microsoft.AspNetCore.Http.HttpResults. |
| WebSocketAcceptContext |
Kontekst do negocjowania uaktualnienia protokołu websocket. |
| WebSocketManager |
Zarządza tworzeniem połączeń protokołu WebSocket dla określonego żądania HTTP. |
Struktury
| Nazwa | Opis |
|---|---|
| EndpointMetadataCollection.Enumerator |
Wylicza elementy elementu .EndpointMetadataCollection |
| FormCollection.Enumerator |
FormCollectionWylicza wartość . |
| FragmentString |
Zapewnia prawidłową obsługę wartości FragmentString w razie potrzeby wygenerowania ciągu identyfikatora URI |
| HeaderDictionary.Enumerator |
HeaderDictionaryWylicza wartość . |
| HostString |
Reprezentuje część hosta identyfikatora URI może służyć do konstruowania poprawnie sformatowanego i zakodowanego identyfikatora URI do użycia w nagłówkach HTTP. |
| PathString |
Zapewnia poprawne ucieczki dla wartości Path i PathBase w razie potrzeby odtworzenia ciągu żądania lub identyfikatora URI przekierowania |
| QueryCollection.Enumerator |
QueryCollectionWylicza wartość . |
| QueryString |
Zapewnia poprawną obsługę wartości QueryString w razie potrzeby odtworzenia żądania lub ciągu identyfikatora URI przekierowania |
Interfejsy
| Nazwa | Opis |
|---|---|
| IBindableFromHttpContext<TSelf> |
Definiuje mechanizm tworzenia wystąpienia typu z HttpContext parametrów powiązania dla delegata procedury obsługi tras punktu końcowego. |
| IContentTypeHttpResult |
Definiuje kontrakt reprezentujący wynik punktu końcowego HTTP zawierającego ContentTypeelement . |
| IEndpointFilter |
Udostępnia interfejs do implementowania filtru docelowego programu obsługi tras. |
| IFileHttpResult |
Definiuje kontrakt reprezentujący wynik pliku punktu końcowego HTTP. |
| IFormCollection |
Reprezentuje przeanalizowane wartości formularza wysyłane za pomocą żądania HttpRequest. |
| IFormFile |
Reprezentuje plik wysłany za pomocą żądania HttpRequest. |
| IFormFileCollection |
Reprezentuje kolekcję plików wysyłanych za pomocą żądania HttpRequest. |
| IHeaderDictionary |
Reprezentuje nagłówki HttpRequest i HttpResponse |
| IHttpContextAccessor |
Zapewnia dostęp do bieżącego HttpContextelementu , jeśli jest dostępny. |
| IHttpContextFactory |
Udostępnia metody tworzenia i usuwania HttpContext wystąpień. |
| IMiddleware |
Definiuje oprogramowanie pośredniczące, które można dodać do potoku żądania aplikacji. |
| IMiddlewareFactory |
Udostępnia metody tworzenia oprogramowania pośredniczącego. |
| INestedHttpResult |
Definiuje kontrakt reprezentujący wynik punktu końcowego HTTP, który zawiera typ zagnieżdżony IResult . |
| IProblemDetailsService |
Definiuje typ zapewniający funkcjonalność tworzenia ProblemDetails odpowiedzi. |
| IProblemDetailsWriter |
Definiuje typ, który zapisuje ProblemDetails ładunek do bieżącego Responseelementu . |
| IQueryCollection |
Reprezentuje kolekcję ciągów zapytania HttpRequest |
| IRequestCookieCollection |
Reprezentuje kolekcję plików cookie HttpRequest |
| IResponseCookies |
Otoka nagłówka odpowiedzi Set-Cookie. |
| IResult |
Definiuje kontrakt reprezentujący wynik punktu końcowego HTTP. |
| IResultExtensions |
Udostępnia interfejs do rejestrowania metod zewnętrznych, które zapewniają niestandardowe wystąpienia IResult. |
| ISession |
Przechowuje dane użytkownika, gdy użytkownik przegląda aplikację internetową. Stan sesji używa magazynu obsługiwanego przez aplikację do utrwalania danych między żądaniami od klienta. Dane sesji są wspierane przez pamięć podręczną i uważane za dane efemeryczne. |
| IStatusCodeHttpResult |
Definiuje kontrakt reprezentujący wynik punktu końcowego HTTP zawierającego StatusCodeelement . |
| IValueHttpResult |
Definiuje kontrakt reprezentujący wynik punktu końcowego HTTP zawierającego obiekt Value. |
| IValueHttpResult<TValue> |
Definiuje kontrakt reprezentujący wynik punktu końcowego HTTP zawierającego Valueelement . |
Wyliczenia
| Nazwa | Opis |
|---|---|
| CookieSecurePolicy |
Określa sposób ustawiania właściwości zabezpieczeń plików cookie. |
| SameSiteMode |
Służy do ustawiania pola SameSite na plikach cookie odpowiedzi, aby wskazać, czy te pliki cookie powinny być uwzględniane przez klienta w przyszłych żądaniach "tej samej witryny" lub "między witrynami". Wersja robocza RFC: https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-03#section-4.1.1 |
Delegaci
| Nazwa | Opis |
|---|---|
| EndpointFilterDelegate |
Delegat, który jest stosowany jako filtr w procedurze obsługi tras. |
| RequestDelegate |
Funkcja, która może przetwarzać żądanie HTTP. |
Uwagi
Aby uzyskać więcej informacji na temat interfejsów API HTTP niskiego poziomu, zobacz Access HttpContext w ASP.NET Core.