EntityCollection
اعلان
public class Strawberry.Core.EntityCollection
مجموعهای strongly-typed از اشیاء موجود (Entity) که با کلید رشتهای قابل دسترسی هستند. یک دیکشنری را میپوشاند و هم رابط دیکشنری قابلتغییر و هم فقطخوانایی را پیادهسازی میکند.
پیادهسازی: System.Collections.Generic.IDictionary, System.Collections.Generic.IReadOnlyDictionary
سازندهها
EntityCollection
یک نمونهی جدید از کلاس EntityCollection میسازد.
void EntityCollection()
ویژگیها
this[]
موجود (Entity) با کلید مشخصشده را دریافت یا تنظیم میکند. هنگام دریافت اگر کلید یافت نشد null برمیگرداند.
Entity this[string key] { get set }
Count
تعداد موجودهای موجود در مجموعه را دریافت میکند.
int Count { get }
IsReadOnly
مقداری را دریافت میکند که نشان میدهد آیا شیء IDictionary فقطخوانایی است یا نه.
bool IsReadOnly { get }
Values
فهرستی شامل همهی موجودها در مجموعه را دریافت میکند. توجه: هر بار دسترسی یک تخصیص فهرست جدید ایجاد میکند.
IList<Entity> Values { get }
Keys
فهرستی شامل همهی کلیدها در مجموعه را دریافت میکند. توجه: هر بار دسترسی یک تخصیص فهرست جدید ایجاد میکند.
IList<string> Keys { get }
متدها
Add
یک موجود با کلید مشخصشده به مجموعه اضافه میکند. تغییرات مجموعه تا زمانی که Flush فراخوانی نشود اعمال نمیشوند.
void Add(string key, Entity value)
پارامترها:
| نام | نوع | توضیحات |
|---|---|---|
key |
System.String |
کلید موجود برای اضافهکردن. |
value |
Strawberry.Core.Entity |
موجود برای اضافهکردن. |
Clear
همهی موجودها را از مجموعه حذف میکند.
void Clear()
ContainsKey
تعیین میکند آیا مجموعه حاوی موجودی با کلید مشخصشده است یا نه.
bool ContainsKey(string key)
پارامترها:
| نام | نوع | توضیحات |
|---|---|---|
key |
System.String |
کلید برای یافتن در مجموعه. |
خروجی: true اگر مجموعه حاوی موجودی با کلید باشد؛ در غیر این صورت false.
Remove
موجود با کلید مشخصشده را از مجموعه حذف میکند. تغییرات مجموعه تا زمانی که Flush فراخوانی نشود اعمال نمیشوند.
bool Remove(string key)
پارامترها:
| نام | نوع | توضیحات |
|---|---|---|
key |
System.String |
کلید موجود برای حذف. |
خروجی: true اگر موجود با موفقیت حذف شود؛ در غیر این صورت false.
ImmediateRemove
bool ImmediateRemove(string key)
پارامترها:
| نام | نوع | توضیحات |
|---|---|---|
key |
System.String |
TryGetValue
موجود مرتبط با کلید مشخصشده را دریافت میکند.
bool TryGetValue(string key, out Entity value)
پارامترها:
| نام | نوع | توضیحات |
|---|---|---|
key |
System.String |
کلید موجود برای دریافت. |
value |
out Strawberry.Core.Entity |
وقتی این متد برمیگردد، حاوی موجود مرتبط با کلید مشخصشده است اگر کلید یافت شود؛ در غیر این صورت مقدار پیشفرض برای نوع پارامتر value. |
خروجی: true اگر مجموعه حاوی موجودی با کلید مشخصشده باشد؛ در غیر این صورت false.
GetEnumerator
IEnumerator<KeyValuePair<string, Entity>> GetEnumerator()
ChangeKey
کلید مرتبط با یک موجود موجود در مجموعه را تغییر میدهد. همچنین ویژگی ID موجود را با کلید جدید بهروز میکند.
void ChangeKey(string oldKey, string newKey)
پارامترها:
| نام | نوع | توضیحات |
|---|---|---|
oldKey |
System.String |
کلید فعلی موجود. |
newKey |
System.String |
کلید جدید برای تخصیص به موجود. |
Flush
همهی تغییرات معلق را به مجموعه اعمال میکند.
void Flush()