Documentation for: ASP.NET Ajax Version 1.0

This documentation is for a previous version. For the current released version, see the ASP.NET Ajax documentation on MSDN.

 

 

 

 

 

 

 

LoadProperties Property

Gets or sets an array that contains the profile properties that will be made available to client script.

Syntax

CSharp

[DefaultValueAttribute(null)]
[NotifyParentPropertyAttribute(true)]
[CategoryAttribute("Behavior")]
[TypeConverterAttribute(typeof(StringArrayConverter))]
public string[] LoadProperties { get; set; }

VisualBasic

<DefaultValueAttribute(Nothing)> _
<NotifyParentPropertyAttribute(True)> _
<CategoryAttribute("Behavior")> _
<TypeConverterAttribute(GetType())> _
Public Property LoadProperties As String()

ManagedCPlusPlus

[DefaultValueAttribute(nullptr)]
[NotifyParentPropertyAttribute(true)]
[CategoryAttribute(L"Behavior")]
[TypeConverterAttribute(typeof())]
public:
array<String^>^ LoadProperties {
	array<String^>^ get ();
	void set (array<String^>^ value);
}

JSharp

/** @property */
/** @property */

Value

Return Value

A string array that contains the names of the profile properties that will be preloaded and made available to client script. The default is an empty array.

Remarks

If LoadProperties contains at least one string that corresponds to the name of a profile property, then the built-in profile service in the Web application retrieves the current user's profile data for each of the specified profile properties. The profile property values are serialized and then made available to client script through the properties Field collection.

note

To set this property declaratively, use a comma-separated list of property names. For grouped property values, use the syntax GroupName.PropertyName.

When LoadProperties is an empty array, no profile data is preloaded.

The LoadProperties property can be specified in the ScriptManager control or in an associated ScriptManagerProxy control. When LoadProperties is set on both the ScriptManager control and on one or more ScriptManagerProxy controls, the set of properties is determined by merging all the specified properties. Duplicate properties are ignored.

Exceptions

ExceptionCondition
ArgumentException

The LoadProperties property includes property names that are not in the current application’s profile schema.

Assembly: System.Web.Extensions (Module: System.Web.Extensions)