WebPartPersonalization.InitialScope Property

Gets or sets the default personalization scope.

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

public:
virtual property PersonalizationScope InitialScope {
	PersonalizationScope get ();
	void set (PersonalizationScope value);
}
/** @property */
public PersonalizationScope get_InitialScope ()

/** @property */
public void set_InitialScope (PersonalizationScope value)

public function get InitialScope () : PersonalizationScope

public function set InitialScope (value : PersonalizationScope)

Not applicable.

Property Value

The PersonalizationScope indicating the default personalization scope of the associated WebPartManager.

Exception typeCondition

InvalidOperationException

An attempt was made to set this property to a value other than its current value after the associated WebPartManager control's OnInit method had completed.

ArgumentOutOfRangeException

An attempt was made to set a value of InitialScope that is not a member of the PersonalizationScope enumeration.

This property represents the default personalization scope that should be used for the parent WebPartManager control in the absence of previous knowledge about the proper scope. If this property is not explicitly set, it defaults to returning User scope.

This property can only be set prior to the completion of the WebPartManager control's OnInit method. In practice, this means InitialScope must be set in the page markup on the WebPartManager element. Alternatively, this property can be set during the PreInit phase of the WebPartManager control.

Windows 98, Windows Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show: