Managing Properties of a Chat Room

To modify the properties of a chat room, use the BeginUpdateChatRoom(ChatRoomInformation, AsyncCallback, Object) method. This method accepts an instance of ChatRoomInformation , which can be constructed using a current instance of the ChatRoom object. The following properties are defined for all chat rooms:

Property	Description	Default Value
Name	A short, unique name which identifies the purpose of the room.	User defined
Topic	An optional one-sentence description of the chat room.	Null
Description	(Optional) Provides additional details about the purpose of the chat room.	Null
ChatRoomUri	Provides a unique key for identifying a chat room. The URI is generated by the Group Chat Server when the chat room is created, and is never changed.	Read-only, system defined
ParentCategoryUri	The URI of the parent category of the chat room.	User defined
ChangeHistory	Provides time and user information about the creation and last modification of the chat room.	Read-only, system defined
FileStoreUri	The address of the Web service that the files will be uploaded to when posted to the chat room	Read-only, system defined
CreateNewMemberList	Indicates whether the chat room overrides the membership list of its parent category.	False
IsDisabled	Prevents users from joining the chat room, or reading chat history.	False
IsAuditorium	Indicates that the chat room is an auditorium-style room. When true , only those users who are on the presenters list may post messages. Other members of the chat room can read the messages and chat history, but may not participate in the conversation. When false , any user who is a member of the chat room may post messages.	False
AddIn	A Web page that can be embedded in a chat room and displayed in a panel below the chat area of the Group Chat client.	Null
VisibleOnlyToMembers	Defines the behavior of searches, in which a user queries the system for chat rooms matching a certain criteria. When false , the chat room is visible to all users in scope on the parent category. If changed to true , the chat room will only be visible to its members.	Inherit/False*
SendInvitationsToMembers	Indicates if invitations are issued by the Group Chat Server when a user connects, and subsequently when a new user is added to the member list.	Inherit/False*
LogChatHistory	Indicates if messages posted to the chat room are stored on the server, and may be reviewed or queried by members.	Inherit/True*
AllowFileUpload	Indicates if files may be posted to the chat room. When false , file uploading is not permitted.	Inherit/True*

Note
Properties marked with an asterisk (*) are "inherited", and have a default value of null. These properties derive their value from the parent category value. The local value can be explicitly set on any child node to hide the parent value and break the inheritance chain. This option is not available if the parent category sets the ChildrenMustInheritPropertiesproperty to true . For more information, see InheritedChatRoomProperty .

Note

Properties marked with an asterisk (*) are "inherited", and have a default value of null. These properties derive their value from the parent category value. The local value can be explicitly set on any child node to hide the parent value and break the inheritance chain. This option is not available if the parent category sets the ChildrenMustInheritPropertiesproperty to true . For more information, see InheritedChatRoomProperty .