Contacts.Net

Source code checked in, #38923

JoeCastro — Thu, 04 Sep 2008 16:01:46 GMT

More race conditions found by having multiple instances of the address book open while running the unit tests.

Source code checked in, #38852

JoeCastro — Thu, 04 Sep 2008 00:45:23 GMT

SchematizedLabeledPropertyCollection -> LabeledPropertyCollection. Keeping this rename separate from functional changes.

Source code checked in, #38849

JoeCastro — Thu, 04 Sep 2008 00:21:26 GMT

Utility for hashing was also thread-unsafe...

Closed Issue: Public static methods on Contact are not thread safe

JoeCastro — Thu, 04 Sep 2008 00:10:15 GMT

Contact.GetTypeFromExtension and Contact.GetExtensionFromType are not thread safe and have potential to throw ArgumentExceptions when Contacts are used from multiple threads.

Source code checked in, #38847

JoeCastro — Thu, 04 Sep 2008 00:10:15 GMT

Making static methods on Contact thread safe by statically initializing the Dictionaries that were causing race conditions.

Created Issue: Public static methods on Contact are not thread safe

JoeCastro — Thu, 04 Sep 2008 00:02:45 GMT

Contact.GetTypeFromExtension and Contact.GetExtensionFromType are not thread safe and have potential to throw ArgumentExceptions when Contacts are used from multiple threads.

Source code checked in, #38718

JoeCastro — Tue, 02 Sep 2008 17:51:11 GMT

Adding test verifying Person semantics

Updated Release: Contacts.Net 1.0.1 (Sep 02, 2008)

Tue, 02 Sep 2008 17:03:21 GMT

This is a mature .Net library for working with the .Contact format introduced in Windows Vista. The features and benefits of the format itself are documented on MSDN.

Managed clients can create and manipulate contacts in the user's address book and share those changes with other applications that use the same store, such as Windows Mail and Windows Calendar. This library provides additional value beyond the COM APIs that ship as part of the Vista SDK, such as

Allows ContactManagers to be rooted in locations other than the user's Contacts folder
An abstraction above the file system
Strongly typed properties for all the standard schema properties
Group support
vCard import/export.
XP Support

This release is based on changeset 38707 of Contacts.Net

Changes from 1.0
Due to strong customer feedback, I've changed the .Business contact type and extension to .Organization. There are semantic differences between the two that don't globalize well, and the change is enough that I want to change it early to avoid too many people beginning to rely on it.

Released: Contacts.Net 1.0.1 (Sep 02, 2008)

Tue, 02 Sep 2008 17:00:28 GMT

Allows ContactManagers to be rooted in locations other than the user's Contacts folder
An abstraction above the file system
Strongly typed properties for all the standard schema properties
Group support
vCard import/export.
XP Support

Updated Release: Contacts.Net 1.0.1 (Sep 02, 2008)

Tue, 02 Sep 2008 17:00:28 GMT

Allows ContactManagers to be rooted in locations other than the user's Contacts folder
An abstraction above the file system
Strongly typed properties for all the standard schema properties
Group support
vCard import/export.
XP Support

Updated Release: Contacts.Net 1.0.1

Tue, 02 Sep 2008 16:57:08 GMT

Allows ContactManagers to be rooted in locations other than the user's Contacts folder
An abstraction above the file system
Strongly typed properties for all the standard schema properties
Group support
vCard import/export.
XP Support

Created Release: Contacts.Net 1.0.1

Tue, 02 Sep 2008 16:55:40 GMT

Allows ContactManagers to be rooted in locations other than the user's Contacts folder
An abstraction above the file system
Strongly typed properties for all the standard schema properties
Group support
vCard import/export.
XP Support

This release is based on changeset XXX of Contacts.Net

Changes from 1.0
Due to strong customer feedback, I've changed the .Business contact type and extension to .Organization. There are semantic differences between the two that don't globalize well, and the change is enough that I want to change it early to avoid too many people beginning to rely on it.

Source code checked in, #38707

JoeCastro — Tue, 02 Sep 2008 16:50:59 GMT

Changing ContactTypes.Business to ContactTypes.Organization. Updating the 1.0 release to reflect this.

Updated Wiki: Breaking Changes

JoeCastro — Tue, 02 Sep 2008 16:47:06 GMT

This generally only covers changes to APIs that existed in the prior release. For overviews of architectural changes and additions you should consult the class diagrams that accompany the release.

Breaking Changes between 1.0.1 and .9

Added Contact.GetAttributes function.
Added ILabeledPropertyCollection.GetNameAt
Added implicit cast operators for the TypeBuilder to Type conversions for types like Name, EmailAddress, PhysicalAddress, etc. This makes property setting syntax a bit less burdensome in languages like C#.
(New in 1.0.1) Renamed ContactTypes.Business to ContactTypes.Organization, along with the associated file extensions, due to strong customer feedback.

Breaking Changes between .8 and .9

Renamed ContactManager.Import to ContactManager.AddContact.
The interop namespace is no longer public. It's functionality is still available through the ContactBridge project but the current release isn't so much wrapping the COM APIs as it is reimplementing the functionality. As such what's left of the namespace has been internalized.
FxCop property and class name cleanup, including:

Certificate/CertificateBuilder: Type -> ValueType, ThumbPrint|Type| -> Thumbprint|Type|
ContactType -> ContactTypes
EmailAddress/EmailAddressBuilder: Type -> AddressType
Name/NameBuilder: NickName -> Nickname
ContactCommitOptions.ForceSyncStorageWithFormattedName no longer includes the non-force flag value.
ContactCollectionChangedEventHandler -> EventHandler<ContactCollectionChangedEventArgs>

Replaced engendered PersonLabels with androgenous versions, e.g. Mother/Father -> Parent, Brother/Sister -> Sibling.
Changed the properties that are exposed on Person and PersonBuilder so that they don't affect each other as directly. A loaded Contact is no longer available from Person.

Breaking Changes between .8 and Contacts Bridge 1.0

Removed ContactManager constructors that allow for different RootDirectories
Removed ContactType enumeration and property from Contact

By extension, ContactCollection support for types other than .contact has been removed.

Removed GroupView and MapiGroupView
Removed managed shims atop IContactPropertyCollection and IContactManager - implementations are now direct callthroughs to Vista COM APIs (Not API breaking, but will result in different behaviors).

Breaking Changes between .1 and .8

Renamed ContactManager.Load to ContactManager.GetContact
Person struct changed to add strong-typing to the PersonId format.
ILabeledPropertyCollection interface changed to have more indexer overloads so XAML will parse it.
Renamed ContactCommitOptions.Default to ContactCommitOptions.None (FxCop)
(Please add any others)

Source code checked in, #36095

JoeCastro — Fri, 15 Aug 2008 23:30:22 GMT

Removing the address book code since it now lives in Conmigo.

Source code checked in, #35540

JoeCastro — Mon, 11 Aug 2008 20:13:57 GMT

Branching 1.0 release for archiving.

Updated Wiki: Class Diagrams

JoeCastro — Mon, 11 Aug 2008 18:43:50 GMT

These are snapshots of the pertinent class hierarchies in the project.
Sample Code is also available.

Updated Release: Contacts.Net 1.0 (Aug 11, 2008)

Mon, 11 Aug 2008 18:39:25 GMT

Allows ContactManagers to be rooted in locations other than the user's Contacts folder
An abstraction above the file system
Strongly typed properties for all the standard schema properties
Group support
vCard import/export.
XP Support

This release is based on changeset 35530 of Contacts.Net

Released: Contacts.Net 1.0 (Aug 11, 2008)

Mon, 11 Aug 2008 18:39:25 GMT

Allows ContactManagers to be rooted in locations other than the user's Contacts folder
An abstraction above the file system
Strongly typed properties for all the standard schema properties
Group support
vCard import/export.
XP Support

This release is based on changeset 35530 of Contacts.Net

Updated Release: Contacts.Net 1.0 (Aug 11, 2008)

Mon, 11 Aug 2008 18:38:33 GMT

Allows ContactManagers to be rooted in locations other than the user's Contacts folder
An abstraction above the file system
Strongly typed properties for all the standard schema properties
Group support
vCard import/export.
XP Support