This documentation is archived and is not being maintained.

PersonalizationProvider::LoadPersonalizationBlobs Method

When overridden in a derived class, loads raw personalization data from the underlying data store.

Namespace:  System.Web.UI.WebControls.WebParts
Assembly:  System.Web (in System.Web.dll)

protected:
virtual void LoadPersonalizationBlobs(
	WebPartManager^ webPartManager, 
	String^ path, 
	String^ userName, 
	array<unsigned char>^% sharedDataBlob, 
	array<unsigned char>^% userDataBlob
) abstract

Parameters

webPartManager
Type: System.Web.UI.WebControls.WebParts::WebPartManager
The WebPartManager managing the personalization data.
path
Type: System::String
The path for personalization information to be used as the retrieval key.
userName
Type: System::String
The user name for personalization information to be used as the retrieval key.
sharedDataBlob
Type: array<System::Byte>%
The returned data for the Shared scope.
userDataBlob
Type: array<System::Byte>%
The returned data for the User scope.

Classes that derive from PersonalizationProvider and implement this method should use the webPartManager, path, and username parameters as retrieval keys. Regardless of how the data is stored in the data store (some data stores might perform some type of intelligent storage), the personalization data must be returned as a packed set of bytes in two arrays. The returned data must conform to the following rules:

  • The data for the Shared scope must always be returned in the sharedDataBlob parameter.

  • Depending on the key values, User data is returned in the userDataBlob parameter. A non-nullptr value for the userName parameter indicates that User data should also be retrieved.

A personalization provider that derives from PersonalizationProvider and implements this method can optimize interactions with its data store by retrieving all personalization data in one round trip, as opposed to retrieving Shared and User data in two separate round trips.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: