ProfileObject Object
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.