ChatRoom class

Lync 2013

Describes a chat room. A chat room is a topic oriented, access controlled forum for posting real-time messages to be shared with a group of users. Chat rooms optionally support logging of chat history, which is available to members for review or query. To obtain a reference to a ChatRoom, and access other metadata about the chat room, see ChatRoomManagementServices.


Namespace:  Microsoft.Rtc.Collaboration.PersistentChat
Assembly:  Microsoft.Rtc.Collaboration.PersistentChat (in Microsoft.Rtc.Collaboration.PersistentChat.dll)

Public Class ChatRoom
Dim instance As ChatRoom

This class describes the configuration of a chat room. To send and receive messages in a chat room, you must be a member, and join the chat room using BeginJoin(ChatRoomSummary, AsyncCallback, Object). To facilitate this process, ChatRoom supports an implicit conversion to ChatRoomSummary. (See Implicit(ChatRoom to ChatRoomSummary))

Chat rooms belong to a Category, which provides logical groupings of chat rooms, as well as a set of common properties applying to all chat rooms in the category. The category is identified by the ParentCategoryUri.

Each chat room describes its purpose with metadata such as Name and Description. In addition, the chat room has properties which can be set to control its behavior. Permission to join or manage a chat room is controlled by an access control list. Users must be in scope on the Category in order to be added as a member. To find users who are eligible to be granted a specific role on a chat room, see BeginFindUsersOrGroupsForRole(ChatRoomRole, Uri, String, AsyncCallback, Object)

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.