This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

Cache.Add أسلوب

Visual Studio 2010

إضافة العنصر المحدد إلى Cacheالكائن باستخدام تبعيات ونهج انتهاء الصلاحية والأولوية مفوض التي يمكنك استخدامها لإعلام تطبيق الخاص بك عند العنصر المدرج هو إزالته من Cache.

مساحة الاسم:  System.Web.Caching
التجميع:  System.Web (في System.Web.dll)

public Object Add(
	string key,
	Object value,
	CacheDependency dependencies,
	DateTime absoluteExpiration,
	TimeSpan slidingExpiration,
	CacheItemPriority priority,
	CacheItemRemovedCallback onRemoveCallback
)

المعلمات

key
النوع: System.String
المفتاح ذاكرة تخزين مؤقت للمستخدم للإشارة إلى العنصر.
value
النوع: System.Object
العنصر الذي تريد أن تمت الإضافة إلى ذاكرة تخزين مؤقت.
dependencies
النوع: System.Web.Caching.CacheDependency
الملف أو ذاكرة تخزين مؤقت المفتاح التبعيات للعنصر. عند أي تغييرات تبعية، يصبح الكائن غير صالح و هو إزالتها من ذاكرة تخزين مؤقت. في حالة لا تبعيات، تتضمن هذه معلمة null.
absoluteExpiration
النوع: System.DateTime
الوقت التي تمت إضافتها كائن انتهاء الصلاحية وتتم تمت إزالته من ذاكرة تخزين مؤقت. إذا كنت تستخدم الانزلاق انتهاء الصلاحية، absoluteExpirationيجب أن تكون معلمة NoAbsoluteExpiration.
slidingExpiration
النوع: System.TimeSpan
تم إضافة الكائن الفترة الزمنية بين الوقت مُستخدَم أخيرًا ووقت انتهاء ذلك الكائن. If this القيمة هو the equivalent of 20 دقائق, the كائن expires و هو تمت إزالته من the ذاكرة تخزين مؤقت 20 دقائق بعد it أخير accessed. If you are using مطلق expiration, the slidingExpiration معلمة must be NoSlidingExpiration.
priority
النوع: System.Web.Caching.CacheItemPriority
The نسبي cost of the كائن, كـ expressed بواسطة the CacheItemPriority قائمة تعداد. The ذاكرة تخزين مؤقت uses this القيمة when it evicts الكائنات; الكائنات مع a lower cost are تمت إزالته من the ذاكرة تخزين مؤقت قبل الكائنات مع a higher cost.
onRemoveCallback
النوع: System.Web.Caching.CacheItemRemovedCallback
A تفويض that, if provided, هو called when an كائن هو تمت إزالته من the ذاكرة تخزين مؤقت. You can استخدم this إلى notify applications when their الكائنات are تم الحذف من the ذاكرة تخزين مؤقت.

القيمة المُرجعة

النوع: System.Object
An كائن that represents the العنصر that was تمت الإضافة if the العنصر was previously stored في the ذاكرة تخزين مؤقت; otherwise, null.

استثناء:شرط
ArgumentNullException

The key أو value معلمة هو التعيين إلى null.

ArgumentOutOfRangeException

The slidingExpiration معلمة هو التعيين إلى أصغر من TimeSpan.Zero أو المزيد واحد سنة.

ArgumentException

The absoluteExpiration و slidingExpiration معلمات are كلاهما التعيين for the العنصر you are trying إلى إضافة إلى the Cache.

Calls إلى this أسلوب will فشل if an العنصر مع the same key معلمة هو already stored في the Cache. إلى الكتابة فوق an موجود Cache العنصر using the same key معلمة, استخدم the Insert أسلوب.

لا يمكنك التعيين كلا absoluteExpirationو slidingExpirationمعلمات. إذا كنت ترغب في ذاكرة تخزين مؤقت للعنصر إلى صلاحيتها في وقت محدد، يمكنك تعيين absoluteExpirationمعلمة إلى وقت محدد، و slidingExpirationإلى المعلمة NoSlidingExpiration.

إذا كنت ترغب في أن عنصر ذاكرة تخزين مؤقت بحيث تنتهي صلاحيتها بعد فترة محددة من الوقت مر منذ آخر مرة تم الوصول إلى العنصر، التعيين slidingExpirationلفترة انتهاء الصلاحية، و absoluteExpirationNoAbsoluteExpiration.

يقوم المثال التالي بإنشاء AddItemToCacheأسلوب. عندما th هو أسلوب هو يسمى، يقوم بتعيين itemRemovedالخصائص إلى falseو regهوters onRemoveأسلوباً له مثيل جديد من CacheItemRemovedCallbackالمفوض. توقيع المفوض هو المستخدمة في RemovedCallbackالأسلوب. AddItemToCacheأسلوب ثم التحقق من قيمة المرتبطة مع Key1المفتاح في ذاكرة تخزين مؤقت. إذا كانت القيمة هو nullAddأسلوب وضع عنصر في ذاكرة تخزين مؤقت مع المفتاح من Key1، قيمة Value 1وانتهاء مدة صلاحية مطلقة لمدة 60 ثانية، وأولوية عالية لذاكرة تخزين مؤقت. كما يستخدم onRemoveأسلوب كعنصر وسيطة. Th هو يسمح RemovedCallbackأسلوب استدعاء عندما th هو العنصر هو إزالتها من ذاكرة تخزين مؤقت.

ملاحظةملاحظة

للحصول على أمثلة حول إلى استخدام CacheDependencyفئة و CacheItemRemovedCallbackتفويض، راجع التخزين المؤقت بيانات التطبيق.


public void AddItemToCache(Object sender, EventArgs e) {
    itemRemoved = false;

    onRemove = new CacheItemRemovedCallback(this.RemovedCallback);

    if (Cache["Key1"] == null)
      Cache.Add("Key1", "Value 1", null, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove);
}


نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0, 1.1, 1.0
إظهار: