Class RestGuildUser
Represents a REST-based guild user.
Assembly: Discord.Net.Rest.dll​
View Source​
public class RestGuildUser : RestUser, IUpdateable, IGuildUser, IUser, ISnowflakeEntity, IEntity<ulong>, IMentionable, IPresence, IVoiceState
Properties​
Nickname​
Gets the nickname for this user.
View Source​
public string Nickname { get; }
GuildAvatarId​
Gets the guild specific avatar for this users.
View Source​
public string GuildAvatarId { get; }
IsDeafened​
Gets a value that indicates whether this user is deafened by the guild.
View Source​
public bool IsDeafened { get; }
IsMuted​
Gets a value that indicates whether this user is muted (i.e. not permitted to speak via voice) by the guild.
View Source​
public bool IsMuted { get; }
PremiumSince​
Gets the date and time for when this user's guild boost began.
View Source​
public DateTimeOffset? PremiumSince { get; }
GuildId​
Gets the ID of the guild for this user.
View Source​
public ulong GuildId { get; }
IsPending​
Whether the user has passed the guild's Membership Screening requirements.
View Source​
public bool? IsPending { get; }
Hierarchy​
Gets the users position within the role hierarchy.
View Source​
public int Hierarchy { get; }
GuildPermissions​
Gets the guild-level permissions for this user.
View Source​
public GuildPermissions GuildPermissions { get; }
RoleIds​
Gets a collection of IDs for the roles that this user currently possesses in the guild.
View Source​
public IReadOnlyCollection<ulong> RoleIds { get; }
JoinedAt​
Gets when this user joined the guild.
View Source​
public DateTimeOffset? JoinedAt { get; }
IGuildUser.Guild​
Gets the guild for this user.
View Source​
IGuild IGuildUser.Guild { get; }
IVoiceState.IsSelfDeafened​
Gets a value that indicates whether this user has marked themselves as deafened.
View Source​
bool IVoiceState.IsSelfDeafened { get; }
IVoiceState.IsSelfMuted​
Gets a value that indicates whether this user has marked themselves as muted (i.e. not permitted to speak via voice).
View Source​
bool IVoiceState.IsSelfMuted { get; }
IVoiceState.IsSuppressed​
Gets a value that indicates whether the user is muted by the current user.
View Source​
bool IVoiceState.IsSuppressed { get; }
IVoiceState.VoiceChannel​
Gets the voice channel this user is currently in.
View Source​
IVoiceChannel IVoiceState.VoiceChannel { get; }
IVoiceState.VoiceSessionId​
Gets the unique identifier for this user's voice session.
View Source​
string IVoiceState.VoiceSessionId { get; }
IVoiceState.IsStreaming​
Gets a value that indicates if this user is streaming in a voice channel.
View Source​
bool IVoiceState.IsStreaming { get; }
IVoiceState.RequestToSpeakTimestamp​
Gets the time on which the user requested to speak.
View Source​
DateTimeOffset? IVoiceState.RequestToSpeakTimestamp { get; }
Methods​
UpdateAsync(RequestOptions)​
Updates this object's properties with its current state.
View Source​
public override async Task UpdateAsync(RequestOptions options = null)
Returns​
System.Threading.Tasks.Task
Parameters​
| Type | Name | Description |
|---|---|---|
| Discord.RequestOptions | options | The options to be used when sending the request. |
ModifyAsync(Action<GuildUserProperties>, RequestOptions)​
Modifies this user's properties in this guild.
View Source​
public async Task ModifyAsync(Action<GuildUserProperties> func, RequestOptions options = null)
Returns​
System.Threading.Tasks.Task:
A task that represents the asynchronous modification operation.
Parameters​
| Type | Name | Description |
|---|---|---|
System.Action<Discord.GuildUserProperties> | func | The delegate containing the properties to modify the user with. |
| Discord.RequestOptions | options | The options to be used when sending the request. |
KickAsync(String, RequestOptions)​
Kicks this user from this guild.
View Source​
public Task KickAsync(string reason = null, RequestOptions options = null)
Returns​
System.Threading.Tasks.Task:
A task that represents the asynchronous kick operation.
Parameters​
| Type | Name | Description |
|---|---|---|
System.String | reason | The reason for the kick which will be recorded in the audit log. |
| Discord.RequestOptions | options | The options to be used when sending the request. |
AddRoleAsync(UInt64, RequestOptions)​
Adds the specified role to this user in the guild.
View Source​
public Task AddRoleAsync(ulong roleId, RequestOptions options = null)
Returns​
System.Threading.Tasks.Task:
A task that represents the asynchronous role addition operation.
Parameters​
| Type | Name | Description |
|---|---|---|
System.UInt64 | roleId | The role to be added to the user. |
| Discord.RequestOptions | options | The options to be used when sending the request. |
AddRoleAsync(IRole, RequestOptions)​
Adds the specified role to this user in the guild.
View Source​
public Task AddRoleAsync(IRole role, RequestOptions options = null)
Returns​
System.Threading.Tasks.Task:
A task that represents the asynchronous role addition operation.
Parameters​
| Type | Name | Description |
|---|---|---|
| Discord.IRole | role | The role to be added to the user. |
| Discord.RequestOptions | options | The options to be used when sending the request. |
AddRolesAsync(IEnumerable<UInt64>, RequestOptions)​
Adds the specified <code data-dev-comment-type="paramref" class="paramref">roleIds</code> to this user in the guild.
View Source​
public Task AddRolesAsync(IEnumerable<ulong> roleIds, RequestOptions options = null)
Returns​
System.Threading.Tasks.Task:
A task that represents the asynchronous role addition operation.
Parameters​
| Type | Name | Description |
|---|---|---|
System.Collections.Generic.IEnumerable<System.UInt64> | roleIds | The roles to be added to the user. |
| Discord.RequestOptions | options | The options to be used when sending the request. |
AddRolesAsync(IEnumerable<IRole>, RequestOptions)​
Adds the specified <code data-dev-comment-type="paramref" class="paramref">roles</code> to this user in the guild.
View Source​
public Task AddRolesAsync(IEnumerable<IRole> roles, RequestOptions options = null)
Returns​
System.Threading.Tasks.Task:
A task that represents the asynchronous role addition operation.
Parameters​
| Type | Name | Description |
|---|---|---|
System.Collections.Generic.IEnumerable<Discord.IRole> | roles | The roles to be added to the user. |
| Discord.RequestOptions | options | The options to be used when sending the request. |
RemoveRoleAsync(UInt64, RequestOptions)​
Removes the specified <code data-dev-comment-type="paramref" class="paramref">roleId</code> from this user in the guild.
View Source​
public Task RemoveRoleAsync(ulong roleId, RequestOptions options = null)
Returns​
System.Threading.Tasks.Task:
A task that represents the asynchronous role removal operation.
Parameters​
| Type | Name | Description |
|---|---|---|
System.UInt64 | roleId | The role to be removed from the user. |
| Discord.RequestOptions | options | The options to be used when sending the request. |
RemoveRoleAsync(IRole, RequestOptions)​
Removes the specified <code data-dev-comment-type="paramref" class="paramref">role</code> from this user in the guild.
View Source​
public Task RemoveRoleAsync(IRole role, RequestOptions options = null)
Returns​
System.Threading.Tasks.Task:
A task that represents the asynchronous role removal operation.
Parameters​
| Type | Name | Description |
|---|---|---|
| Discord.IRole | role | The role to be removed from the user. |
| Discord.RequestOptions | options | The options to be used when sending the request. |
RemoveRolesAsync(IEnumerable<UInt64>, RequestOptions)​
Removes the specified <code data-dev-comment-type="paramref" class="paramref">roleIds</code> from this user in the guild.
View Source​
public Task RemoveRolesAsync(IEnumerable<ulong> roleIds, RequestOptions options = null)
Returns​
System.Threading.Tasks.Task:
A task that represents the asynchronous role removal operation.
Parameters​
| Type | Name | Description |
|---|---|---|
System.Collections.Generic.IEnumerable<System.UInt64> | roleIds | The roles to be removed from the user. |
| Discord.RequestOptions | options | The options to be used when sending the request. |
RemoveRolesAsync(IEnumerable<IRole>, RequestOptions)​
Removes the specified <code data-dev-comment-type="paramref" class="paramref">roles</code> from this user in the guild.
View Source​
public Task RemoveRolesAsync(IEnumerable<IRole> roles, RequestOptions options = null)
Returns​
System.Threading.Tasks.Task:
A task that represents the asynchronous role removal operation.
Parameters​
| Type | Name | Description |
|---|---|---|
System.Collections.Generic.IEnumerable<Discord.IRole> | roles | The roles to be removed from the user. |
| Discord.RequestOptions | options | The options to be used when sending the request. |
GetPermissions(IGuildChannel)​
Gets the level permissions granted to this user to a given channel.
View Source​
public ChannelPermissions GetPermissions(IGuildChannel channel)
Returns​
Discord.ChannelPermissions: A Discord.ChannelPermissions structure representing the permissions that a user has in the specified channel.
Parameters​
| Type | Name | Description |
|---|---|---|
| Discord.IGuildChannel | channel | The channel to get the permission from. |
GetGuildAvatarUrl(ImageFormat, UInt16)​
View Source​
public string GetGuildAvatarUrl(ImageFormat format = ImageFormat.Auto, ushort size = 128)
Returns​
System.String
Parameters​
| Type | Name |
|---|---|
| Discord.ImageFormat | format |
System.UInt16 | size |