ASP.NET Core Blazor yapılandırması

Bu makalede uygulama ayarları, kimlik doğrulaması ve günlüğe kaydetme yapılandırması dahil olmak üzere uygulamaların nasıl yapılandırılır Blazor açıklanmaktadır.

Uygulama tarafından kaydedilen diğer yapılandırma sağlayıcıları da yapılandırma sağlayabilir, ancak tüm sağlayıcılar veya sağlayıcı özellikleri uygun değildir:

• Azure Key Vault yapılandırma sağlayıcısı: Sağlayıcı, istemci gizli dizi senaryolarıyla yönetilen identity ve uygulama kimliği (istemci kimliği) için desteklenmez. İstemci gizli anahtarı Azure Key Vault hizmetine erişmek için istemci tarafı güvenliği sağlanamadığından, istemci tarafı uygulamalar başta olmak üzere ASP.NET Core uygulamaları için istemci gizli dizisine sahip uygulama kimliği önerilmez.
• Azure Uygulaması yapılandırma sağlayıcısı: Uygulama Azure'daki bir sunucuda çalışmadığından sağlayıcı istemci tarafı uygulaması için uygun değildir.

Yapılandırma sağlayıcıları hakkında daha fazla bilgi için bkz . ASP.NET Core'da yapılandırma.

Uygulama ayarları yapılandırması

Uygulama ayarları dosyalarındaki yapılandırma varsayılan olarak yüklenir. Aşağıdaki örnekte kullanıcı arabirimi yapılandırma değeri bir uygulama ayarları dosyasında depolanır ve çerçeve tarafından Blazor otomatik olarak yüklenir. Değer bir bileşen tarafından okunur.

wwwroot/appsettings.json:

{
    "h1FontSize": "50px"
}

IConfiguration Yapılandırma verilerine erişmek için bir bileşene örnek ekleme.

ConfigExample.razor:

@page "/config-example"
@inject IConfiguration Configuration

<PageTitle>Configuration</PageTitle>

<h1 style="font-size:@Configuration["h1FontSize"]">
    Configuration example (50px)
</h1>

@page "/config-example"
@inject IConfiguration Configuration

<PageTitle>Configuration</PageTitle>

<h1 style="font-size:@Configuration["h1FontSize"]">
    Configuration example (50px)
</h1>

@page "/config-example"
@inject IConfiguration Configuration

<h1 style="font-size:@Configuration["h1FontSize"]">
    Configuration example
</h1>

@page "/config-example"
@inject IConfiguration Configuration

<h1 style="font-size:@Configuration["h1FontSize"]">
    Configuration example
</h1>

@page "/config-example"
@using Microsoft.Extensions.Configuration
@inject IConfiguration Configuration

<h1 style="font-size:@Configuration["h1FontSize"]">
    Configuration example
</h1>

@page "/config-example"
@using Microsoft.Extensions.Configuration
@inject IConfiguration Configuration

<h1 style="font-size:@Configuration["h1FontSize"]">
    Configuration example
</h1>

İstemci güvenlik kısıtlamaları, uygulama yapılandırması için ayarlar dosyaları dahil olmak üzere kullanıcı kodu aracılığıyla dosyalara doğrudan erişimi engeller. Klasörden yapılandırmaya ek olarak yapılandırma dosyalarını okumak için appsettings.json/appsettings.{ENVIRONMENT}.json kullanın.HttpClientwwwroot

Aşağıdaki örnek, uygulamanın yapılandırmasına bir yapılandırma dosyası (cars.json) okur.

wwwroot/cars.json:

{
    "size": "tiny"
}

ad alanını Microsoft.Extensions.Configuration Program dosyasına ekleyin:

using Microsoft.Extensions.Configuration;

Dosyayı okumak için istemciyi kullanmak için mevcut HttpClient hizmet kaydını değiştirin:

var http = new HttpClient()
{
    BaseAddress = new Uri(builder.HostEnvironment.BaseAddress)
};

builder.Services.AddScoped(sp => http);

using var response = await http.GetAsync("cars.json");
using var stream = await response.Content.ReadAsStreamAsync();

builder.Configuration.AddJsonStream(stream);

Yukarıdaki örnek, uygulamanın temel adresini alan ve genellikle ana bilgisayar sayfasındaki etiketin href değerinden <base> türetilen temel adresi ()IWebAssemblyHostEnvironment.BaseAddress ile builder.HostEnvironment.BaseAddress ayarlar.

Bellek Yapılandırma Kaynağı

Aşağıdaki örnek, ek yapılandırma sağlamak için dosyasında bir MemoryConfigurationSource Program kullanır.

ad alanını Microsoft.Extensions.Configuration.Memory Program dosyasına ekleyin:

using Microsoft.Extensions.Configuration.Memory;

Program dosyasında:

var vehicleData = new Dictionary<string, string?>()
{
    { "color", "blue" },
    { "type", "car" },
    { "wheels:count", "3" },
    { "wheels:brand", "Blazin" },
    { "wheels:brand:type", "rally" },
    { "wheels:year", "2008" },
};

var memoryConfig = new MemoryConfigurationSource { InitialData = vehicleData };

builder.Configuration.Add(memoryConfig);

IConfiguration Yapılandırma verilerine erişmek için bir bileşene örnek ekleme.

MemoryConfig.razor:

@page "/memory-config"
@inject IConfiguration Configuration

<PageTitle>Memory Configuration</PageTitle>

<h1>Memory Configuration Example</h1>

<h2>General specifications</h2>

<ul>
    <li>Color: @Configuration["color"]</li>
    <li>Type: @Configuration["type"]</li>
</ul>

<h2>Wheels</h2>

<ul>
    <li>Count: @Configuration["wheels:count"]</li>
    <li>Brand: @Configuration["wheels:brand"]</li>
    <li>Type: @Configuration["wheels:brand:type"]</li>
    <li>Year: @Configuration["wheels:year"]</li>
</ul>

@page "/memory-config"
@inject IConfiguration Configuration

<PageTitle>Memory Configuration</PageTitle>

<h1>Memory Configuration Example</h1>

<h2>General specifications</h2>

<ul>
    <li>Color: @Configuration["color"]</li>
    <li>Type: @Configuration["type"]</li>
</ul>

<h2>Wheels</h2>

<ul>
    <li>Count: @Configuration["wheels:count"]</li>
    <li>Brand: @Configuration["wheels:brand"]</li>
    <li>Type: @Configuration["wheels:brand:type"]</li>
    <li>Year: @Configuration["wheels:year"]</li>
</ul>

@page "/memory-config"
@inject IConfiguration Configuration

<h1>Memory configuration example</h1>

<h2>General specifications</h2>

<ul>
    <li>Color: @Configuration["color"]</li>
    <li>Type: @Configuration["type"]</li>
</ul>

<h2>Wheels</h2>

<ul>
    <li>Count: @Configuration["wheels:count"]</li>
    <li>Brand: @Configuration["wheels:brand"]</li>
    <li>Type: @Configuration["wheels:brand:type"]</li>
    <li>Year: @Configuration["wheels:year"]</li>
</ul>

@page "/memory-config"
@inject IConfiguration Configuration

<h1>Memory configuration example</h1>

<h2>General specifications</h2>

<ul>
    <li>Color: @Configuration["color"]</li>
    <li>Type: @Configuration["type"]</li>
</ul>

<h2>Wheels</h2>

<ul>
    <li>Count: @Configuration["wheels:count"]</li>
    <li>Brand: @Configuration["wheels:brand"]</li>
    <li>Type: @Configuration["wheels:brand:type"]</li>
    <li>Year: @Configuration["wheels:year"]</li>
</ul>

@page "/memory-config"
@using Microsoft.Extensions.Configuration
@inject IConfiguration Configuration

<h1>Memory configuration example</h1>

<h2>General specifications</h2>

<ul>
    <li>Color: @Configuration["color"]</li>
    <li>Type: @Configuration["type"]</li>
</ul>

<h2>Wheels</h2>

<ul>
    <li>Count: @Configuration["wheels:count"]</li>
    <li>Brand: @Configuration["wheels:brand"]</li>
    <li>Type: @Configuration["wheels:brand:type"]</li>
    <li>Year: @Configuration["wheels:year"]</li>
</ul>

@page "/memory-config"
@using Microsoft.Extensions.Configuration
@inject IConfiguration Configuration

<h1>Memory configuration example</h1>

<h2>General specifications</h2>

<ul>
    <li>Color: @Configuration["color"]</li>
    <li>Type: @Configuration["type"]</li>
</ul>

<h2>Wheels</h2>

<ul>
    <li>Count: @Configuration["wheels:count"]</li>
    <li>Brand: @Configuration["wheels:brand"]</li>
    <li>Type: @Configuration["wheels:brand:type"]</li>
    <li>Year: @Configuration["wheels:year"]</li>
</ul>

ile IConfiguration.GetSectionC# kodunda yapılandırmanın bir bölümünü alın. Aşağıdaki örnek, önceki örnekteki yapılandırmanın bölümünü elde wheels eder:

@code {
    protected override void OnInitialized()
    {
        var wheelsSection = Configuration.GetSection("wheels");

        ...
    }
}

Kimlik doğrulama yapılandırması

Uygulama ayarları dosyasında genel kimlik doğrulama yapılandırması sağlayın.

wwwroot/appsettings.json:

{
  "Local": {
    "Authority": "{AUTHORITY}",
    "ClientId": "{CLIENT ID}"
  }
}

dosyasında ile bir Identity sağlayıcının ConfigurationBinder.Bind Program yapılandırmasını yükleyin. Aşağıdaki örnek bir OIDC sağlayıcısının yapılandırmasını yükler:

builder.Services.AddOidcAuthentication(options =>
    builder.Configuration.Bind("Local", options.ProviderOptions));

Günlük yapılandırması

Bu bölüm, klasördeki bir uygulama ayarları dosyası aracılığıyla günlüğe kaydetmeyi wwwroot yapılandıran uygulamalar için geçerlidir.

Microsoft.Extensions.Logging.Configuration Paketi uygulamaya ekleyin.

Uygulama ayarları dosyasında günlük yapılandırmasını sağlayın. Günlük yapılandırması dosyaya Program yüklenir.

wwwroot/appsettings.json:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  }
}

Program dosyasında:

builder.Logging.AddConfiguration(
    builder.Configuration.GetSection("Logging"));

Konak oluşturucu yapılandırması

Dosyasından WebAssemblyHostBuilder.Configuration Program konak oluşturucu yapılandırmasını okuyun:

var hostname = builder.Configuration["HostName"];

Önbelleğe alınmış yapılandırma

Yapılandırma dosyaları çevrimdışı kullanım için önbelleğe alınır. Aşamalı Web Uygulamaları (PWA) ile, yalnızca yeni bir dağıtım oluştururken yapılandırma dosyalarını güncelleştirebilirsiniz. Yapılandırma dosyalarını dağıtımlar arasında düzenlemenin hiçbir etkisi yoktur çünkü:

• Kullanıcılar, kullanmaya devam ettikleri dosyaların sürümlerini önbelleğe almışlardır.
• PWA'ların service-worker.js ve service-worker-assets.js dosyalarının, kullanıcının bir sonraki çevrimiçi ziyaretinde uygulamaya uygulamanın yeniden dağıtıldığını belirten derlemede yeniden oluşturulması gerekir.

Arka plan güncelleştirmelerinin PWA'lar tarafından nasıl işlenmeleri hakkında daha fazla bilgi için bkz . ASP.NET Core Blazor Progressive Web Application (PWA).

Seçenekler yapılandırması

Seçenekler yapılandırması , NuGet paketi için Microsoft.Extensions.Options.ConfigurationExtensions bir paket başvurusu eklemeyi gerektirir.

Örnek:

builder.Services.Configure<MyOptions>(
    builder.Configuration.GetSection("MyOptions"));

ASP.NET Çekirdek Seçenekleri özelliklerinin tümü bileşenlerde Razor desteklenmez. Örneğin, IOptionsSnapshot<TOptions> yapılandırma IOptionsMonitor<TOptions> desteklenir, ancak bu arabirimler için seçenek değerlerini yeniden derleme, uygulamayı yeni bir tarayıcı sekmesinde isteyerek veya tarayıcının yeniden yükle düğmesini seçerek uygulamanın yeniden yüklenmesi dışında desteklenmez. Yalnızca çağrı StateHasChanged , temel alınan yapılandırma değiştiğinde anlık görüntü veya izlenen seçenek değerlerini güncelleştirmez.