PersonalizationProvider.LoadPersonalizationBlobs Method

Note: This method is new in the .NET Framework version 2.0.

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
protected abstract void LoadPersonalizationBlobs (
	WebPartManager webPartManager, 
	String path, 
	String userName, 
	/** @ref */ byte[] sharedDataBlob, 
	/** @ref */ byte[] userDataBlob
)
JScript does not support passing value-type arguments by reference.

Parameters

webPartManager

The WebPartManager managing the personalization data.

path

The path for personalization information to be used as the retrieval key.

userName

The user name for personalization information to be used as the retrieval key.

sharedDataBlob

The returned data for the Shared scope.

userDataBlob

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-a null reference (Nothing in Visual Basic) 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.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show: