C# using Yönergesi ve Namespace'ler: Alias, using static, global using

.NET'teki her tipin bir namespace ve tip adından oluşan tam bir adı vardır: System.Console, System.Collections.Generic.List<T>, System.Text.StringBuilder. Namespace'ler ilişkili tipleri gruplar ve adların çakışmasını önler; böylece kendi Order ya da Timer sınıfınız kütüphanelerdekilerle bir arada var olabilir. Bir dosyanın en üstündeki using yönergesi bir namespace'i içe aktarır, böylece kısa adları kullanabilirsiniz.

using System;
using System.Collections.Generic;
using System.Text;

class Program
{
    static void Main()
    {
        // With the using directives:
        var cart = new List<string> { "tea", "honey" };
        var sb = new StringBuilder();
        sb.Append("Cart: ").Append(string.Join(", ", cart));
        Console.WriteLine(sb.ToString());

        // The same thing with fully qualified names, no directives needed:
        var cart2 = new System.Collections.Generic.List<string> { "milk" };
        System.Console.WriteLine(cart2.Count);
    }
}

Çıktı:

Cart: tea, honey
1

Bir using yönergesi adları yalnızca derleme zamanında etkiler. Bir kütüphane yüklemez ya da programa kod eklemez; hangi kütüphanelerin kullanılabilir olduğuna projenin referansları ve NuGet paketleri karar verir. Derleyici bir tipin ya da namespace'in "could not be found (are you missing a using directive or an assembly reference?)" olduğunu bildirirse (CS0246 hatası), ya using satırı eksiktir ya da pakete referans verilmemiştir.

Kendi namespace'lerinizi bildirmek

Tipleri bir namespace bloğunun içine koyun. Namespace'ler iç içe olabilir, noktalarla yazılabilir ve aynı namespace birçok dosyaya yayılabilir.

using System;

namespace Shop.Billing
{
    class Invoice
    {
        public decimal Amount = 120.00m;
    }
}

namespace Shop.Shipping
{
    class Invoice   // same name, different namespace: no clash
    {
        public string Carrier = "DHL";
    }
}

namespace Shop
{
    class Program
    {
        static void Main()
        {
            var bill = new Billing.Invoice();        // relative to Shop
            var label = new Shop.Shipping.Invoice(); // full name
            Console.WriteLine($"{bill.Amount:F2} via {label.Carrier}");
            Console.WriteLine(typeof(Billing.Invoice).FullName);
        }
    }
}

Çıktı:

120.00 via DHL
Shop.Billing.Invoice

namespace Shop.Billing { }, namespace Shop { namespace Billing { } } yazımının kısaltmasıdır. Shop içindeki kod Shop. öneki olmadan Billing.Invoice'a başvurabilir, çünkü adlar önce çevreleyen namespace'lerde aranır.

Gelenekler: şirket ya da ürünle başlayın (Contoso.Payments), ardından özellik ya da katmanı yazın ve klasör yapısıyla eşleştirin (Contoso.Payments/Refunds/RefundService.cs, Contoso.Payments.Refunds'ı tutar). Bir sınıfa asla namespace'iyle aynı adı vermeyin (Shop.Shop); bu, her yerde zahmetli nitelemeye zorlar.

Alias'lar

using Name = Namespace.Type; bir tipe (ya da bir namespace'e) yerel bir ad verir. İki durumda gerekir: uzun bir generic tipi kısaltmak ve bir çakışmayı çözmek.

using System;
using System.Collections.Generic;
using PriceTable = System.Collections.Generic.Dictionary<string, decimal>;
using Col = System.Collections.Generic;

class Program
{
    static void Main()
    {
        var prices = new PriceTable
        {
            ["espresso"] = 2.40m,
            ["latte"] = 3.60m
        };
        Console.WriteLine($"latte: {prices["latte"]:F2}");

        var queue = new Col.Queue<string>();
        queue.Enqueue("order 17");
        Console.WriteLine(queue.Peek());
    }
}

Çıktı:

latte: 3.60
order 17

Alias'lar yalnızca bildirildikleri dosyada geçerlidir (aşağıdaki gibi global değillerse). C# 12 ve sonrasında bir alias tuple'lar ve diziler dahil her tipi adlandırabilir: using Point = (int X, int Y);.

Belirsiz referanslar (CS0104)

İçe aktarılan iki namespace aynı adda bir tip içerdiğinde kısa adı kullanmak bir hatadır. Klasik örnek System.Threading, System.Timers ve (masaüstü uygulamalarında) System.Windows.Forms içinde bulunan Timer'dır:

using System.Threading;
using System.Timers;

var t = new Timer(1000);
// error CS0104: 'Timer' is an ambiguous reference between
// 'System.Timers.Timer' and 'System.Threading.Timer'

En yerelden en az yerele üç çözüm: tam nitelikli adı yazın (new System.Timers.Timer(1000)), hangisini kastettiğinizi söyleyen bir alias ekleyin ya da ihtiyacınız olmayan yönergeyi kaldırın.

using System;
using System.Threading;
using System.Timers;
using Timer = System.Timers.Timer;   // "Timer" now means this one

class Program
{
    static void Main()
    {
        var timer = new Timer(250);
        Console.WriteLine(timer.Interval);
        Console.WriteLine(timer.GetType().FullName);

        // The other Timer is still reachable by its full name:
        Console.WriteLine(typeof(System.Threading.Timer).FullName);
        timer.Dispose();
    }
}

Çıktı:

250
System.Timers.Timer
System.Threading.Timer

Kendi namespace'iniz System ya da Console adında bir tip tanımlıyorsa, global:: öneki aramayı kökten başlatır: global::System.Console.WriteLine("hi");. Üretilen kod bu yüzden onu her yerde kullanır.

using static

using static tek bir tipin statik üyelerini içe aktarır, böylece tip adı olmadan çağrılabilirler. Math gibi aynı sınıfı tekrar tekrar çağıran koda uygundur:

using System;
using static System.Math;
using static System.Console;

class Program
{
    static void Main()
    {
        double radius = 3;
        double area = PI * Pow(radius, 2);
        WriteLine($"Area: {area:F2}");
        WriteLine($"Hypotenuse: {Sqrt(3 * 3 + 4 * 4)}");
        WriteLine(Max(17, 42));
    }
}

Çıktı:

Area: 28.27
Hypotenuse: 5
42

using static enum'larla (using static System.DayOfWeek; Monday yazmanızı sağlar) ve kendi statik sınıflarınızla da çalışır. Kısa adların belirsiz olmadığı yerlerde kullanın; büyük bir dosyada tek başına WriteLine okuyanları hangi yazıcının kastedildiğini merak ettirebilir.

global using ve dosya kapsamlı namespace'ler (C# 10)

İki C# 10 özelliği dosyaların başındaki kalıp kodu azaltır. Bir global using projedeki her dosyaya uygulanır ve genellikle GlobalUsings.cs gibi tek bir dosyada tutulur:

// GlobalUsings.cs, C# 10 and later
global using System;
global using System.Collections.Generic;
global using System.Linq;
global using Money = System.Decimal;

.NET 6 ve sonraki SDK projeleri bunları sizin için üretebilir. .csproj içinde <ImplicitUsings>enable</ImplicitUsings> ile (yeni şablonlarda varsayılan) bir konsol projesi System, System.Collections.Generic, System.IO, System.Linq, System.Net.Http, System.Threading ve System.Threading.Tasks alır; web projeleri ayrıca ASP.NET Core namespace'lerini de alır. Modern Program.cs dosyalarının doğrudan kodla başlamasının nedeni budur.

Bir dosya kapsamlı namespace, tüm dosyanın namespace'ini blok yerine noktalı virgülle bildirir ve bir girinti seviyesi kazandırır:

// C# 10 and later
namespace Shop.Billing;

public class Invoice
{
    public decimal Amount { get; set; }
}

Bir dosyada yalnızca bir dosya kapsamlı namespace olabilir ve aynı dosyada blok namespace'lerle karıştırılamaz. Eski projeler, Unity betikleri ve .NET Framework'ü hedefleyen kod yukarıda gösterilen blok biçimini kullanır.

using yönergeleri nereye yazılır ve using ifadesi

Using yönergeleri dosyadaki tüm namespace ve tip bildirimlerinden önce gelmelidir (global using'ler her şeyden önce). Bir namespace bloğunun içine de yazılabilirler; bu durumda yalnızca orada geçerli olurlar. Stil kılavuzları farklıdır ve çoğu .NET kodu onları en üstte tutar.

using anahtar kelimesinin metotların içinde ikinci, ilgisiz bir görevi vardır: using ifadesi using (var file = File.OpenRead(path)) { ... } blok bittiğinde nesnenin Dispose metodunu çağırarak dosyaları ve bağlantıları kapatır. Anahtar kelimeyi paylaşır, başka hiçbir şeyi değil. using ifadesi sayfasına bakın.