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.

SessionStateStoreProviderBase.GetItem أسلوب

Visual Studio 2010

تقوم بإرجاع بيانات الولاية جلسة عمل للقراءة فقط من مخزن البيانات جلسة عمل.

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

public abstract SessionStateStoreData GetItem(
	HttpContext context,
	string id,
	out bool locked,
	out TimeSpan lockAge,
	out Object lockId,
	out SessionStateActions actions
)

المعلمات

context
النوع: System.Web.HttpContext
The HttpContext for the الحالي طلب.
id
النوع: System.String
The SessionID for the الحالي طلب.
locked
النوع: System.Boolean%
عندما th هو إرجاع الأسلوب، يحتوي على القيمة منطقية القيمة هو معينة إلى trueإذا العنصر المطلوب لجلسة عمل هو مؤمنة في بيانات جلسة المخزن؛ otherwهوe، false.
lockAge
النوع: System.TimeSpan%
عند ترتيب هو إرجاع الأسلوب، يحتوي على TimeSpanالكائن الذي هو قم بتعيين مقدار الوقت الذي تم مؤمّن عنصر موجود في مخزن بيانات جلسة.
lockId
النوع: System.Object%
عند ترتيب هو إرجاع الأسلوب، يحتوي على كائن التي هو تعيين المعرّف القفل للطلب الحالي. تشغيل معرّف قفل راجع "تامين جلسة عمل-مخزن بيانات" في SessionStateStoreProviderBaseفئة خلاصة.
actions
النوع: System.Web.SessionState.SessionStateActions%
عندما th هو الأسلوب بإرجاع، تحتوي على أحد SessionStateActionsقيم، والتي تشير إلى ما إذا كانت جلسة عمل الحالي هو عنصر غير مهيأ، cookieless جلسة عمل.

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

النوع: System.Web.SessionState.SessionStateStoreData
SessionStateStoreData معبأ بقيم جلسة عمل والمعلومات من مخزن بيانات جلسة عمل.

SessionStateModule كائن المكالمات GetItemالأسلوب في بداية طلب، أثناء AcquireRequestStateحدث، عندما EnableSessionStateيتم تعيين السمة إلى ReadOnly. إذا EnableSessionStateالسمة هو معينة إلى true، SessionStateModuleالكائن بدلاً من المكالمات GetItemExclusiveالأسلوب.

GetItem إرجاع الأسلوب SessionStateStoreDataكائن معبأ بمعلومات جلسة عمل من مخزن بيانات و upالتاريخs انتهاء الصلاحية التاريخ لبيانات الجلسة. If no session-item data is found at the data store, the GetItem method sets the locked out parameter to false and returns null. يؤدي هذا إلى SessionStateModuleالكائن للاتصال CreateNewStoreDataالأسلوب لإنشاء جديد جلسة عمل عنصر في مخزن بيانات.

If session-item data is found at the data store but the data is locked, the GetItem method sets the locked out parameter to true, sets the lockAge out parameter to the current date and time minus the date and time when the item was locked (which is retrieved from the data store), sets the lockId out parameter to the lock identifier retrieved from the data store, and returns null. يؤدي هذا إلى SessionStateModuleالكائن للاتصال GetItemالأسلوب مرة أخرى بعد فاصل زمني نصف ثانية لمحاولة استرداد جلسة عمل-عنصر المعلومات.

If the value that the lockAge out parameter is set to exceed the ExecutionTimeout value, then the SessionStateModule object calls the ReleaseItemExclusive method to clear the lock on the session-item data, and then calls the GetItem method again.

actionFlagsمعلمة هو استخدامها عند كل من cookielessو regenerateExpiredSessionIdالسمات التي تم تعيينها إلى true. actionFlagsتعيين القيمة إلى InitializeItemيشير إلى تخزين الإدخال في بيانات جلسة هو جلسة عمل جديد يتطلب تهيئة. يتم إنشاء الإدخالات غير المهيأة في sإلىre بيانات جلسة العمل بواسطة استدعاء إلى CreateUninitializedItemالأسلوب. في حالة تخزين العنصر من بيانات جلسة هو غير عنصر غير مهيأ، في actionFlagsسيتم تعيين معلمة إلى الصفر.

Custom session-state store implementers that support cookieless sessions should set the actionFlags out parameter to the value returned from the session data store for the current item. If the actionFlags parameter value for the requested session-store item equals the InitializeItem enumeration value, then the GetItem method should set the value in the data store to zero after setting the actionFlags out parameter.

For an مثال of a جلسة عمل-الولاية store موفر implementation, see تطبيق موفر مخزن حالة جلسة العمل.

نظام التشغيل 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
إظهار: