Dotnet-11 | The .NET Blog

.NET MAUI Maps'e Nihayet Pin Kümeleme Geldi — Tek Özellik, Sıfır Acı

Emiliano Montesdeoca — Thu, 16 Apr 2026 00:00:00 +0000

Bu yazı otomatik olarak çevrilmiştir. Orijinal için buraya tıklayın.

Yüz pin’li bir harita yüklediğinizde ve her şeyin okunaksız bir kümreye dönüştüğü o anı bilirsiniz, değil mi? Evet, .NET MAUI Maps deneyimi şimdiye kadar tam olarak buydu. Artık değil.

David Ortinau, .NET MAUI 11 Preview 3’ün Android ve iOS/Mac Catalyst üzerinde kutudan çıkar çıkmaz pin kümeleme sunduğunu duyurdu. Ve en iyi kısım — etkinleştirmek gülünç derecede basit.

Hepsini Yöneten Tek Özellik

<maps:Map IsClusteringEnabled="True" />

Hepsi bu kadar. Yakın pinler, sayı rozeti olan kümeler halinde gruplanır. Yakınlaştırın ve genişlerler. Uzaklaştırın ve daralırlar. Kullanıcıların modern bir haritadan beklediği türden davranış — ve artık tek bir özellikle elde ediyorsunuz.

Bağımsız Kümeleme Grupları

İşte ilginçleştiği yer burası. Tüm pinler birlikte kümelenmemelidir. Kahve dükkanları ve parklar farklı şeylerdir ve haritanız bunu bilmelidir.

ClusteringIdentifier özelliği, pinleri bağımsız gruplara ayırmanızı sağlar:

map.Pins.Add(new Pin
{
 Label = "Pike Place Coffee",
 Location = new Location(47.6097, -122.3331),
 ClusteringIdentifier = "coffee"
});

map.Pins.Add(new Pin
{
 Label = "Occidental Square",
 Location = new Location(47.6064, -122.3325),
 ClusteringIdentifier = "parks"
});

Aynı tanımlayıcıya sahip pinler birlikte kümelenir. Farklı tanımlayıcılar, coğrafi olarak yakın olsalar bile bağımsız kümeler oluşturur. Tanımlayıcı yok mu? Varsayılan grup. Temiz ve öngörülebilir.

Küme Tap’larını Yönetme

Bir kullanıcı kümeye dokunduğunda, ihtiyacınız olan her şeyle birlikte bir ClusterClicked olayı alırsınız:

map.ClusterClicked += async (sender, e) =>
{
 string names = string.Join("\n", e.Pins.Select(p => p.Label));
 await DisplayAlert(
 $"Cluster ({e.Pins.Count} pins)",
 names,
 "OK");

 // Varsayılan kümeye-yakınlaştırma davranışını bastır:
 // e.Handled = true;
};

Olay argümanları size Pins (kümedeki pinler), Location (coğrafi merkez) ve Handled (varsayılanı geçersiz kılmak istiyorsanız true olarak ayarlayın) sunar. Basit, pratik, tam olarak beklediğiniz şey.

Bilmeye Değer Platform Ayrıntıları

Android’de kümeleme, zoom değişikliklerinde yeniden hesaplanan özel ızgara tabanlı bir algoritma kullanır — harici bağımlılık yok. iOS ve Mac Catalyst’te, sorunsuz, platform-native animasyonlar anlamına gelen MapKit’ten yerel MKClusterAnnotation desteğinden yararlanır.

Bu, MAUI ekibinin doğru kararı verdiği durumlardan biri — mantıklı olduğunda platforma güvenmek.

Neden Önemli?

Pin kümeleme, .NET MAUI’de en çok talep edilen özelliklerden biri olmuştur (issue #11811), ve bunun iyi bir nedeni var. Haritada konumları gösteren her uygulama — teslimat takibi, mağaza bulucu, gayrimenkul — buna ihtiyaç duyar. Daha önce bunu kendiniz oluşturmanız veya üçüncü taraf bir kütüphane getirmeniz gerekiyordu. Artık yerleşik.

Cross-platform mobil uygulamalar geliştiren .NET geliştiricileri için bu, MAUI’yi harita yoğun senaryolar için gerçekten pratik bir tercih haline getiren türden bir yaşam kalitesi iyileştirmesi.

Başlarken

.NET 11 Preview 3‘ü kurun ve .NET MAUI iş yükünü güncelleyin. Maps örneği, hemen oynayabileceğiniz yeni bir Clustering sayfası içeriyor.

Gidin ve onunla bir şeyler oluşturun — haritalarınızın nihayet nefes almasına izin verin.

C# 15 Union Türlerini Alıyor — ve Bunlar Tam İstediğimiz Şey

Emiliano Montesdeoca — Sun, 05 Apr 2026 00:00:00 +0000

Bu yazı otomatik olarak çevrilmiştir. Orijinal için buraya tıklayın.

Bunu bekliyordum. C# 15, union anahtar sözcüğünü tanıtıyor — derleyici tarafından zorunlu kılınan kapsamlı desen eşleştirmeli gerçek discriminated union’lar. F#‘ın discriminated union’larını ya da Rust’ın enum’larını hiç kıskandıysanız, bunun neden önemli olduğunu tam olarak biliyorsunuzdur.

Bill Wagner, .NET bloğunda konunun derinlemesine incelemesini yayımladı ve dürüst olmak gerekirse? Tasarım temiz, pratik ve son derece C# ruhuyla örtüşüyor. Gerçekte ne olduğunu ve neden ilk bakışta göründüğünden daha büyük bir mesele olduğunu size anlatayım.

Union türlerinin çözdüğü sorun

C# 15 öncesinde, bir metottan “birkaç olası türden biri” döndürmek her zaman bir uzlaşıydı:

object — kısıtlama yok, derleyici yardımı yok, her yerde savunmacı casting
İşaretçi arayüzler — daha iyi, ama herkes bunları uygulayabilir. Derleyici kümenin tamamlanmış olduğunu asla kabul edemez
Soyut taban sınıflar — aynı sorun, üstelik türlerin ortak bir atası olması gerekiyor

Bunların hiçbiri gerçekte istediğinizi vermiyor: derleyicinin her durumu ele aldığınızı garanti ettiği kapalı bir tür kümesi. Union türlerinin yaptığı tam olarak bu.

Sözdizimi güzelce basit

public record class Cat(string Name);
public record class Dog(string Name);
public record class Bird(string Name);

public union Pet(Cat, Dog, Bird);

Tek satır. Pet, bir Cat, bir Dog veya bir Bird tutabilir. Örtülü dönüşümler otomatik olarak oluşturulur:

Pet pet = new Dog("Rex");
Console.WriteLine(pet.Value); // Dog { Name = Rex }

Ve işte sihir — derleyici kapsamlı eşleştirmeyi zorunlu kılıyor:

string name = pet switch
{
 Dog d => d.Name,
 Cat c => c.Name,
 Bird b => b.Name,
};

_ atma ifadesi gerekmiyor. Derleyici bu switch’in olası her durumu kapsadığını biliyor. Daha sonra union’a dördüncü bir tür eklerseniz, bunu ele almayan her switch ifadesi bir uyarı üretiyor. Eksik durumlar çalışma zamanında değil, derleme zamanında yakalanıyor.

Bu pratikte ne anlama geliyor

Pet örneği şirin, ama işte union’ların gerçek kodda asıl parladığı yer burası.

Farklı şekiller döndüren API yanıtları

public union ApiResult<T>(T, ApiError, ValidationFailure);

Artık her tüketici başarı, hata ve doğrulama başarısızlığını ele almak zorunda. “Hata durumunu kontrol etmeyi unuttum” hataları artık yok.

Tek değer veya koleksiyon

OneOrMore<T> deseni, union’ların yardımcı metotlarla nasıl bir gövdeye sahip olabileceğini gösteriyor:

public union OneOrMore<T>(T, IEnumerable<T>)
{
 public IEnumerable<T> AsEnumerable() => Value switch
 {
 T single => [single],
 IEnumerable<T> multiple => multiple,
 null => []
 };
}

Çağıranlar hangi form uygunsa onu kullanıyor:

OneOrMore<string> tags = "dotnet";
OneOrMore<string> moreTags = new[] { "csharp", "unions", "preview" };

foreach (var tag in tags.AsEnumerable())
 Console.Write($"[{tag}] ");
// [dotnet]

İlgisiz türleri birleştirme

Bu, geleneksel hiyerarşiler üzerindeki öldürücü özelliktir. Ortak atası olmayan türleri — string ve Exception, int ve IEnumerable<T> — union’layabilirsiniz.

Mevcut kütüphaneler için özel union’lar

İşte akıllı bir tasarım seçimi: [Union] özniteliğine sahip herhangi bir sınıf veya struct, temel deseni izlediği sürece (durum türleri için public constructor’lar ve bir Value özelliği) bir union türü olarak tanınır. OneOf gibi union benzeri türler zaten sağlayan kütüphaneler, iç yapılarını yeniden yazmadan derleyici desteğini benimseyebilir.

Değer türleriyle performans açısından kritik senaryolar için kütüphaneler, HasValue ve TryGetValue metotlarıyla boxing yapmayan erişim deseni uygulayabilir.

Büyük resim

Union türleri, C#‘a gelen daha kapsamlı bir bütünlük hikayesinin parçası:

Union türleri — kapalı bir tür kümesi üzerinde kapsamlı eşleştirme (şu an önizlemede mevcut)
Kapalı hiyerarşiler — closed değiştiricisi, tanımlayan derleme dışında türetilmiş sınıfları engelliyor (önerildi)
Kapalı enum’lar — bildirilmiş üyeler dışında değer oluşturulmasını engelliyor (önerildi)

Bu üç özellik birlikte, C#‘a herhangi bir ana akım dilde en kapsamlı tür güvenli desen eşleştirme sistemlerinden birini kazandıracak.

Bugün deneyin

Union türleri .NET 11 Preview 2’de mevcut:

.NET 11 Preview SDK‘yi yükleyin
Projenizde net11.0 hedefleyin
<LangVersion>preview</LangVersion> ayarlayın

Bir uyarı: Preview 2’de, henüz çalışma zamanında bulunmadıkları için UnionAttribute ve IUnion‘ı projenizde bildirmeniz gerekecek. Docs reposundan RuntimePolyfill.cs dosyasını alın veya şunu ekleyin:

namespace System.Runtime.CompilerServices
{
 [AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct,
 AllowMultiple = false)]
 public sealed class UnionAttribute : Attribute;

 public interface IUnion
 {
 object? Value { get; }
 }
}

Sonuç

Union türleri, nasıl bu olmadan idare ettiğimizi merak ettiren özelliklerden biri. Derleyici tarafından zorunlu kılınan kapsamlı eşleştirme, temiz sözdizimi, generic desteği ve mevcut desen eşleştirmeyle entegrasyon — C# yolunda yapılmış, istediğimiz her şey bu.

.NET 11 Preview 2’de deneyin, şeyleri kırın ve GitHub’da geri bildiriminizi paylaşın. Bu önizleme aşamasında ve C# ekibi aktif olarak dinliyor. Uç durumlarınız ve tasarım geri bildiriminiz nihai sürümü şekillendirecek.

Tam dil referansı için union türleri belgelerine ve özellik spesifikasyonuna bakın.