Profile.Fields Property (PIA)

Article
11/12/2009

The Fields property is a read-only Fields collection that contains the profile property data for the Profile object. Read-only refers to the inability to add or delete members (profile properties) of the Fields collection. This property is the default property of the Profile object. Use this property to set and retrieve profile property values and to navigate the attribute list of the properties.

Definition

[Visual Basic .NET]

Imports Microsoft.CommerceServer.Interop.Profiles
Imports ADODB26Lib     ‘ for Fields
…
Public ReadOnly Property Fields As Fields

[C#]

using Microsoft.CommerceServer.Interop.Profiles;
using ADODB26Lib;                              //For _Recordset
…
public Fields Fields {get; }

Property Value

[C#] This property returns a collection of ADODB26Lib.Field objects.

Exceptions

This property may throw one of many mapped exceptions or an exception of type COMException. See Standard COM Errors for additional details.

The Errors property stores the collection of errors encountered in the last Profiles resource operation if an exception is thrown. For more information, see ProfileService.Errors.

Remarks

[Visual Basic .NET]

The Fields collection is a Fields collection object.

A member of the Fields collection is a Field object that represents a single property or property group of a Profile object.

The Attributes collection is represented as a Properties object.

Use the Update method of the Profile object to save any changed profile data in the underlying data store.

The Fields property of the Profile object supports extended dot notation for increased performance. For example, using extended dot notation, the following:

oProfile.Fields[“Address.ZipCode”].Value.ToString()

is equivalent to:

((Fields)oProfile.Fields[“Address”].Value)[“ZipCode”].Value.ToString()

[C#]

The Fields collection is an ADODB26Lib.Fields collection object.

A member of the Fields collection is an ADODB26Lib.Field object that represents a single property or property group of a Profile object.

The Attributes collection is represented as an ADODB26Lib.Properties object.

Use the Update method of the Profile object to save any changed profile data in the underlying data store.

The Fields property of the Profile object supports extended dot notation for increased performance. For example, using extended dot notation, the following:

oProfile.Fields[“Address.ZipCode”].Value.ToString()

is equivalent to:

((Fields)oProfile.Fields[“Address”].Value)[“ZipCode”].Value.ToString()

Requirements

Namespace: Microsoft.CommerceServer.Interop.Profiles

Platforms: Windows 2000, Windows Server 2003

Assembly: mscsups (in mscsups.dll)