Changes the name of a Room.

Namespace: Sfs2X.Requests
Assembly: SmartFox2X (in SmartFox2X.dll) Version: (1.7.0)


public class ChangeRoomNameRequest : BaseRequest


If the renaming operation is successful, the ROOM_NAME_CHANGE event is dispatched to all the users who subscribed the Group to which the target Room belongs, including the user who renamed it. If the user is not the creator (owner) of the Room, or if the Room was configured so that renaming is not allowed (see the RoomSettings.Permissions parameter), the ROOM_NAME_CHANGE_ERROR event if fired. An administrator or moderator can override the first constrain (he is not requested to be the Room's owner).


The following example renames an existing Room:
 Copy imageCopy
void SomeMethod() {
    sfs.AddEventListener(SFSEvent.ROOM_NAME_CHANGE, OnRoomNameChange);
    sfs.AddEventListener(SFSEvent.ROOM_NAME_CHANGE_ERROR, OnRoomNameChangeError);
    Room theRoom = sfs.GetRoomByName("Gonzo's Room");
    sfs.Send( new ChangeRoomNameRequest(theRoom, "Gonzo The Great's Room") );
void OnRoomNameChange(BaseEvent evt) {
    Room theRoom = (Room)evt.Params["room"];
    Console.WriteLine("Room " + (string)evt.Params["oldName"] + " was successfully renamed to " + theRoom.Name);                        // .Net / Unity
    System.Diagnostics.Debug.WriteLine("Room " + (string)evt.Params["oldName"] + " was successfully renamed to " + theRoom.Name);       // Windows Universal
void OnRoomNameChangeError(BaseEvent evt) {
    Console.WriteLine("Room name change failed: " + (string)evt.Params["errorMessage"]);                        // .Net / Unity
    System.Diagnostics.Debug.WriteLine("Room name change failed: " + (string)evt.Params["errorMessage"]);       // Windows Universal

Inheritance Hierarchy


See Also