PersonalizationProvider::LoadPersonalizationBlobs Method (WebPartManager^, String^, String^, array<Byte>^%, array<Byte>^%)

 

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-null 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
Available since 2.0
Return to top
Show: