ProfileObject Object

Ee783925.c++_off(en-US,CS.10).gifEe783925.vb_on(en-US,CS.10).gif

Use this object to retrieve the data in specific profile object instances and modify the property values for that profile object. In addition, use the ProfileObject object to examine and navigate the property attributes of a profile object.

ProgID:   Commerce.ProfileObject (Externally creatable)
COM Class Name:   ProfileObject
COM Interface Name:   IProfileObject
Interface ID Constant:   IID_IProfileObject
Header File:   mscsups.h, mspu_guids.h
Type Library Name:   Microsoft Commerce 2000 Profile Service Type Library
DLL Name:   mscsups.dll
Threading Model:   Both

In C++, use the IProfileObject interface to access the properties and methods of the ProfileObject object.

Because this object is primarily intended for use within ASP script, access from C++ will not be common.

The properties of the ProfileObject object are shown in the following table.

Property Type Description
Fields Fields Stores the profile property collection.

This property is read-only.

The methods of the ProfileObject object are shown in the following table.

Method Description
GetProfileXML Retrieves an XML fragment representing the data structure of the profile object.
Update Saves the profile data to the underlying data store.

Remarks

The ProfileObject object maintains backward compatibility with the AUO 1.0 object (released in Microsoft Site Server 3.0 Commerce Edition) by inheriting from the IADs interface. Refer to the MSDN ADSI documentation for descriptions of the methods of the IADs interface.

The ProfileObject object supports extended dot notation. For example, using extended dot notation, the following:

oProfileObject.Fields("Address.Zipcode")

is equivalent to:

oProfileObject.Fields("Address").Value("Zipcode")

The first technique retrieves the Zipcode value in a single call to Fields.Value, while the second technique requires two calls to retrieve the same value.

The ProfileObject object also provides smart navigation into profiles. For example, using smart navigation, the following:

oProfileObject.Address.ZipCode

is equivalent to:

oProfileObject.Fields("Address.Zipcode")

In general, the CreateProfile method of the ProfileService object is used to instantiate this object.

See Also

Profile Objects

Profile Schema

Profile XML Structures

ProfileService Object


All rights reserved.