IApplicationBuilder Antarmuka

Definisi

Ruang nama:

Microsoft.AspNetCore.Builder

Rakitan:

Microsoft.AspNetCore.Http.Abstractions.dll

Paket:

Microsoft.AspNetCore.App.Ref v8.0.0

Sumber:

IApplicationBuilder.cs

Menentukan kelas yang menyediakan mekanisme untuk mengonfigurasi alur permintaan aplikasi.

public interface class IApplicationBuilder

public interface IApplicationBuilder

type IApplicationBuilder = interface

Public Interface IApplicationBuilder

Turunan

Microsoft.AspNetCore.Builder.ApplicationBuilder

Microsoft.AspNetCore.Builder.WebApplication

Microsoft.AspNetCore.MiddlewareAnalysis.AnalysisBuilder

Properti

ApplicationServices	Mendapatkan atau mengatur IServiceProvider yang menyediakan akses ke kontainer layanan aplikasi.
Properties	Mendapatkan kumpulan kunci/nilai yang dapat digunakan untuk berbagi data antara middleware.
ServerFeatures	Mendapatkan sekumpulan fitur HTTP yang disediakan server aplikasi.

Metode

Build()	Membangun delegasi yang digunakan oleh aplikasi ini untuk memproses permintaan HTTP.
New()	Membuat IApplicationBuilder baru yang berbagi PropertiesIApplicationBuilderini.
Use(Func<RequestDelegate,RequestDelegate>)	Menambahkan delegasi middleware ke alur permintaan aplikasi.

Metode Ekstensi

UseAntiforgery(IApplicationBuilder)	Menambahkan middleware anti-pemalsuan ke alur.
UseRequestLocalization(IApplicationBuilder)	Menambahkan RequestLocalizationMiddleware untuk mengatur informasi budaya secara otomatis untuk permintaan berdasarkan informasi yang diberikan oleh klien.
UseRequestLocalization(IApplicationBuilder, RequestLocalizationOptions)	Menambahkan RequestLocalizationMiddleware untuk mengatur informasi budaya secara otomatis untuk permintaan berdasarkan informasi yang diberikan oleh klien.
UseRequestLocalization(IApplicationBuilder, Action<RequestLocalizationOptions>)	Menambahkan RequestLocalizationMiddleware untuk mengatur informasi budaya secara otomatis untuk permintaan berdasarkan informasi yang diberikan oleh klien.
UseRequestLocalization(IApplicationBuilder, String[])	Menambahkan RequestLocalizationMiddleware untuk mengatur informasi budaya secara otomatis untuk permintaan berdasarkan informasi yang diberikan oleh klien.
UseAuthentication(IApplicationBuilder)	Menambahkan AuthenticationMiddleware ke IApplicationBuilderyang ditentukan , yang memungkinkan kemampuan autentikasi.
UseAuthorization(IApplicationBuilder)	Menambahkan AuthorizationMiddleware ke IApplicationBuilderyang ditentukan , yang memungkinkan kemampuan otorisasi. Saat mengotorisasi sumber daya yang dirutekan menggunakan perutean titik akhir, panggilan ini harus muncul di antara panggilan ke app.UseRouting() dan app.UseEndpoints(...) agar middleware berfungsi dengan benar.
UseCertificateForwarding(IApplicationBuilder)	Menambahkan middleware ke alur yang akan mencari sertifikat di header permintaan mendekodekannya, dan memperbarui HttpContext.Connection.ClientCertificate.
UseBlazorFrameworkFiles(IApplicationBuilder)	Mengonfigurasi aplikasi untuk melayani file kerangka kerja Blazor WebAssembly dari jalur akar "/".
UseBlazorFrameworkFiles(IApplicationBuilder, PathString)	Mengonfigurasi aplikasi untuk melayani file kerangka kerja Blazor WebAssembly dari jalur pathPrefix. Jalur ini harus sesuai dengan proyek aplikasi Blazor WebAssembly yang dirujuk.
UseConcurrencyLimiter(IApplicationBuilder)	Kedaluwarsa. Menambahkan ConcurrencyLimiterMiddleware untuk membatasi jumlah permintaan yang dijalankan secara bersamaan.
UseCookiePolicy(IApplicationBuilder)	Menambahkan handler CookiePolicyMiddleware ke IApplicationBuilderyang ditentukan , yang memungkinkan kemampuan kebijakan cookie.
UseCookiePolicy(IApplicationBuilder, CookiePolicyOptions)	Menambahkan handler CookiePolicyMiddleware ke IApplicationBuilderyang ditentukan , yang memungkinkan kemampuan kebijakan cookie.
UseCors(IApplicationBuilder)	Menambahkan middleware CORS ke alur aplikasi web Anda untuk memungkinkan permintaan lintas domain.
UseCors(IApplicationBuilder, Action<CorsPolicyBuilder>)	Menambahkan middleware CORS ke alur aplikasi web Anda untuk memungkinkan permintaan lintas domain.
UseCors(IApplicationBuilder, String)	Menambahkan middleware CORS ke alur aplikasi web Anda untuk memungkinkan permintaan lintas domain.
UseDatabaseErrorPage(IApplicationBuilder)	Kedaluwarsa. Menangkap pengecualian terkait database sinkron dan asinkron dari alur yang dapat diselesaikan menggunakan migrasi Kerangka Kerja Entitas. Ketika pengecualian ini terjadi, respons HTML dengan detail kemungkinan tindakan untuk menyelesaikan masalah dihasilkan.
UseDatabaseErrorPage(IApplicationBuilder, DatabaseErrorPageOptions)	Kedaluwarsa. Menangkap pengecualian terkait database sinkron dan asinkron dari alur yang dapat diselesaikan menggunakan migrasi Kerangka Kerja Entitas. Ketika pengecualian ini terjadi, respons HTML dengan detail kemungkinan tindakan untuk menyelesaikan masalah dihasilkan.
UseDefaultFiles(IApplicationBuilder)	Mengaktifkan pemetaan file default pada jalur saat ini
UseDefaultFiles(IApplicationBuilder, DefaultFilesOptions)	Mengaktifkan pemetaan file default dengan opsi yang diberikan
UseDefaultFiles(IApplicationBuilder, String)	Mengaktifkan pemetaan file default untuk jalur permintaan yang diberikan
UseDeveloperExceptionPage(IApplicationBuilder)	Menangkap instans Exception sinkron dan asinkron dari alur dan menghasilkan respons kesalahan HTML.
UseDeveloperExceptionPage(IApplicationBuilder, DeveloperExceptionPageOptions)	Menangkap instans Exception sinkron dan asinkron dari alur dan menghasilkan respons kesalahan HTML.
UseDirectoryBrowser(IApplicationBuilder)	Aktifkan penjelajahan direktori pada jalur saat ini
UseDirectoryBrowser(IApplicationBuilder, DirectoryBrowserOptions)	Mengaktifkan penjelajahan direktori dengan opsi yang diberikan
UseDirectoryBrowser(IApplicationBuilder, String)	Mengaktifkan penjelajahan direktori untuk jalur permintaan yang diberikan
UseEndpoints(IApplicationBuilder, Action<IEndpointRouteBuilder>)	Menambahkan middleware Microsoft.AspNetCore.Routing.EndpointMiddleware ke IApplicationBuilder yang ditentukan dengan instans EndpointDataSource yang dibangun dari IEndpointRouteBuilderyang dikonfigurasi. Microsoft.AspNetCore.Routing.EndpointMiddleware akan menjalankan Endpoint yang terkait dengan permintaan saat ini.
UseRouting(IApplicationBuilder)	Menambahkan middleware Microsoft.AspNetCore.Routing.EndpointRoutingMiddleware ke IApplicationBuilderyang ditentukan .
UseExceptionHandler(IApplicationBuilder)	Menambahkan middleware ke alur yang akan menangkap pengecualian, mencatatnya, dan menjalankan kembali permintaan dalam alur alternatif. Permintaan tidak akan dijalankan kembali jika respons telah dimulai.
UseExceptionHandler(IApplicationBuilder, ExceptionHandlerOptions)	Menambahkan middleware ke alur yang akan menangkap pengecualian, mencatatnya, dan menjalankan kembali permintaan dalam alur alternatif. Permintaan tidak akan dijalankan kembali jika respons telah dimulai.
UseExceptionHandler(IApplicationBuilder, Action<IApplicationBuilder>)	Menambahkan middleware ke alur yang akan menangkap pengecualian, mencatatnya, dan menjalankan kembali permintaan dalam alur alternatif. Permintaan tidak akan dijalankan kembali jika respons telah dimulai.
UseExceptionHandler(IApplicationBuilder, String)	Menambahkan middleware ke alur yang akan menangkap pengecualian, mencatatnya, mengatur ulang jalur permintaan, dan menjalankan kembali permintaan. Permintaan tidak akan dijalankan kembali jika respons telah dimulai.
UseExceptionHandler(IApplicationBuilder, String, Boolean)	Menambahkan middleware ke alur yang akan menangkap pengecualian, mencatatnya, mengatur ulang jalur permintaan, dan menjalankan kembali permintaan. Permintaan tidak akan dijalankan kembali jika respons telah dimulai.
UseFileServer(IApplicationBuilder)	Aktifkan semua middleware file statis (kecuali penjelajahan direktori) untuk jalur permintaan saat ini di direktori saat ini.
UseFileServer(IApplicationBuilder, FileServerOptions)	Aktifkan semua middleware file statis dengan opsi yang diberikan
UseFileServer(IApplicationBuilder, Boolean)	Aktifkan semua middleware file statis untuk jalur permintaan saat ini di direktori saat ini.
UseFileServer(IApplicationBuilder, String)	Mengaktifkan semua middleware file statis (kecuali penjelajahan direktori) untuk jalur permintaan yang diberikan dari direktori dengan nama yang sama
UseForwardedHeaders(IApplicationBuilder)	Menerapkan header yang diteruskan ke bidang yang cocok pada permintaan saat ini. Menurut konvensi, proksi HTTP meneruskan informasi dari klien di header HTTP terkenal. ForwardedHeadersMiddleware membaca header ini dan mengisi bidang terkait di HttpContext.
UseForwardedHeaders(IApplicationBuilder, ForwardedHeadersOptions)	Menerapkan header yang diteruskan ke bidang yang cocok pada permintaan saat ini. Menurut konvensi, proksi HTTP meneruskan informasi dari klien di header HTTP terkenal. ForwardedHeadersMiddleware membaca header ini dan mengisi bidang terkait di HttpContext.
UseHeaderPropagation(IApplicationBuilder)	Menambahkan middleware yang mengumpulkan header yang akan disebarkan ke HttpClient.
UseHealthChecks(IApplicationBuilder, PathString)	Menambahkan middleware yang menyediakan status pemeriksaan kesehatan.
UseHealthChecks(IApplicationBuilder, PathString, HealthCheckOptions)	Menambahkan middleware yang menyediakan status pemeriksaan kesehatan.
UseHealthChecks(IApplicationBuilder, PathString, Int32)	Menambahkan middleware yang menyediakan status pemeriksaan kesehatan.
UseHealthChecks(IApplicationBuilder, PathString, Int32, HealthCheckOptions)	Menambahkan middleware yang menyediakan status pemeriksaan kesehatan.
UseHealthChecks(IApplicationBuilder, PathString, String)	Menambahkan middleware yang menyediakan status pemeriksaan kesehatan.
UseHealthChecks(IApplicationBuilder, PathString, String, HealthCheckOptions)	Menambahkan middleware yang menyediakan status pemeriksaan kesehatan.
UseHostFiltering(IApplicationBuilder)	Menambahkan middleware untuk memfilter permintaan oleh header host yang diizinkan. Permintaan yang tidak valid akan ditolak dengan kode status 400.
UseHsts(IApplicationBuilder)	Menambahkan middleware untuk menggunakan HSTS, yang menambahkan header Strict-Transport-Security.
UseHttpLogging(IApplicationBuilder)	Menambahkan middleware yang dapat mencatat permintaan dan respons HTTP.
UseW3CLogging(IApplicationBuilder)	Menambahkan middleware yang dapat mencatat permintaan dan respons HTTP untuk log server dalam format W3C.
UseHttpMethodOverride(IApplicationBuilder)	Memungkinkan permintaan POST masuk untuk mengambil alih jenis metode dengan jenis yang ditentukan dalam header. Middleware ini digunakan ketika klien terbatas pada pengiriman metode GET atau POST tetapi ingin memanggil metode HTTP lainnya. Secara default, header permintaan X-HTTP-Method-Override digunakan untuk menentukan metode HTTP yang sedang diterowongan.
UseHttpMethodOverride(IApplicationBuilder, HttpMethodOverrideOptions)	Memungkinkan permintaan POST masuk untuk mengambil alih jenis metode dengan jenis yang ditentukan dalam formulir. Middleware ini digunakan ketika klien terbatas pada pengiriman metode GET atau POST tetapi ingin memanggil metode HTTP lainnya.
UseHttpsRedirection(IApplicationBuilder)	Menambahkan middleware untuk mengalihkan Permintaan HTTP ke HTTPS.
Map(IApplicationBuilder, PathString, Action<IApplicationBuilder>)	Mencabangkan alur permintaan berdasarkan kecocokan jalur permintaan yang diberikan. Jika jalur permintaan dimulai dengan jalur yang diberikan, cabang dijalankan.
Map(IApplicationBuilder, PathString, Boolean, Action<IApplicationBuilder>)	Mencabangkan alur permintaan berdasarkan kecocokan jalur permintaan yang diberikan. Jika jalur permintaan dimulai dengan jalur yang diberikan, cabang dijalankan.
Map(IApplicationBuilder, String, Action<IApplicationBuilder>)	Mencabangkan alur permintaan berdasarkan kecocokan jalur permintaan yang diberikan. Jika jalur permintaan dimulai dengan jalur yang diberikan, cabang dijalankan.
MapWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Mencabangkan alur permintaan berdasarkan hasil predikat yang diberikan.
UseMigrationsEndPoint(IApplicationBuilder)	Memproses permintaan untuk menjalankan operasi migrasi. Middleware akan mendengarkan permintaan yang dibuat untuk DefaultPath.
UseMigrationsEndPoint(IApplicationBuilder, MigrationsEndPointOptions)	Memproses permintaan untuk menjalankan operasi migrasi. Middleware akan mendengarkan permintaan ke jalur yang dikonfigurasi di options.
UseMvc(IApplicationBuilder)	Menambahkan MVC ke alur eksekusi permintaan IApplicationBuilder.
UseMvc(IApplicationBuilder, Action<IRouteBuilder>)	Menambahkan MVC ke alur eksekusi permintaan IApplicationBuilder.
UseMvcWithDefaultRoute(IApplicationBuilder)	Menambahkan MVC ke alur eksekusi permintaan IApplicationBuilder dengan rute default bernama 'default' dan templat berikut: '{controller=Home}/{action=Index}/{id?}'.
UseOutputCache(IApplicationBuilder)	Menambahkan Microsoft.AspNetCore.OutputCaching.OutputCacheMiddleware untuk penembolokan respons HTTP.
UseOwin(IApplicationBuilder)	Menambahkan alur OWIN ke IApplicationBuilderyang ditentukan.
UseOwin(IApplicationBuilder, Action<Action<Func<Func<IDictionary<String,Object>,Task>,Func<IDictionary<String,Object>,Task>>>>)	Menambahkan alur middleware OWIN ke IApplicationBuilderyang ditentukan.
UseRateLimiter(IApplicationBuilder)	Mengaktifkan pembatasan tarif untuk aplikasi.
UseRateLimiter(IApplicationBuilder, RateLimiterOptions)	Mengaktifkan pembatasan tarif untuk aplikasi.
UseRequestDecompression(IApplicationBuilder)	Menambahkan middleware untuk mendekompresi isi permintaan HTTP secara dinamis.
UseRequestTimeouts(IApplicationBuilder)	Mengaktifkan batas waktu permintaan untuk aplikasi. Tidak ada batas waktu yang dikonfigurasi secara default. Mereka harus dikonfigurasi di RequestTimeoutOptions, RequestTimeoutAttribute pada titik akhir, atau menggunakan ekstensi perutean WithRequestTimeout.
UseResponseCaching(IApplicationBuilder)	Menambahkan ResponseCachingMiddleware untuk penembolokan respons HTTP.
UseResponseCompression(IApplicationBuilder)	Menambahkan middleware untuk memadatkan Respons HTTP secara dinamis.
UseRewriter(IApplicationBuilder)	Memeriksa apakah Url tertentu cocok dengan aturan dan kondisi, dan memodifikasi HttpContext pada kecocokan.
UseRewriter(IApplicationBuilder, RewriteOptions)	Memeriksa apakah Url tertentu cocok dengan aturan dan kondisi, dan memodifikasi HttpContext pada kecocokan.
UseRouter(IApplicationBuilder, IRouter)	Menambahkan middleware RouterMiddleware ke IApplicationBuilder yang ditentukan dengan IRouteryang ditentukan.
UseRouter(IApplicationBuilder, Action<IRouteBuilder>)	Menambahkan middleware RouterMiddleware ke IApplicationBuilder yang ditentukan dengan IRouter dibangun dari IRouteBuilderyang dikonfigurasi.
Run(IApplicationBuilder, RequestDelegate)	Menambahkan delegasi middleware terminal ke alur permintaan aplikasi.
UseSession(IApplicationBuilder)	Menambahkan SessionMiddleware untuk mengaktifkan status sesi secara otomatis untuk aplikasi.
UseSession(IApplicationBuilder, SessionOptions)	Menambahkan SessionMiddleware untuk mengaktifkan status sesi secara otomatis untuk aplikasi.
UseSpa(IApplicationBuilder, Action<ISpaBuilder>)	Menangani semua permintaan dari titik ini dalam rantai middleware dengan mengembalikan halaman default untuk Aplikasi Halaman Tunggal (SPA). Middleware ini harus ditempatkan terlambat dalam rantai, sehingga middleware lain untuk melayani file statis, tindakan MVC, dll., lebih diutamakan.
UseStaticFiles(IApplicationBuilder)	Mengaktifkan penyajian file statis untuk jalur permintaan saat ini
UseStaticFiles(IApplicationBuilder, StaticFileOptions)	Mengaktifkan penyajian file statis dengan opsi yang diberikan
UseStaticFiles(IApplicationBuilder, String)	Mengaktifkan penyajian file statis untuk jalur permintaan yang diberikan
UseStatusCodePages(IApplicationBuilder)	Menambahkan middleware StatusCodePages dengan handler respons default yang memeriksa respons dengan kode status antara 400 dan 599 yang tidak memiliki isi.
UseStatusCodePages(IApplicationBuilder, StatusCodePagesOptions)	Menambahkan middleware StatusCodePages dengan opsi tertentu yang memeriksa respons dengan kode status antara 400 dan 599 yang tidak memiliki isi.
UseStatusCodePages(IApplicationBuilder, Action<IApplicationBuilder>)	Menambahkan middleware StatusCodePages ke alur dengan alur middleware alternatif yang ditentukan untuk dijalankan guna menghasilkan isi respons.
UseStatusCodePages(IApplicationBuilder, Func<StatusCodeContext,Task>)	Menambahkan middleware StatusCodePages dengan handler yang ditentukan yang memeriksa respons dengan kode status antara 400 dan 599 yang tidak memiliki isi.
UseStatusCodePages(IApplicationBuilder, String, String)	Menambahkan middleware StatusCodePages dengan isi respons yang ditentukan untuk dikirim. Ini mungkin termasuk tempat penampung '{0}' untuk kode status. Middleware memeriksa respons dengan kode status antara 400 dan 599 yang tidak memiliki isi.
UseStatusCodePagesWithRedirects(IApplicationBuilder, String)	Menambahkan middleware StatusCodePages ke alur. Menentukan bahwa respons harus ditangani dengan mengalihkan dengan templat URL lokasi yang diberikan. Ini mungkin termasuk tempat penampung '{0}' untuk kode status. URL yang dimulai dengan '~' akan memiliki PathBase yang telah ditambahkan sebelumnya, di mana URL lain akan digunakan apa adanya.
UseStatusCodePagesWithReExecute(IApplicationBuilder, String, String)	Menambahkan middleware StatusCodePages ke alur. Menentukan bahwa isi respons harus dihasilkan dengan mengeksekusi ulang alur permintaan menggunakan jalur alternatif. Jalur ini mungkin berisi tempat penampung '{0}' dari kode status.
Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>)	Menambahkan delegasi middleware yang ditentukan sebaris ke alur permintaan aplikasi. Jika Anda tidak memanggil fungsi berikutnya, gunakan Run(IApplicationBuilder, RequestDelegate) sebagai gantinya.
Use(IApplicationBuilder, Func<HttpContext,Func<Task>,Task>)	Menambahkan delegasi middleware yang ditentukan sebaris ke alur permintaan aplikasi. Jika Anda tidak memanggil fungsi berikutnya, gunakan Run(IApplicationBuilder, RequestDelegate) sebagai gantinya. Lebih suka menggunakan Use(IApplicationBuilder, Func<HttpContext,RequestDelegate,Task>) untuk performa yang lebih baik seperti yang ditunjukkan di bawah ini: app.Use((context, next) => { return next(context); });
UseMiddleware(IApplicationBuilder, Type, Object[])	Menambahkan jenis middleware ke alur permintaan aplikasi.
UseMiddleware<TMiddleware>(IApplicationBuilder, Object[])	Menambahkan jenis middleware ke alur permintaan aplikasi.
UsePathBase(IApplicationBuilder, PathString)	Menambahkan middleware yang mengekstrak basis jalur yang ditentukan dari jalur permintaan dan menundanya ke basis jalur permintaan.
UseWhen(IApplicationBuilder, Func<HttpContext,Boolean>, Action<IApplicationBuilder>)	Secara kondisional membuat cabang dalam alur permintaan yang bergabung kembali ke alur utama.
UseWebAssemblyDebugging(IApplicationBuilder)	Menambahkan middleware yang diperlukan untuk men-debug aplikasi Blazor WebAssembly di dalam alat dev Chromium.
UseWebSockets(IApplicationBuilder)	Menambahkan WebSocketMiddleware ke alur permintaan.
UseWebSockets(IApplicationBuilder, WebSocketOptions)	Menambahkan WebSocketMiddleware ke alur permintaan.
UseWelcomePage(IApplicationBuilder)	Menambahkan WelcomePageMiddleware ke alur.
UseWelcomePage(IApplicationBuilder, WelcomePageOptions)	Menambahkan WelcomePageMiddleware ke alur dengan opsi yang diberikan.
UseWelcomePage(IApplicationBuilder, PathString)	Menambahkan WelcomePageMiddleware ke alur dengan jalur yang diberikan.
UseWelcomePage(IApplicationBuilder, String)	Menambahkan WelcomePageMiddleware ke alur dengan jalur yang diberikan.
UseHttpLoggingMiddleware(IApplicationBuilder)	Mendaftarkan middleware pengelogan permintaan HTTP masuk ke IApplicationBuilder.
UseRequestCheckpoint(IApplicationBuilder)	Mendaftarkan middleware terkait Titik Pemeriksaan Permintaan ke dalam alur.
UseRequestLatencyTelemetry(IApplicationBuilder)	Menambahkan middleware telemetri latensi permintaan ke alur eksekusi permintaan IApplicationBuilder.
UseSpaStaticFiles(IApplicationBuilder)	Mengonfigurasi aplikasi untuk menyajikan file statis untuk Aplikasi Halaman Tunggal (SPA). File akan ditemukan menggunakan layanan ISpaStaticFileProvider terdaftar.
UseSpaStaticFiles(IApplicationBuilder, StaticFileOptions)	Mengonfigurasi aplikasi untuk menyajikan file statis untuk Aplikasi Halaman Tunggal (SPA). File akan ditemukan menggunakan layanan ISpaStaticFileProvider terdaftar.