ویرگول
ورودثبت نام
آرمان
آرمانیک برنامه نویس که هرآنچه را که یاد میگیرد در دفترچه یادداشت ویرگولیش یادداشت میکرد(!) حتی یک خط ! تا درصورت نیاز به آن رجوع کند...
آرمان
آرمان
خواندن ۱۱ دقیقه·۷ سال پیش

ایجاد و مدیریت Event ها

Handling and raising events

این مطلب پیرو مطلب قبلیست

https://virgool.io/@espiar/callback-%DA%86%DB%8C%D8%B3%D8%AA-%D9%86%D8%AD%D9%88%D9%87-%D8%B3%D8%A7%D8%AE%D8%AA-%D8%A2%D9%86-%D8%AF%D8%B1-c-ofudiayf1wkr

رویدادها(Events) در .NET براساس مدل نماینده(delegate) است. مدل delegate از observer design pattern (الگوی طراحی ناظر) پیروی می کند ، که یک مشترک (subscriber) را قادر می سازد تا در یک Provider ثبت شده و notification ها را دریافت کند. یک فرستنده رویداد (event sender) یک notification ارسال میکند که بیان کننده یک event اتفاق افتاده است، و یک گیرنده رویداد (event receiver) که notification را دریافت کرده و پاسخی راجع به آن تعریف میکند.

در این مقاله به تشریح مؤلفه های اصلی مدل نماینده ، نحوه استفاده رویدادها در برنامه ها و چگونگی پیاده سازی رویدادها در کد خود می پردازیم.


رویداد ها Events

یک event ، یک پیام است که توسط یک شی برای اطلاع از وقوع یک عمل (یک action) ارسال می شود.این action می تواند ناشی از تعامل کاربر باشد ، مانند کلیک دکمه ، یا می تواند ناشی از برخی از منطق برنامه دیگر باشد ، از جمله تغییر value یک property. ابزاری که رویداد را raises (به آن fire هم می گویند - کلا به معنی اجرا کردن) می کند ، فرستنده رویداد یا event sender نامیده می شود.فرستنده رویداد نمی داند که چه شیء یا متد رویدادهای raise شده را دریافت خواهد کرد(مدیریت خواهد کرد).این رویداد به طور معمول عضو فرستنده رویداد است. به عنوان مثال ، رویداد Click عضو کلاس Button است و رویداد PropertChanged عضو کلاسی است که واسط INotifyPropertyChanged را پیاده سازی می کند.

برای تعریف یک رویداد ،شما از کلمه کلید event استفاده می کنید و نوع delegate را برای این رویداد مشخص می کنید.

به طور معمول ، برای ایجاد یک رویداد ، methodی را اضافه می کنید که به عنوان Protected و virtual مشخص شده است.این متد را OnEventName بنویسید؛ به عنوان مثال ، OnDataReceived.این method باید از یک پارامتر استفاده کند که یک شیء از داده های رویداد را مشخص کند ، این یک شیء از نوع EventArgs یا یک نوع مشتق شده از آن است. با فراهم کردن این متد این قابلیت را فراهم میکند تا کلاسهای مشتق شده بتوانند منطق خود را برای raise کردن رویداد، override کنند. یک کلاس مشتق شده باید همیشه از متد OnEventName کلاس پایه را صدا بزند تا اطمینان حاصل شود که delegateهای ثبت شده این رویداد را دریافت می کنند.

مثال زیر نشان می دهد که چگونه رویدادی به نام ThresholdReached را تعریف کنیم. این رویداد با نماینده EventHandler همراه است و با متدی به نام OnThresholdReached را raise کرده است.

class Counter { public event EventHandler ThresholdReached; protected virtual void OnThresholdReached(EventArgs e) { EventHandler handler = ThresholdReached; handler?.Invoke(this, e); } // provide remaining implementation for the class }

نکته: البته در نظرات گفته شده برای کوتاه کردن کد میتوان بجای

EventHandler handler = ThresholdReached; handler?.Invoke(this, e);

از کد زیر استفاده کرد

ThresholdReached?.Invoke(this, e);

نمایندگان Delegates

یک delegate یک type است که ارجاع به یک متد در خود نگهداری میکند. یک delegate با امضایی تعریف می شود که نوع بازگشتی و پارامترهایی را برای متدهایی که ارجاع می دهد نشان می دهد و می تواند تنها به متدهایی که با امضای آن مطابقت دارند ، مراجعه کند.بدین ترتیب یک delegate معادل یک type-safe function pointer یا یک callback است. یک delegate برای تعریف کلاس delegate کافی است.

نمایندها کاربردهای زیادی در دات نت دارند. در متن eventها ، یک delegate واسطه (یا مکانیسم شبیه به pointer) بین منبع event و کدی است که از آن event استفاده می کند. با ذکر نوع delegate در تعریف event شما یک delegate را با یک event مرتبط می کنید،همانطور که در مثال قبلی نشان داده شده است.برای کسب اطلاعات بیشتر در مورد نمایندها ، به کلاس Delegate مراجعه کنید.

دات نت .NET نمایندهای EventHandler و EventHandler<TEventArgs> (لینکش طبق معمول مشکل ویرگول) را برای پشتیبانی از بیشتر سناریوهای رویداد فراهم می کرده است. از نماینده EventHandler برای همه رویدادهایی که شامل داده های رویداد نیستند استفاده کنید. برای رویدادهایی که شامل داده های مربوط به رویداد هستند از نماینده EventHandler<TEventArgs> استفاده کنید.این delegateها هیچ مقدار از نوع برگشتی ندارند و دو پارامتر (یک شی برای منبع رویداد و یک شی برای داده های رویداد) را می گیرند.

نمایندها multicast (چند مرحله ای) هستند ، به این معنی که آنها می توانند ارجاعات بیش از یک متد ادراه کننده رویدادها (event-handling method) نگهداری کنند.برای جزئیات بیشتر ، به صفحه Delegate مراجعه کنید. Delegateها انعطاف پذیری و کنترل fine-grained را در اداره کردن رویدادها فراهم می کنند. یک delegate مانند یک ارسال کننده رویداد برای کلاس عمل می کند که با حفظ لیستی از event handlers ثبت شده برای این رویداد ، رویداد را raise می کند.


برای سناریوهایی که نمایندهای EventHandler وEventHandler<TEventArgs> کار نمی کنند ، می توانید یک delegate تعریف کنید. سناریوهایی که شما را برای تعریف delegate مجبور می کنند بسیار نادر هستند ، مانند زمانی که شما باید با کدی کار کنید که genericها را تشخیص نمی دهد .شما از کلمه کلیدی delegate برای علامت گذاری
در تعریف نماینده استفاده می کنید. مثال زیر نحوه تعریف delegateی به نام ThresholdReachedEventHandler را نشان می دهد.

public delegate void ThresholdReachedEventHandler(object sender, ThresholdReachedEventArgs e);


داده های رویداد Event data

داده های مرتبط با یک رویداد را می توان از طریق یک کلاس داده رویداد (event data class) ارائه داد. دات نت کلاس های بسیاری از داده های رویداد را ارائه می دهد که می توانید در برنامه های خود استفاده کنید.به عنوان مثال ، کلاس SerialDataReceivedEventArgs کلاس داده های رویداد، برای رویداد SerialPort.DataReceived است. .NET از الگوی نامگذاری پایان دادن به همه کلاسهای داده رویداد با EventArgs پیروی می کند (در پایان نام کلمه EventArgs می آید). با نگاه کردن به delegate برای این event، تعیین می کنید که کدام event data class با یک event مرتبط است. به عنوان مثال ، نماینده SerialDataReceivedEventHandler شامل کلاس SerialDataReceivedEventArgs به عنوان یکی از پارامترهای آن است.

کلاس EventArgs نوع پایه ای برای همه event data classها است. وقتی یک رویداد هیچ data ای ندارد کلاس EventArgs همچنان مورد استفاده قرار میگیرد. وقتی رویدادی را ایجاد می کنید که فقط به کلاس های دیگر اطلاع دهد که اتفاقی افتاده است و نیازی به ارسال(پاس دادن) داده ها نیست ، کلاس EventArgs را به عنوان دومین پارامتر در delegate وارد کنید. وقتی اطلاعاتی در دسترس نباشد می توانید مقدار EventArgs.Empty را تعیین کنید. نماینده EventHandler شامل کلاس EventArgs به عنوان یک پارامتر است. (در کل EventArgs اجباریست)


هنگامی که می خواهید یک event data class سفارشی ایجاد کنید ، یک کلاس ایجاد کنید که از EventArgs مشتق شود ، و سپس اعضای مورد نیاز برای ارسال(پاس دادن) داده هایی را که مربوط به رویداد است ، تهیه کنید.به طور معمول ، شما باید از همان الگوی نامگذاری .NET استفاده کرده و نام event data class خود را با EventArgs پایان دهید.

مثال زیر event data class را با نام ThresholdReachedEventArgs نشان می دهد. این شامل پراپرتی های خاص برای رویداد raise شده است.

public class ThresholdReachedEventArgs : EventArgs { public int Threshold { get; set; } public DateTime TimeReached { get; set; } }



مدیریت کننده رویداد Event handlers

برای پاسخ به یک رویداد ، شما یک متد مدیریت کننده رویداد را در گیرنده رویداد تعریف می کنید.این متد باید با امضای نماینده برای رویدادی که انجام می دهد مطابقت داشته باشد.در قسمت مدیریت رویداد(event handler) ، اقدامات موردنیاز هنگامی که رویداد raise شده است ،را انجام می دهید، مانند جمع آوری ورودی کاربر پس از کلیک کاربر روی یک دکمه. برای دریافت notification ها هنگام وقوع این رویداد ، متد event handler شما باید در این رویداد subscribe (مشترک) شوید.

مثال زیر یک event handler method به نام c_ThresholdReached را نشان می دهد که با امضای نماینده EventHandler مطابقت دارد. این متد در رویداد ThresholdReached مشترک (subscribe) است.

class Program { static void Main() { var c = new Counter(); c.ThresholdReached += c_ThresholdReached; // provide remaining implementation for the class } static void c_ThresholdReached(object sender, EventArgs e) { Console.WriteLine("The threshold was reached."); } }



مدیریت کننده رویداد استاتیک و داینامیک Static and dynamic event handlers

دات نت به مشترکین(subscribers) اجازه می دهد تا event notificationها را بصورت ایستا (statically) یا پویا(dynamically) ثبت کنند. Static event handlerها در واقع برای کل عمر کلاس که مدیریت رویدادهای آنها را بر عهده دارد ، تأثیر دارند. Dynamic event handlers معمولاً در پاسخ به برخی از منطق برنامه های شرطی ، به صراحت هنگام اجرای برنامه فعال و غیرفعال می شوند. به عنوان مثال ،آنها می توانند در صورت نیاز به event notificationها فقط در شرایط خاص مورد استفاده قرار گیرند یا اگر یک برنامه (application) چندین event handler را در اختیار شما قرار می دهد و شرایط زمان اجرا(run-time) مناسب را برای استفاده تعریف می کند. در مثال بخش قبلی نحوه اضافه کردن یک dynamically event handler را نشان می دهد. اطلاعات بیشتر Events.


رایزکردن چندین رویداد Raising multiple events

اگر کلاس شما چندین رویداد را raise کند ، کامپایلر برای هر نمونه event delegate یک field ایجاد می کند. اگر تعداد رویدادها زیاد باشد ، ممکن است هزینه ذخیره یک field در هر نماینده قابل قبول نباشد.برای چنین شرایطی دات نت event propertyها را فراهم می کند که می توانید با استفاده از ساختار داده دیگری به انتخاب خود برای ذخیره event delegateها استفاده کنید.

(خصوصیات رویداد) event delegateها شامل تعاریف event همراه با event accessor است. event accessorها متدهایی هستند که برای اضافه کردن یا حذف نمونه های event delegate از ساختار داده ذخیره سازی تعریف می کنید.توجه داشته باشید که event propertyها از event fieldها آهسته تر است ، زیرا باید هر event delegate قبل از invoke شدن به آن بازیابی شود.مبادله بین حافظه و سرعت است. اگر کلاس شما رویدادهای بسیاری را تعریف کرده که به ندرت raise میشوند ، می خواهید event propertyها را پیاده سازی کنید.برای اطلاعات بیشتر ، به نحوه مدیریت: چندین رویداد با استفاده از ویژگی های رویداد مراجعه کنید.


آموزش های مرتبط

چگونه رویداد ها را raise و استفاده کنیم:حاوی نمونه هایی از raise و استفاده رویدادها است.

چگونه چندین رویداد را مدیریت کرده و از خصوصیات رویداد استفاده کنیم: نحوه استفاده از ویژگی های رویداد برای انجام چندین رویداد را نشان می دهد.

الگوی طراحی Observer : الگوی طراحی را توصیف می کند که مشترک را قادر می سازد از ارائه دهنده ثبت کند و notification هایی را دریافت کند.

استفاده رویداد ها در web forms : نحوه اداره رویدادی را که توسط یک کنترل وب فرم ایجاد شده است نشان می دهد.

منبع

۲
۰
آرمان
آرمان
یک برنامه نویس که هرآنچه را که یاد میگیرد در دفترچه یادداشت ویرگولیش یادداشت میکرد(!) حتی یک خط ! تا درصورت نیاز به آن رجوع کند...
شاید از این پست‌ها خوشتان بیاید