.NET'te bağımlılık enjeksiyonu kullanma öğreticisi

Bu öğreticide .NET'da bağımlılık eklemenin (DI) nasıl kullanılacağı gösterilmektedir. DI, hizmetler eklenerek ve IServiceCollection içinde yapılandırılarak yönetilir. IHost arabirimi, tüm kayıtlı hizmetlerin kapsayıcısı işlevi gören IServiceProvider örneğini kullanıma sunar.

Bu eğitimde şunları öğreniyorsunuz:

Bağımlılık ekleme kullanan bir .NET konsol uygulaması oluşturun.
Genel sunucu oluşturun ve yapılandırın.
Çeşitli arabirimler ve karşılık gelen uygulamalar yazın.
DI için hizmet ömrü ve kapsam belirlemeyi kullanın.

Önkoşullar

.NET Core 8.0 SDK veya üzeri.
Yeni .NET uygulamaları oluşturma ve NuGet paketlerini yükleme hakkında bilgi.

Yeni konsol uygulaması oluşturma

dotnet new komutunu veya IDE yeni proje sihirbazını kullanarak ConsoleDI adlı yeni bir .NET konsol uygulaması oluşturun.Example. Projeye Microsoft.Extensions.Hosting NuGet paketini ekleyin.

Yeni konsol uygulaması proje dosyanız aşağıdakine benzer olmalıdır:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>true</ImplicitUsings>
    <RootNamespace>ConsoleDI.Example</RootNamespace>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.Extensions.Configuration.Binder" Version="10.0.2" />
    <PackageReference Include="Microsoft.Extensions.Hosting" Version="10.0.2" />
  </ItemGroup>

</Project>

Önemli

Bu örnekte, uygulamayı derlemek ve çalıştırmak için Microsoft.Extensions.Hosting NuGet paketi gereklidir. Bazı meta paketler Microsoft.Extensions.Hosting paketini içerebilir ve bu durumda açık bir paket başvurusu gerekmez.

Arabirim ekleme

Bu örnek uygulamada bağımlılık eklemenin hizmet ömrünü nasıl işlediğini öğreneceksiniz. Farklı hizmet ömürlerini temsil eden çeşitli arabirimler oluşturursunuz. Proje kök dizinine aşağıdaki arabirimleri ekleyin:

IReportServiceLifetime.cs

using Microsoft.Extensions.DependencyInjection;

namespace ConsoleDI.Example;

public interface IReportServiceLifetime
{
    Guid Id { get; }

    ServiceLifetime Lifetime { get; }
}

IReportServiceLifetime arabirimi aşağıdakileri tanımlar:

Hizmetin benzersiz tanımlayıcısını temsil eden bir Guid Id özelliği.
Hizmet ömrünü temsil eden bir ServiceLifetime özelliği.

IExampleTransientService.cs

using Microsoft.Extensions.DependencyInjection;

namespace ConsoleDI.Example;

public interface IExampleTransientService : IReportServiceLifetime
{
    ServiceLifetime IReportServiceLifetime.Lifetime => ServiceLifetime.Transient;
}

IExampleScopedService.cs

using Microsoft.Extensions.DependencyInjection;

namespace ConsoleDI.Example;

public interface IExampleScopedService : IReportServiceLifetime
{
    ServiceLifetime IReportServiceLifetime.Lifetime => ServiceLifetime.Scoped;
}

IExampleSingletonService.cs

using Microsoft.Extensions.DependencyInjection;

namespace ConsoleDI.Example;

public interface IExampleSingletonService : IReportServiceLifetime
{
    ServiceLifetime IReportServiceLifetime.Lifetime => ServiceLifetime.Singleton;
}

IReportServiceLifetime'ın tüm alt arabirimleri, varsayılan bir değerle birlikte IReportServiceLifetime.Lifetime'i açıkça uygular. Örneğin, IExampleTransientService, IReportServiceLifetime.Lifetime'i ServiceLifetime.Transient değeriyle açıkça uygular.

Varsayılan uygulamaları ekleme

Örnek uygulamaların tümü Id özelliğini Guid.NewGuid()sonucuyla başlatır. Çeşitli hizmetler için aşağıdaki varsayılan uygulama sınıflarını proje kök dizinine ekleyin:

ExampleTransientService.cs

namespace ConsoleDI.Example;

internal sealed class ExampleTransientService : IExampleTransientService
{
    Guid IReportServiceLifetime.Id { get; } = Guid.NewGuid();
}

ExampleScopedService.cs

namespace ConsoleDI.Example;

internal sealed class ExampleScopedService : IExampleScopedService
{
    Guid IReportServiceLifetime.Id { get; } = Guid.NewGuid();
}

ExampleSingletonService.cs

namespace ConsoleDI.Example;

internal sealed class ExampleSingletonService : IExampleSingletonService
{
    Guid IReportServiceLifetime.Id { get; } = Guid.NewGuid();
}

Her uygulama internal sealed olarak tanımlanır ve ilgili arabirimini uygular. Bunların internal veya sealedolması gerekmez, ancak uygulama türlerinin dış tüketicilere sızmasını önlemek için uygulamaları internal olarak ele almak yaygın bir durum değildir. Ayrıca, her tür genişletilmediği için sealed olarak işaretlenir. Örneğin, ExampleSingletonServiceIExampleSingletonServiceuygular.

DI gerektiren bir hizmet ekleme

Konsol uygulamasına hizmet işlevi gören aşağıdaki hizmet ömrü muhabir sınıfını ekleyin:

ServiceLifetimeReporter.cs

namespace ConsoleDI.Example;

internal sealed class ServiceLifetimeReporter(
    IExampleTransientService transientService,
    IExampleScopedService scopedService,
    IExampleSingletonService singletonService)
{
    public void ReportServiceLifetimeDetails(string lifetimeDetails)
    {
        Console.WriteLine(lifetimeDetails);

        LogService(transientService, "Always different");
        LogService(scopedService, "Changes only with lifetime");
        LogService(singletonService, "Always the same");
    }

    private static void LogService<T>(T service, string message)
        where T : IReportServiceLifetime =>
        Console.WriteLine(
            $"    {typeof(T).Name}: {service.Id} ({message})");
}

ServiceLifetimeReporter, yukarıda belirtilen hizmet arabirimlerinin her birini (IExampleTransientService, IExampleScopedServiceve IExampleSingletonService) gerektiren bir oluşturucu tanımlar. nesnesi, tüketicinin belirli bir lifetimeDetails parametresiyle hizmette raporlama yapmasına olanak tanıyan tek bir yöntemi kullanıma sunar. Çağrıldığında, ReportServiceLifetimeDetails yöntemi, her hizmetin benzersiz tanımlayıcısını hizmet yaşam süresi mesajıyla günlüğe kaydeder. Günlük iletileri hizmet ömrünü görselleştirmeye yardımcı olur.

DI için hizmetleri kaydedin

Program.cs aşağıdaki kodla güncelleştirin:

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using ConsoleDI.Example;

HostApplicationBuilder builder = Host.CreateApplicationBuilder(args);

builder.Services.AddTransient<IExampleTransientService, ExampleTransientService>();
builder.Services.AddScoped<IExampleScopedService, ExampleScopedService>();
builder.Services.AddSingleton<IExampleSingletonService, ExampleSingletonService>();
builder.Services.AddTransient<ServiceLifetimeReporter>();

using IHost host = builder.Build();

ExemplifyServiceLifetime(host.Services, "Lifetime 1");
ExemplifyServiceLifetime(host.Services, "Lifetime 2");

await host.RunAsync();

static void ExemplifyServiceLifetime(IServiceProvider hostProvider, string lifetime)
{
    using IServiceScope serviceScope = hostProvider.CreateScope();
    IServiceProvider provider = serviceScope.ServiceProvider;
    ServiceLifetimeReporter logger = provider.GetRequiredService<ServiceLifetimeReporter>();
    logger.ReportServiceLifetimeDetails(
        $"{lifetime}: Call 1 to provider.GetRequiredService<ServiceLifetimeReporter>()");

    Console.WriteLine("...");

    logger = provider.GetRequiredService<ServiceLifetimeReporter>();
    logger.ReportServiceLifetimeDetails(
        $"{lifetime}: Call 2 to provider.GetRequiredService<ServiceLifetimeReporter>()");

    Console.WriteLine();
}

Her bir services.Add{LIFETIME}<{SERVICE}> uzantısı yöntemi, hizmetleri ekler ve potansiyel olarak yapılandırır. Uygulamaların bu kuralı izlemesini öneririz. Resmi bir Microsoft paketi yazmadığınız sürece uzantı yöntemlerini Microsoft.Extensions.DependencyInjection ad alanına yerleştirmeyin. Microsoft.Extensions.DependencyInjection ad alanında tanımlanan uzantı yöntemleri:

Daha fazla yönerge gerektirmeden using görüntülenir.
Bu uzantı yöntemlerinin genellikle çağrıldığı using veya Program sınıflarındaki gerekli Startup yönergelerinin sayısını azaltın.

Uygulama:

IHostApplicationBuilder bir örnek oluşturur.
Hizmetleri yapılandırır ve bunları karşılık gelen hizmet yaşam döngüsüyle ekler.
Build() çağırır ve bir IHost örneği atar.
ExemplifyServiceLifetime öğesini geçirerek IHost.Services çağrısını yapar.

Sonuç

Bu örnek uygulamada, çeşitli arabirimler ve buna karşılık gelen uygulamalar oluşturdunuz. Bu hizmetlerin her biri benzersiz olarak tanımlanır ve bir ServiceLifetimeile eşleştirilir. Örnek uygulama, hizmet uygulamalarını bir arabirime kaydetmeyi ve arabirimleri yedeklemeden saf sınıfları kaydetmeyi gösterir. Örnek uygulama daha sonra oluşturucu parametreleri olarak tanımlanan bağımlılıkların çalışma zamanında nasıl çözüldüğünü gösterir.

Uygulamayı çalıştırdığınızda, aşağıdakine benzer bir çıkış görüntüler:

// Sample output:
// Lifetime 1: Call 1 to provider.GetRequiredService<ServiceLifetimeReporter>()
//     IExampleTransientService: d08a27fa-87d2-4a06-98d7-2773af886125 (Always different)
//     IExampleScopedService: 402c83c9-b4ed-4be1-b78c-86be1b1d908d (Changes only with lifetime)
//     IExampleSingletonService: a61f1ff4-0b14-4508-bd41-21d852484a7b (Always the same)
// ...
// Lifetime 1: Call 2 to provider.GetRequiredService<ServiceLifetimeReporter>()
//     IExampleTransientService: b43d68fb-2c7b-4a9b-8f02-fc507c164326 (Always different)
//     IExampleScopedService: 402c83c9-b4ed-4be1-b78c-86be1b1d908d (Changes only with lifetime)
//     IExampleSingletonService: a61f1ff4-0b14-4508-bd41-21d852484a7b (Always the same)
// 
// Lifetime 2: Call 1 to provider.GetRequiredService<ServiceLifetimeReporter>()
//     IExampleTransientService: f3856b59-ab3f-4bbd-876f-7bab0013d392 (Always different)
//     IExampleScopedService: bba80089-1157-4041-936d-e96d81dd9d1c (Changes only with lifetime)
//     IExampleSingletonService: a61f1ff4-0b14-4508-bd41-21d852484a7b (Always the same)
// ...
// Lifetime 2: Call 2 to provider.GetRequiredService<ServiceLifetimeReporter>()
//     IExampleTransientService: a8015c6a-08cd-4799-9ec3-2f2af9cbbfd2 (Always different)
//     IExampleScopedService: bba80089-1157-4041-936d-e96d81dd9d1c (Changes only with lifetime)
//     IExampleSingletonService: a61f1ff4-0b14-4508-bd41-21d852484a7b (Always the same)

Uygulama çıkışında şunları görebilirsiniz:

Transient hizmetleri her zaman farklıdır. Hizmetin her alımıyla yeni bir örnek oluşturulur.
Scoped hizmetler yalnızca yeni bir kapsamla değişir, ancak aynı kapsam içinde aynı örnek olarak kalırlar.
Singleton hizmetleri her zaman aynıdır. Yeni örnek yalnızca bir kez oluşturulur.

Ayrıca bakınız

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-01-24