ProfileObject Object[C++]
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 |
| Type Library Name: | Microsoft Commerce 2002 Profile Service Type Library |
| DLL Name: | mscsups.dll |
| Threading Model: | Both |
[C++]
| COM Interface Name: | IProfileObject2 |
| Interface ID Constant: | IID_IProfileObject2 |
| Header File: | mscsups.h, mspu_guids.h |
[C++]
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.
Methods
[C++]
| 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. |
| UpdateProfileXML | Changes the properties of the ProfileObject object. |
[Visual Basic]
| 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. |
| UpdateProfileXML | Changes the properties of the ProfileObject object. |
Properties
[C++]
| Property | Type | Description |
|---|---|---|
| Fields | Fields | Stores the profile property collection.
This property is read-only. |
[Visual Basic]
| Property | Type | Description |
|---|---|---|
| Fields | Object | Stores the profile property collection.
This property is read-only. |
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
[C++]Profile Objects
[C++]Profile Schema
[Visual Basic]Profile Objects
[Visual Basic]Profile Schema
[Visual Basic]Profile XML Structures
[Visual Basic]ProfileService Object
Copyright © 2005 Microsoft Corporation.
All rights reserved.