Profile Class (PIA)
Use this object to retrieve the data in a specific Profile object instance and modify the property values for that Profile object. In addition, use the Profile object to examine and navigate the property attributes of a profile object.
Methods
| 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. |
Properties
| Property | Type | Description |
|---|---|---|
| Fields | ADODB26Lib.Fields | Stores the profile property collection.
This property is read-only. |
Remarks
The Profile 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 Active Directory Service Interfaces (ADSI) documentation in MSDN for descriptions of the methods of the IADs interface.
[Visual Basic .NET]
The Profile object supports extended dot notation. 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()
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 Profile object also provides smart navigation into profiles. For example, using smart navigation, the following:
oProfile.Address.ZipCode
is equivalent to:
oProfile.Fields("Address.Zipcode")
In general, the CreateProfile method of the ProfileService object is used to instantiate this object.
[C#]
The Profile object supports extended dot notation. 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()
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 Profile object also provides smart navigation into profiles. For example, using smart navigation, the following:
oProfile.Address.ZipCode
is equivalent to:
oProfile.Fields["Address.Zipcode"]
In general, the CreateProfile method of the ProfileService object is used to instantiate this object.
Requirements
Namespace: Microsoft.CommerceServer.Interop.Profiles
Platforms: Windows 2000, Windows Server 2003
Assembly: mscsups (in mscsups.dll)
See Also
Copyright © 2005 Microsoft Corporation.
All rights reserved.