daohualiuxiang
/
AspNetCore.Docs
mirror of https://github.com/dotnet/AspNetCore.Docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update Kestrel Overview to 6.0 (#24079) 

* Update Kestrel Overview to 6.0

* .

* .

* .

* .
pull/24084/head
Kirk Larkin 2021-11-26 17:43:51 +00:00 committed by GitHub
parent 35df907c2b
commit 5c14d05fc2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
9 changed files with 61 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
aspnetcore/fundamentals/servers/kestrel.md
View File

@ -28,15 +28,13 @@ Kestrel supports the following scenarios:
Kestrel is supported on all platforms and versions that .NET Core supports.
[View or download sample code](https://github.com/dotnet/AspNetCore.Docs/tree/main/aspnetcore/fundamentals/servers/kestrel/samples/5.x) ([how to download](xref:index#how-to-download-a-sample))
## Get started
ASP.NET Core project templates use Kestrel by default when not hosted with IIS. In *Program.cs*, the <xref:Microsoft.Extensions.Hosting.GenericHostBuilderExtensions.ConfigureWebHostDefaults%2A> method calls <xref:Microsoft.AspNetCore.Hosting.WebHostBuilderKestrelExtensions.UseKestrel%2A>:
ASP.NET Core project templates use Kestrel by default when not hosted with IIS. In *Program.cs*, the <xref:Microsoft.AspNetCore.Builder.WebApplication.CreateBuilder%2A?displayProperty=nameWithType> method calls <xref:Microsoft.AspNetCore.Hosting.WebHostBuilderKestrelExtensions.UseKestrel%2A>:
:::code language="csharp" source="kestrel/samples/5.x/KestrelSample/Program.cs" id="snippet_DefaultBuilder" highlight="8":::
:::code language="csharp" source="kestrel/samples/6.x/KestrelSample/Program.cs" id="snippet_CreateBuilder" highlight="1":::
For more information on building the host, see the *Set up a host* and *Default builder settings* sections of <xref:fundamentals/host/generic-host#set-up-a-host>.
For more information on configuring `WebApplication` and `WebApplicationBuilder`, see <xref:fundamentals/minimal-apis>.
## Optional client certificates

2
aspnetcore/fundamentals/servers/kestrel/http3.md
View File

@ -49,7 +49,7 @@ HTTP/3 isn't currently supported on macOS and may be available in a future relea
HTTP/3 is not enabled by default. Add configuration to *Program.cs* to enable HTTP/3.
[!code-csharp[](samples/6.x/Http3Sample/Program.cs?name=snippet_UseHttp3&highlight=7-8)]
:::code language="csharp" source="samples/6.x/KestrelSample/Snippets/Program.cs" id="snippet_Http3" highlight="7-8":::
The preceding code configures port 5001 to:

7
aspnetcore/fundamentals/servers/kestrel/samples/6.x/Http3Sample/Http3Sample.csproj
View File

@ -1,7 +0,0 @@
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
<TargetFramework>net6.0</TargetFramework>
</PropertyGroup>
</Project>

22
aspnetcore/fundamentals/servers/kestrel/samples/6.x/Http3Sample/Program.cs
View File

@ -1,22 +0,0 @@
using System;
using System.Net;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Server.Kestrel.Core;
#region snippet_UseHttp3
var builder = WebApplication.CreateBuilder(args);
builder.WebHost.ConfigureKestrel((context, options) =>
{
options.ListenAnyIP(5001, listenOptions =>
{
// Use HTTP/3
listenOptions.Protocols = HttpProtocols.Http1AndHttp2AndHttp3;
listenOptions.UseHttps();
});
});
#endregion
await using var app = builder.Build();
app.MapGet("/", () => "Hello World!");
await app.RunAsync();

10
aspnetcore/fundamentals/servers/kestrel/samples/6.x/KestrelSample/KestrelSample.csproj 100644
View File

@ -0,0 +1,10 @@
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
<TargetFramework>net6.0</TargetFramework>
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
<EnablePreviewFeatures>True</EnablePreviewFeatures>
</PropertyGroup>
</Project>

8
aspnetcore/fundamentals/servers/kestrel/samples/6.x/KestrelSample/Program.cs 100644
View File

@ -0,0 +1,8 @@
// <snippet_CreateBuilder>
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/", () => "Hello World!");
app.Run();
// </snippet_CreateBuilder>

22
aspnetcore/fundamentals/servers/kestrel/samples/6.x/KestrelSample/Snippets/Program.cs 100644
View File

@ -0,0 +1,22 @@
using Microsoft.AspNetCore.Server.Kestrel.Core;
namespace KestrelSample.Snippets;
public static class Program
{
public static void Http3(string[] args)
{
// <snippet_Http3>
var builder = WebApplication.CreateBuilder(args);
builder.WebHost.ConfigureKestrel((context, options) =>
{
options.ListenAnyIP(5001, listenOptions =>
{
listenOptions.Protocols = HttpProtocols.Http1AndHttp2AndHttp3;
listenOptions.UseHttps();
});
});
// </snippet_Http3>
}
}

8
aspnetcore/fundamentals/servers/kestrel/samples/6.x/KestrelSample/appsettings.Development.json 100644
View File

@ -0,0 +1,8 @@
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
}
}

9
aspnetcore/fundamentals/servers/kestrel/samples/6.x/KestrelSample/appsettings.json 100644
View File

@ -0,0 +1,9 @@
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
},
"AllowedHosts": "*"
}