درس شانزدهم (قسمت اول) - استفاده از صفتها در C#

در این درس با نحوه استفاده از صفتها در زبان C# آشنا خواهید شد . اهداف ما در این درس به شرح زیر است :
1- صفتها چه هستند و چرا از آنها استفاده میکنیم
2- استفاده از صفتهای تک پارامتری و چند پارامتری
3- انواع پارامترهای صفت پارامترهای Named
Positional Target -4 های صفتها عناصری که صفتها بر روی آنها اعمال می شوند
5- تولید صفتهای شخصی
6- تعریف و یا کنترل موارد استفاده از یک صفت
7- استفاده از پارامترهای Positional و Named در صفتهای شخصی
8- انواع (type) معتبر برای پارامترهای صفت
9- استفاده از صفتها در زمان اجرا
10- خلاصه مطالب
11- منابع

 صفتها در حقیقت اطلاعات توضیحی هستند که می توانید آنها را به برنام ه های خود بیفزایید . صفتها را می توان برای کلیه عناصر برنامه از قبیل کلاسها، واسطها، اسمبلی ها و ... مورد استفاده قرار داد .از این اطلاعات می توان برای موارد متنوعی در زمان اجرای برنامه استفاده ن مود . برای مثال می توان به صفتی مانند DllImportAttribute اشاره کرد که امکان برقراری ارتباط با توابع کتابخانه ای Win32 را فراهم می نماید . همچنین صفتهایی نیز وجود دارند که برنام هنویس یا توسعه دهنده برنامه را در امر تولید برنامه یاری می نمایند . برای مثال می توان به صفت ObsoleteAttribute اشاره کرد که با استفاده از آن، در زمان کامپایل برنامه پیغامی برای برنامه نویس نمایش داده می شود و مشخص می کند که متدی خاص مورد استفاده قرار نگرفته و یا دیگر مورد استفاده نیست . همچنین هنگامیکه با فرمهای ویندوز کار می کنیم، صفتها ی بسیاری وجود دارند که امکان استفاده از این فرمها را فراهم کرده و باعث می شوند تا اطلاعات مربوط به این عناصر در property فرم ظاهر شوند . یکی دیگر از موارد استفاده از صفتها در مسایل امنیتی اسمبلی های .Net است . برای مثال صفتهایی وجود دارند که باعث جلوگیری از فراخوانی های غیر مجاز می شوند، بدین معنی که تنها اجازه فراخوانی را به متدها یا اشیایی می دهند که قبلا تعریف شده و مشخص شده باشند .

 
using System;
 
class BasicAttributeDemo
{
[Obsolete]
public void MyFirstDeprecatedMethod()
{
Console.WriteLine("Called MyFirstDeprecatedMethod().");
}
 
[ObsoleteAttribute]
public void MySecondDeprecatedMethod()
{
Console.WriteLine("Called MySecondDeprecatedMethod().");
}
 
[Obsolete("You shouldn"t use this method anymore.")] public void MyThirdDeprecatedMethod()
{
Console.WriteLine("Called MyThirdDeprecatedMethod().");
}
 
// make the program thread safe for COM [STAThread]
static void Main(string[] args)
{
BasicAttributeDemo attrDemo = new BasicAttributeDemo();
 
attrDemo.MyFirstDeprecatedMethod(); attrDemo.MySecondDeprecatedMethod(); attrDemo.MyThirdDeprecatedMethod();
}
}

 
[Obsolete("You shouldn"t use this method anymore.")] public void MyThirdDeprecatedMethod() ...

 
>csc BasicAttributeDemo.cs
Microsoft (R) Visual C# .NET Compiler version 7.10.2292.4 for Microsoft (R) .NET Framework version 1.1.4322
Copyright (C) Microsoft Corporation 2001-2002. All rights reserved.
 
BasicAttributeDemo.cs(29,3): warning CS0612:
"BasicAttributeDemo.MyFirstDeprecatedMethod()" is obsolete BasicAttributeDemo.cs(30,3): warning CS0612:
"BasicAttributeDemo.MySecondDeprecatedMethod()" is obsolete BasicAttributeDemo.cs(31,3): warning CS0618:
"BasicAttributeDemo.MyThirdDeprecatedMethod()" is obsolete: "You shouldn"t use this method anymore."

 
using System;
public class AnyClass
{
[Obsolete("Don"t use Old method, use New method", true)]
 
static void Old( ) { }
 
static void New( ) { }
 
public static void Main( )
{
Old( );
}
}

 
AnyClass.Old()" is obsolete: "Don"t use Old method, use New method"

 
using System;
using System.Runtime.InteropServices;
 
class AttributeParamsDemo
{
 
[DllImport("User32.dll", EntryPoint="MessageBox")] static extern 

int MessageDialog(int hWnd, string msg, string caption, int msgType);
 
[STAThread]
static void Main(string[] args)
{
MessageDialog(0, "MessageDialog Called!", "DllImport Demo", 0);
}
}

 
using System;
 
[assembly:CLSCompliant(true)]
 
public class AttributeTargetDemo
{
public void NonClsCompliantMethod(uint nclsParam)
{
Console.WriteLine("Called NonClsCompliantMethod().");
}
 
[STAThread]
static void Main(string[] args)
{
uint myUint = 0;
 
AttributeTargetDemo tgtDemo = new AttributeTargetDemo();
 
tgtDemo.NonClsCompliantMethod(myUint);
}
}