PersonalizationAdministration.FindSharedState Method (String)

Returns a collection of shared personalization state information based on the specified path.

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

public:
static PersonalizationStateInfoCollection^ FindSharedState (
	String^ pathToMatch
)
public static PersonalizationStateInfoCollection FindSharedState (
	String pathToMatch
)
public static function FindSharedState (
	pathToMatch : String
) : PersonalizationStateInfoCollection
Not applicable.

Parameters

pathToMatch

The path of the page to match.

Return Value

A PersonalizationStateInfoCollection that contains shared personalization state information.

Exception typeCondition

ArgumentException

pathToMatch is an empty string ("") either before or after trimming.

- or -

The provider for a personalization provider defined in configuration is not of the correct type.

- or -

The length of the string of any parameter is greater than 256 characters.

ConfigurationErrorsException

A configuration exception occurred while attempting to create and initialize an instance of one of the configured personalization providers.

- or -

The default personalization provider defined in configuration could not be found.

This method returns a collection of UserPersonalizationStateInfo instances where the pathToMatch value matches the path of a page that has shared personalization state data. The collection contains only SharedPersonalizationStateInfo instances.

This method passes parameter wildcard characters to the underlying personalization provider, so how the data store handles these characters depends on how the provider handles characters such as an asterisk (*), a percent symbol (%), or an underscore (_).

Normally, for SQL-compliant data stores, you can perform a wildcard search on a partial path with the wildcard character appearing at the beginning, the end, or the middle of the search string text in the PathToMatch property. For example, to find all paths that start with "~/vdir", the PathToMatch property would be set to "~/vdir%".

Using the default personalization provider, the PersonalizationStateInfo-derived objects are returned in alphabetical order, and sorted by a combination of path and user name in ascending order. The ordering of the objects in the collection is determined by the provider.

The pathToMatch parameter can be a null reference (Nothing in Visual Basic). If set to a null reference (Nothing in Visual Basic), the parameter is ignored when performing queries.

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: