Dotnet-11 | The .NET Blog

تجميع الدبابيس يصل أخيراً إلى خرائط .NET MAUI — خاصية واحدة، لا ألم

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

تمت ترجمة هذا المقال تلقائياً. للنسخة الأصلية، انقر هنا.

تعرف تلك اللحظة حين تحمّل خريطة بمئة دبوس ويتحول كل شيء إلى كتلة غير قابلة للقراءة؟ نعم، هذا كان تجربة .NET MAUI Maps — حتى الآن. لا مزيد من ذلك.

David Ortinau أعلن للتو أن .NET MAUI 11 Preview 3 يشحن تجميع الدبابيس جاهزاً للاستخدام على Android وiOS/Mac Catalyst. والجزء الأفضل — تفعيله سهل بشكل مدهش.

خاصية واحدة لحكمهم جميعاً

<maps:Map IsClusteringEnabled="True" />

هذا كل شيء. تُجمَّع الدبابيس القريبة في مجموعات مع شارة العدد. قرّب الخريطة وتتمدد. ابتعد وتنضمّ. هذا النوع من السلوك الذي يتوقعه المستخدمون من أي خريطة حديثة — والآن تحصل عليه بخاصية واحدة.

مجموعات تجميع مستقلة

هنا تصبح الأمور مثيرة للاهتمام. ليس كل الدبابيس يجب أن تتجمع معاً. المقاهي والحدائق أشياء مختلفة، ويجب أن تعرف خريطتك ذلك.

خاصية ClusteringIdentifier تتيح لك فصل الدبابيس إلى مجموعات مستقلة:

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"
});

الدبابيس ذات المعرّف نفسه تتجمع معاً. المعرّفات المختلفة تُشكّل مجموعات مستقلة حتى عند التقارب الجغرافي. لا معرّف؟ المجموعة الافتراضية. واضح ومتوقع.

معالجة النقر على المجموعة

حين ينقر مستخدم على مجموعة، تحصل على حدث ClusterClicked بكل ما تحتاجه:

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");

 // Suppress default zoom-to-cluster behavior:
 // e.Handled = true;
};

تمنحك وسيطات الحدث Pins (الدبابيس في المجموعة)، وLocation (المركز الجغرافي)، وHandled (اضبطها على true إذا أردت تجاوز التكبير الافتراضي). بسيط، عملي، تماماً ما تتوقعه.

تفاصيل المنصة تستحق المعرفة

على Android، يستخدم التجميع خوارزمية شبكية مخصصة تُعيد الحساب عند تغيّر مستوى التكبير — دون تبعيات خارجية. على iOS وMac Catalyst، يستفيد من دعم MKClusterAnnotation الأصيل في MapKit، مما يعني حركات انتقال سلسة وأصيلة للمنصة.

هذه إحدى الحالات التي اتخذ فيها فريق MAUI القرار الصحيح — الاتكاء على المنصة حيث يكون ذلك منطقياً.

لماذا يهمّ هذا

تجميع الدبابيس كان أحد أكثر الميزات المطلوبة في .NET MAUI (المشكلة #11811)، ولسبب وجيه. كل تطبيق يعرض مواقع على خريطة — تتبع التوصيل، ومحدّدات المتاجر، والعقارات — يحتاج إلى هذا. سابقاً كان عليك بناؤه بنفسك أو استيراد مكتبة من جهة خارجية. الآن هو مدمج.

لنا نحن مطوّري .NET الذين نبني تطبيقات جوالة متعددة المنصات، هذا هو نوع تحسينات جودة الحياة الذي يجعل MAUI خياراً عملياً حقيقياً للسيناريوهات المكثفة باستخدام الخرائط.

ابدأ الآن

ثبّت .NET 11 Preview 3 وحدّث حمل عمل .NET MAUI. نموذج Maps يتضمن صفحة Clustering جديدة يمكنك تجربتها مباشرةً.

ابنِ شيئاً به — واترح خرائطك أخيراً.

C# 15 يحصل على أنواع الاتحاد — وهي بالضبط ما كنا نطلبه

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

تمت ترجمة هذا المقال تلقائياً. للنسخة الأصلية، انقر هنا.

هذه هي الميزة التي كنت أنتظرها. يُقدّم C# 15 الكلمة المفتاحية union — أنواع اتحاد مُميَّزة حقيقية مع مطابقة أنماط شاملة يُطبّقها المُحوِّل. إذا سبق لك أن حسدت F# على أنواع اتحادها المُميَّزة أو Rust على تعداداته، فأنت تعرف تمامًا لماذا يهم هذا.

نشر Bill Wagner التعمق الكامل على مدونة .NET، وصراحةً؟ التصميم نظيف وعملي ويتماشى تمامًا مع أسلوب C#. دعني أقودك عبر ما هو موجود فعليًا ولماذا هو أمر أكبر مما قد يبدو للوهلة الأولى.

المشكلة التي تحلها أنواع الاتحاد

قبل C# 15، كانت إعادة “أحد الأنواع الممكنة المتعددة” من دالة دائمًا تنازلًا:

object — لا قيود، لا مساعدة من المُحوِّل، تحويل دفاعي في كل مكان
واجهات التمييز — أفضل، لكن يمكن لأي شخص تنفيذها. لا يمكن للمُحوِّل أبدًا اعتبار المجموعة مكتملة
الفئات الأساسية المجردة — نفس المشكلة، بالإضافة إلى أن الأنواع تحتاج إلى سلف مشترك

لا شيء من هذه يمنحك ما تريده فعلًا: مجموعة مغلقة من الأنواع حيث يضمن المُحوِّل أنك تعاملت مع كل حالة. هذا ما تفعله أنواع الاتحاد.

الصيغة بسيطة بشكل جميل

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

public union Pet(Cat, Dog, Bird);

سطر واحد. يمكن لـ Pet أن يحمل Cat أو Dog أو Bird. تُولَّد التحويلات الضمنية تلقائيًا:

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

وهنا يكمن السحر — يُطبّق المُحوِّل المطابقة الشاملة:

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

لا حاجة لـ _ للتجاهل. يعلم المُحوِّل أن هذا التعبير يغطي كل حالة ممكنة. إذا أضفت لاحقًا نوعًا رابعًا إلى الاتحاد، فكل تعبير switch لا يتعامل معه يُنتج تحذيرًا. الحالات المفقودة تُكتشف في وقت البناء لا في وقت التشغيل.

أين يُصبح هذا عمليًا

مثال Pet لطيف، لكن إليك أين تتألق الاتحادات فعلًا في الكود الحقيقي.

استجابات API التي تُعيد أشكالًا مختلفة

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

الآن كل مستهلك مُجبر على التعامل مع النجاح والخطأ وفشل التحقق. لا مزيد من أخطاء “نسيت التحقق من حالة الخطأ”.

قيمة واحدة أو مجموعة

يُظهر نمط OneOrMore<T> كيف يمكن لاتحادات أن تحتوي على جسم مع دوال مساعدة:

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

المستدعون يمررون الشكل الذي يناسبهم:

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

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

تكوين أنواع غير مترابطة

هذه هي الميزة القاتلة على التسلسلات الهرمية التقليدية. يمكنك توحيد أنواع ليس بينها أي قاسم مشترك — string وException، int وIEnumerable<T>. لا حاجة لسلف مشترك.

اتحادات مخصصة للمكتبات الموجودة

إليك خيار تصميمي ذكي: أي فئة أو بنية بسمة [Union] تُعترف بها كنوع اتحاد، طالما تتبع النمط الأساسي (مُنشئات عامة لأنواع الحالة وخاصية Value). المكتبات مثل OneOf التي تُقدم بالفعل أنواعًا شبيهة بالاتحاد يمكنها الاشتراك في دعم المُحوِّل دون إعادة كتابة بنيتها الداخلية.

بالنسبة للسيناريوهات الحساسة للأداء مع أنواع القيمة، يمكن للمكتبات تنفيذ نمط وصول غير ملاكم مع دوال HasValue وTryGetValue.

الصورة الأكبر

أنواع الاتحاد هي جزء من قصة شمولية أوسع قادمة إلى C#:

أنواع الاتحاد — مطابقة شاملة على مجموعة مغلقة من الأنواع (متاحة الآن في المعاينة)
التسلسلات الهرمية المغلقة — المُعدِّل closed يمنع الفئات المشتقة خارج التجميع المُعرِّف (مقترح)
التعدادات المغلقة — تمنع إنشاء قيم بخلاف الأعضاء المُعلَّن عنهم (مقترح)

معًا، ستمنح هذه الميزات الثلاث C# أحد أنظمة مطابقة الأنماط الآمنة للنوع الأكثر شمولًا في أي لغة رئيسية.

جرّبها اليوم

أنواع الاتحاد متاحة في .NET 11 Preview 2:

ثبّت .NET 11 Preview SDK
استهدف net11.0 في مشروعك
اضبط <LangVersion>preview</LangVersion>

تحفظ واحد: في Preview 2، ستحتاج إلى تعريف UnionAttribute وIUnion في مشروعك لأنهما ليسا في وقت التشغيل بعد. احصل على RuntimePolyfill.cs من مستودع المستندات، أو أضف هذا:

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

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

خلاصة

أنواع الاتحاد هي إحدى تلك الميزات التي تجعلك تتساءل كيف اجتزنا بدونها. مطابقة شاملة يُطبّقها المُحوِّل، وصيغة نظيفة، ودعم للأنماط العامة، وتكامل مع مطابقة الأنماط الموجودة — إنها كل ما كنا نطلبه، منجزًا بأسلوب C#.

جرّبها في .NET 11 Preview 2، اختبر حدودها، وشارك ملاحظاتك على GitHub. هذه نسخة معاينة، وفريق C# يستمع بنشاط. حالاتك الحدية وملاحظاتك التصميمية ستشكّل الإصدار النهائي.

للمرجع الكامل للغة، راجع مستندات أنواع الاتحاد ومواصفات الميزة.