This documentation is archived and is not being maintained.

Creating, Disabling, and Deleting Chat Rooms and Chat Room Categories

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

You can create, disable, and delete chat rooms and categories using the procedures described in the following table.

Task

Procedure

Create chat rooms

  1. Select a parent category for the chat room. If necessary, browse for categories where chat room creation is permitted using BeginFindCategoriesWithCreateRights(AsyncCallback, Object).

  2. Construct an instance of ChatRoomSettings.

  3. When possible, maintain the null value for each property that accepts a bool? nullable type. When this value is null, the chat room inherits the parent category value.

  4. Invoke BeginCreateChatRoom(ChatRoomSettings, AsyncCallback, Object).

Create chat room categories

  1. Select a parent category for the category. If necessary, use the BeginFindCategoriesWithCreateRights(AsyncCallback, Object) method to browse for categories where chat room creation is permitted.

  2. Construct an instance of ChatRoomCategorySettings.

  3. When possible, maintain the null value for each property that accepts a bool? nullable type. When this value is null, the chat room inherits the parent category value.

  4. Invoke BeginCreateChatRoomCategory(ChatRoomCategorySettings, AsyncCallback, Object).

Disabling a chat room

  • Chat rooms cannot be deleted once they have been created. The only option is to disable the chat room by updating the chat room properties, and setting the IsDisabled property to true.

Deleting a chat room category

Before you can delete a category, you must delete or move all child nodes from the category.

  1. Use the BeginChangeParentCategory(ChatRoomCategory, Uri, AsyncCallback, Object) method to move nodes.

  2. Use the BeginDeleteChatRoomCategory(ChatRoomCategory, AsyncCallback, Object) method to delete an empty category.

Show: