Managing Properties of a Chat Room Category

To modify the properties of a category, use the BeginUpdateChatRoomCategory(ChatRoomCategoryInformation, AsyncCallback, Object) method.

This method accepts an instance of ChatRoomCategoryInformation that can be constructed using a current instance of the ChatRoomCategory object. The properties described in the following table define all chat room categories:

Property	Description	Default Value
Name	A short, unique string that identifies the purpose of the category.	User defined
Description	(Optional) Provides additional details about the purpose of this category.	Null
CategoryUri	Provides a unique key for identifying a category. The URI is generated by the Group Chat Server when the category is created, and is never changed.	Read-only, system defined
ParentCategoryUri	The URI of the parent category of this category.	User defined
ChangeHistory	Provides time and user information about the creation and last modification of the category.	Read-only, system defined
FileStoreUri	Provides the address of the Web service where the files will be uploaded to when posted to the category.	Read-only, system defined
CreateNewMemberList	Indicates if the chat room overrides the membership list of its parent category.	False
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 is visible only 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 upload is not permitted.	Inherit/True*
CategoryMembersCanCreateChatRooms	Indicates if category members can create chat rooms and subcategories in this category.	Inherit/True*
ChildrenMustInheritProperties	Indicates if the various properties on child nodes will be read-only. This setting affects the following properties of all child nodes: VisibleOnlyToMembers SendInvitationsToMembers LogChatHistory AllowFileUpload CategoryMembersCanCreateChatRooms AllowSubcategoryScopeChanges ChildrenMustInheritProperties	Inherit/False*
AllowSubcategoryScopeChanges	Indicates if the scope of subcategories can be changed.	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 .