berzahx 1
berzahx
aslan6474 1
aslan6474
Reklam vermek için turkmmo@gmail.com

C# Dilinde Namespace Kullanımı ve using Yönergeleri: Alias, using static ve global using

  • Konuyu başlatan Konuyu başlatan Agora Metin2
  • Başlangıç tarihi Başlangıç tarihi
  • Cevaplar Cevaplar 0
  • Görüntüleme Görüntüleme 19
image247fbc2075bc98a7.jpg


.NET ekosistemindeki her tipin; namespace ve tip isminden oluşan tam bir tanımlayıcısı bulunur. Örneğin: System.Console, System.Collections.Generic.List<T> veya System.Text.StringBuilder. Namespace'ler, birbiriyle ilişkili tipleri gruplandırarak isim çakışmalarını önler; bu sayede kendi oluşturduğunuz Order veya Timer sınıfları, kütüphanelerdeki aynı isimli sınıflarla karışmadan bir arada var olabilir. Dosyaların en başında yer alan using yönergeleri, ilgili namespace'leri projeye dahil ederek tiplerin kısa adlarıyla çağrılmasını sağlar.

C#:
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ı:

Kod:
Cart: tea, honey
1

using yönergeleri yalnızca derleme sürecini etkiler. Herhangi bir kütüphane yüklemesi yapmaz veya programa ek kod eklemez. Hangi kütüphanelerin kullanılabilir olduğu, projenin referansları ve NuGet paketleri tarafından belirlenir. Eğer derleyici bir tipin veya namespace'in bulunamadığını belirten "could not be found (are you missing a using directive or an assembly reference?)" hatasını (CS0246) verirse, bu durum ya gerekli using satırının eksik olduğunu ya da ilgili paketin referans olarak eklenmediğini gösterir.

Kendi Namespace'lerinizi Tanımlama

Tiplerinizi bir namespace bloğu içerisinde tanımlayabilirsiniz. Namespace'ler iç içe geçebilir, noktalarla ayrılmış hiyerarşik yapıda yazılabilir ve tek bir namespace birden fazla dosyaya yayılabilir.

C#:
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ı:

Kod:
120.00 via DHL
Shop.Billing.Invoice

namespace Shop.Billing { } ifadesi, aslında namespace Shop { namespace Billing { } } yazımının kısaltılmış halidir. Shop namespace'i içindeki kodlar, Billing.Invoice tipine erişirken Shop. önekini kullanmak zorunda değildir; çünkü isimler öncelikle kapsayıcı namespace'ler içinde aranır.

Genel isimlendirme gelenekleri şöyledir: Tanımlamaya şirket veya ürün adıyla başlayın (Contoso.Payments), ardından özellik veya katman ismini ekleyin ve bunu klasör yapısıyla uyumlu hale getirin (Contoso.Payments/Refunds/RefundService.cs dosyası Contoso.Payments.Refunds namespace'ini içermelidir). Ayrıca, bir sınıfa asla bağlı olduğu namespace ile aynı ismi vermeyin (Shop.Shop); bu durum, her kullanımda tam ad belirtmenizi zorunlu kılar.

Alias (Takma Adlar)

using Name = Namespace.Type; söz dizimi, belirli bir tipe veya namespace'e yerel bir takma ad atamanıza olanak tanır. Bu yöntem özellikle iki durumda kullanılır: Karmaşık generic tipleri kısaltmak ve isim çakışmalarını gidermek.

C#:
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ı:

Kod:
latte: 3.60
order 17

Alias tanımlamaları, global olarak belirtilmedikleri sürece sadece tanımlandıkları dosya içerisinde geçerlidir. C# 12 ve sonrası versiyonlarda; diziler ve tuple'lar da dahil olmak üzere her türlü tip için alias tanımlanabilmektedir: using Point = (int X, int Y);.

Belirsiz Referanslar (CS0104)

Eğer içe aktarılan iki farklı namespace aynı isimde bir tip içeriyorsa, kısa ad kullanmak bir hataya yol açar. Bunun en yaygın örneği; System.Threading, System.Timers ve (masaüstü uygulamalarında) System.Windows.Forms altında bulunan Timer sınıfıdır:

C#:
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'

Bu durumu çözmek için en özelden en genele doğru şu üç yöntem izlenebilir:
• Tam nitelikli adı yazmak (new System.Timers.Timer(1000))
• Hangi tipin kastedildiğini belirten bir alias eklemek
• İhtiyaç duyulmayan using yönergesini kaldırmak

C#:
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ı:

Kod:
250
System.Timers.Timer
System.Threading.Timer

Eğer kendi oluşturduğunuz bir namespace'de System veya Console adında bir tip tanımladıysanız, global:: öneki ile aramayı en kök dizinden başlatabilirsiniz: global::System.Console.WriteLine("hi");. Otomatik üretilen kodlar genellikle bu yöntemi kullanır.

using static Kullanımı

using static yönergesi, belirli bir tipin statik üyelerini içe aktararak, bu üyelerin tip adı belirtilmeden doğrudan çağrılmasını sağlar. Bu özellik, Math sınıfı gibi sürekli aynı sınıftan statik metodların çağrıldığı kodlar için oldukça uygundur:

C#:
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ı:

Kod:
Area: 28.27
Hypotenuse: 5
42

using static aynı zamanda enum'larla (using static System.DayOfWeek; sayesinde doğrudan Monday yazılabilir) ve kendi oluşturduğunuz statik sınıflarla da çalışır. Ancak, okunabilirliği bozmamak adına sadece isim belirsizliği yaratmayacağı yerlerde kullanılması önerilir; büyük bir dosyada tek başına WriteLine ifadesi, hangi sınıfın kastedildiğinin anlaşılmasını zorlaştırabilir.

global using ve Dosya Kapsamlı Namespace'ler (C# 10)

C# 10 ile gelen iki özellik, dosyaların başındaki tekrarlayan kalıp kodları azaltmıştır. Global using, projedeki her dosyaya otomatik olarak uygulanır ve genellikle GlobalUsings.cs gibi tek bir dosyada toplanır:

C#:
// 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 projelerinde bu işlem otomatikleştirilebilir. .csproj dosyasında <ImplicitUsings>enable</ImplicitUsings> seçeneği aktifse (yeni şablonlarda varsayılandır), bir konsol projesi otomatik olarak System, System.Collections.Generic, System.IO, System.Linq, System.Net.Http, System.Threading ve System.Threading.Tasks namespace'lerini dahil eder; web projeleri ise buna ek olarak ASP.NET Core namespace'lerini alır. Modern Program.cs dosyalarının doğrudan kodla başlamasının nedeni budur.

Dosya kapsamlı namespace'ler ise, tüm dosyanın tek bir namespace'e ait olduğunu blok kullanmadan, noktalı virgül ile bildirir ve böylece kodda bir girinti seviyesi tasarrufu sağlar:

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

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

Bir dosyada yalnızca bir tane dosya kapsamlı namespace tanımlanabilir ve aynı dosya içerisinde blok tipi namespace'lerle karıştırılamaz. Eski projeler, .NET Framework kodları ve Unity betikleri halen yukarıda gösterilen blok yapısını kullanmaktadır.

using Yönergelerinin Konumu ve using İfadesi

using yönergeleri, dosyadaki tüm namespace ve tip tanımlamalarından önce yazılmalıdır (global using'ler her şeyden önce gelir). Bu yönergeler bir namespace bloğunun içine de yazılabilir; bu durumda sadece o blok içerisinde geçerli olurlar. Stil kılavuzları farklılık gösterse de çoğu .NET kodu bunları en üstte tutar.

using anahtar kelimesinin metotlar içerisinde kullanılan farklı bir işlevi daha vardır: using ifadesi using (var file = File.OpenRead(path)) { ... } şeklinde kullanılır ve blok sona erdiğinde nesnenin Dispose metodunu otomatik olarak çağırarak dosya ve bağlantı gibi kaynakların kapatılmasını sağlar. Bu kullanım, yukarıdaki yönergelerle aynı anahtar kelimeyi paylaşsa da tamamen farklı bir amaca hizmet eder.
 

Şu an konuyu görüntüleyenler (Toplam : 0, Üye: 0, Misafir: 0)

Geri
Üst