The document provides an introduction to attributes in .NET Framework. It discusses what attributes are, how they are used to provide additional metadata for types and assemblies. Specifically, it covers the AssemblyInfo.cs file, how to search for attributes using reflection, and examples of built-in attributes like ObsoleteAttribute and SerializableAttribute.

1. Introduction to .NET Framework
2- Attributes

2. Outlines
مقدمة إلى الصفات . 
. Assemblyinfo.cs الملف 
البحث عن الصفات . 
.NET الصفات المبيتة في 
. System.ObsoleteAttribute الصفة 
. System.SerializableAttribute الصفة 
05 2 تشرين الثاني، 14

3. مقدمة إلى الصفات
؟)Attribute( ما هي الصفة 
مبدئي ا سنعرف الصفة على أنها "معلومات إضافية يمكن تطبيقها على كتلة من
. ")EXE أو DLL( الشيفرة البرمجية ضمن المجمعة
أو Data Member أو Method أو Class يمكن أن تمثل هذه الكتل 
Property
أخر يستخدم هذه )Class( يمكن الوصول إلى هذه المعلومات من أي صنف 
المُجمعة.
Assemblyinfo.cs الملف 
. Pickling عملية تخزين الصفات ضمن المجمعة تسمى 
و والبارمترات التي نمررها هي بارامترات ال Class تصريح الصفة تمثل 
Constructor
05 3 تشرين الثاني، 14

4. Assemblyinfo.cs
using System.Reflection;
using System.Runtime.CompilerServices;
using System.Runtime.InteropServices;
// General Information about an assembly is controlled through the
following
// set of attributes. Change these attribute values to modify the
information
// associated with an assembly.
[assembly: AssemblyTitle("Training")]
[assembly: AssemblyDescription("")]
[assembly: AssemblyConfiguration("")]
[assembly: AssemblyCompany("")]
[assembly: AssemblyProduct("Training")]
[assembly: AssemblyCopyright("Copyright © 2010")]
[assembly: AssemblyTrademark("")]
[assembly: AssemblyCulture("")]
05 4 تشرين الثاني، 14

5. مقدمة إلى الصفات
يمكننا مشاهدة قيم الصفات من خلال خصائص المجمعة أو من خلال الإنعكاس . 
يمكننا الآن أن نعرّف الصفة على أنها : 
يمكن أن يحوي بيانات إضافية عن المجمعة , تتعلق Class "الصفة : عبارة عن
هذه المعلومات بالمجمعة نفسها أو بأي نوع ضمنها“ .
[assembly: AssemblyTitle("Training")]
هو مدى الصفة ويعني أن الصفة مطبقة على المجمعة نفسها. : Assembly 
05 5 تشرين الثاني، 14

6. البحث عن الصفات :
using System;
using System.Reflection;
static void Main(string[] args)
{
Assembly a = Assembly.LoadFrom(@"D:atom.dll");
object[] attributes = a.GetCustomAttributes(true);
foreach(object o in attributes)
{
Console.WriteLine(o.ToString());
}
}
05 6 تشرين الثاني، 14

7. ا
05 7 تشرين الثاني، 14

8. .NET الصفات المبيتة في
هي صفات Assemblyinfo.cs إن الصفات الموجودة في الملف 
خاصة بالمجمعة بحد ذاتها.
الصفات التي سنعرضها فهي تخص الأنواع المعرفة ضمنها وأحيانا 
المجمعة بحد ذاتها.
. System.ObsoleteAttribute الصفة 
. System.SerializableAttribute الصفة 
05 8 تشرين الثاني، 14

9. System.ObsoleteAttribute الصفة
هذه الصفة تستخدم لوسم تابع بأنه لم يعد مستخدما بعد الآن . 
خلال عملية التطوير سيكون بعض المناهج التي لن يكون لها وجود 
في الإصدارة النهائية من المكتبة – وبذلك يمكن تحضير مستخدمي
مكتبتك لغياب ميزة محددة )تابع مثلا (.
05 9 تشرين الثاني، 14

10. System.ObsoleteAttribute الصفة
[Obsolete("Use NewMethod instead")]
public void OldMethod()
{
}
public void NewMethod()
{
}
05 10 تشرين الثاني، 14

11. System.ObsoleteAttribute الصفة
عند ترجمة المشروع سنحصل على رسالة تحذير بأن هذا المنهج "مهجور 
بدلاُ NewMethod أو سُيهجر قريبا وعليك استخدام "deprecated
منه .
05 11 تشرين الثاني، 14

12. System.ObsoleteAttribute الصفة
مع الوقت فأن جميع مستخدمين هذا المنهج سيعلمون أن عليهم تجنب 
.deprecated استخدام هذا المنهج وحتى عند استدعائه يعطيك أن هذا المنهج
05 12 تشرين الثاني، 14

13. System.ObsoleteAttribute الصفة
من شيفرتك OldMethod ومع الوقت يمكنك أن تزيل المنهج 
Obsolete تماما دون خوف لذلك يمكنك إضافة بارمتر جديد للصفة
كما يلي:
[Obsolete("Use NewMethod instead",true)]
public void OldMethod()
{
}
05 13 تشرين الثاني، 14

14. System.ObsoleteAttribute الصفة
وعندما يحاول المستخدمون استخدام هذا المنهج فأن 
وتتوقف عملية الترجمة . Error المترجم سيصدر خطأ
05 14 تشرين الثاني، 14

15. System.SerializableAttribute الصفة
هو الاسم الذي يطلق على ترتيب )Serialization( السّلسَلة 
واستعادة الكائنات من الذاكرة أو من الأقراص بصورتها الثنائية .
عندما نقوم بسّلسَلة كائن فإن جميع بيانات الكائن تحُفظ ضمن وسط 
سيتم إعادة الكائن من )Deserialize( التخزين وعند إزالة السّلسَلة
وسط التخزين إلى حالته الأصلية.
05 15 تشرين الثاني، 14

16. System.SerializableAttribute الصفة
[Serializable]
class Employee
{
public Employee(int id ,string name)
{
_id = id;
_name = name;
}
private int _id;
private string _name;
[NonSerialized]
//this Data Member is not Serialized,Such asTransiet in JAVA
private string _password;
public int Id
{
get { return _id; }
set { _id = value; }
}
public string Name
{
get { return _name; }
set { _name = value; }
}
}
05 16 تشرين الثاني، 14

17. System.SerializableAttribute الصفة
م ملف نا Employee سن وم ا ن س لسلة ا
static void Main(string[] args)
{
Employee e = new Employee(1, "mohammad");
FileStream fs = null;
try
{
string path= @"D:file";
fs = new FileStream(path, FileMode.Create);
BinaryFormatter bf = new BinaryFormatter();
// Serialize Object(e) in the file stream(fs)
bf.Serialize(fs, e);
}
catch (Exception Ex)
{
Console.WriteLine(Ex.Message);
}
finally
{
try
{
fs.Close();
}
catch (Exception es)
{
Console.WriteLine(es.Message);
}
}
}
05 17 تشرين الثاني، 14

18. System.SerializableAttribute الصفة
فتتم كما يلي : DeSerailization أما إزالة السلسة
نكتب ما يلي : Main ضمن التابع
static void Main(string[] args)
{
Employee e1 = null;
try
{
string path = @"D:file";
fs = new FileStream(path, FileMode.Open);
BinaryFormatter bf = new BinaryFormatter();
e1 = (Employee)bf.Deserialize(fs); // DownCasting is mandatory
Console.WriteLine("Id={0} name={1}",e1.Id,e1.Name);
}
catch (Exception Ex)
{
Console.WriteLine(Ex.Message);
}
finally
{
try
{
fs.Close();
}
catch (Exception ex) { Console.WriteLine(ex.Message); }
}
}
05 18 تشرين الثاني، 14

19. 05 19 تشرين الثاني، 14