ConversationCollection.Create Method (Contact)

var conversation = instance.create(contact);

Return Value

The Create(Contact) method creates a conversation between the user and the provided contact. The Conversation that is returned represents the user's view of the conversation between the user and the contact. The other contact will not learn of the conversation until the first message that the user sends is delivered to the contact.

This method is equivalent to providing the CurrentAddress of a Contact to the Create(IMAddress) method.

If an active conversation already exists between the user and the contact, the existing conversation is returned.

Once a conversation has been created, a TextMessage can be sent using the SendMessage(Message) method of the Conversation.

The CollectionChanged event should be handled to detect conversations created by other contacts.

Windows Live Messenger Web Toolkit

Internet Explorer 8.0, Internet Explorer 7.0, Internet Explorer 6.0, Firefox 3.5, Firefox 3.0, Firefox 2.0, Firefox 1.5, Chrome 3.0, Chrome 2.0, Chrome 1.0, Safari 4.0, Safari 3.0