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

2025-04-14

Bu öğreticide .NET'da bağımlılık eklemenin (DI) nasıl kullanılacağı gösterilmektedir. Microsoft Uzantıları ile DI, hizmetleri ekleyip içinde yapılandırarak yönetilir. IHost arabirimi, tüm kayıtlı hizmetlerin kapsayıcısı işlevi gören IServiceProvider örneğini kullanıma sunar.

Bu öğreticide şunların nasıl yapılacağını öğreneceksiniz:

Bağımlılık ekleme kullanan bir .NET konsol uygulaması oluşturma
Build and configure a Generic Host
Çeşitli arabirimler ve karşılık gelen uygulamalar yazma
Use service lifetime and scoping for DI

Önkoşullar

.NET Core 3.1 SDK or later.
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>net8.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>true</ImplicitUsings>
    <RootNamespace>ConsoleDI.Example</RootNamespace>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.Extensions.Configuration.Binder" Version="9.0.6" />
    <PackageReference Include="Microsoft.Extensions.Hosting" Version="9.0.6" />
  </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şturacaksınız. 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. Furthermore, since each type will not be extended, it's marked as sealed. Ö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. When invoked, the ReportServiceLifetimeDetails method logs each service's unique identifier with the service lifetime message. Günlük iletileri hizmet ömrünü görselleştirmeye yardımcı olur.

Register services for DI

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:

Are displayed in IntelliSense without requiring additional using directives.
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:

Creates an IHostBuilder instance with host builder settings.
Configures services and adds them with their corresponding service lifetime.
Build() çağırır ve bir IHost örneği atar.
Calls ExemplifyScoping, passing in the IHost.Services.

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 services are always different, a new instance is created with every retrieval of the service.
Scoped services change only with a new scope, but are the same instance within a scope.
Singleton hizmetler her zaman aynıdır, yeni bir örnek yalnızca bir kez oluşturulur.

Ayrıca bkz.

Bağımlılık enjeksiyonu yönergeleri
.NET'de bağımlılık eklemeyle ilgili temel bilgileri anlama
Dependency injection in ASP.NET Core