- Because DocFX sucks at rendering langwordpull/1161/head
| @@ -19,7 +19,7 @@ namespace Discord | |||||
| public string ImageId { get; internal set; } | public string ImageId { get; internal set; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Returns the image URL of the asset, or <see langword="null"/> when the application ID does not exist. | |||||
| /// Returns the image URL of the asset, or <c>null</c> when the application ID does not exist. | |||||
| /// </summary> | /// </summary> | ||||
| public string GetImageUrl(ImageFormat format = ImageFormat.Auto, ushort size = 128) | public string GetImageUrl(ImageFormat format = ImageFormat.Auto, ushort size = 128) | ||||
| => ApplicationId.HasValue ? CDN.GetRichAssetUrl(ApplicationId.Value, ImageId, size, format) : null; | => ApplicationId.HasValue ? CDN.GetRichAssetUrl(ApplicationId.Value, ImageId, size, format) : null; | ||||
| @@ -24,7 +24,7 @@ namespace Discord | |||||
| /// Gets the parent ID (category) of this channel in the guild's channel list. | /// Gets the parent ID (category) of this channel in the guild's channel list. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// The parent category ID associated with this channel, or <see langword="null"/> if none is set. | |||||
| /// The parent category ID associated with this channel, or <c>null</c> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| ulong? CategoryId { get; } | ulong? CategoryId { get; } | ||||
| /// <summary> | /// <summary> | ||||
| @@ -57,10 +57,10 @@ namespace Discord | |||||
| /// Creates a new invite to this channel. | /// Creates a new invite to this channel. | ||||
| /// </summary> | /// </summary> | ||||
| /// <param name="maxAge"> | /// <param name="maxAge"> | ||||
| /// The time (in seconds) until the invite expires. Set to <see langword="null"/> to never expire. | |||||
| /// The time (in seconds) until the invite expires. Set to <c>null</c> to never expire. | |||||
| /// </param> | /// </param> | ||||
| /// <param name="maxUses"> | /// <param name="maxUses"> | ||||
| /// The max amount of times this invite may be used. Set to <see langword="null"/> to have unlimited uses. | |||||
| /// The max amount of times this invite may be used. Set to <c>null</c> to have unlimited uses. | |||||
| /// </param> | /// </param> | ||||
| /// <param name="isTemporary"> | /// <param name="isTemporary"> | ||||
| /// If <see langword="true"/>, a user accepting this invite will be kicked from the guild after closing their client. | /// If <see langword="true"/>, a user accepting this invite will be kicked from the guild after closing their client. | ||||
| @@ -86,12 +86,12 @@ namespace Discord | |||||
| Task ModifyAsync(Action<GuildChannelProperties> func, RequestOptions options = null); | Task ModifyAsync(Action<GuildChannelProperties> func, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the permission overwrite for a specific role, or <see langword="null"/> if one does not exist. | |||||
| /// Gets the permission overwrite for a specific role, or <c>null</c> if one does not exist. | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="role">The role to get the overwrite from.</param> | /// <param name="role">The role to get the overwrite from.</param> | ||||
| OverwritePermissions? GetPermissionOverwrite(IRole role); | OverwritePermissions? GetPermissionOverwrite(IRole role); | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the permission overwrite for a specific user, or <see langword="null"/> if one does not exist. | |||||
| /// Gets the permission overwrite for a specific user, or <c>null</c> if one does not exist. | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="user">The user to get the overwrite from.</param> | /// <param name="user">The user to get the overwrite from.</param> | ||||
| OverwritePermissions? GetPermissionOverwrite(IUser user); | OverwritePermissions? GetPermissionOverwrite(IUser user); | ||||
| @@ -60,13 +60,13 @@ namespace Discord | |||||
| Task<IUserMessage> SendFileAsync(Stream stream, string filename, string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null); | Task<IUserMessage> SendFileAsync(Stream stream, string filename, string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets a message from this message channel with the given id, or <see langword="null"/> if not found. | |||||
| /// Gets a message from this message channel with the given id, or <c>null</c> if not found. | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The ID of the message.</param> | /// <param name="id">The ID of the message.</param> | ||||
| /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param> | /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// The message gotten from either the cache or the download, or <see langword="null"/> if none is found. | |||||
| /// The message gotten from either the cache or the download, or <c>null</c> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IMessage> GetMessageAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<IMessage> GetMessageAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| @@ -22,7 +22,7 @@ namespace Discord | |||||
| /// Gets the current topic for this text channel. | /// Gets the current topic for this text channel. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// The topic set in the channel, or <see langword="null"/> if none is set. | |||||
| /// The topic set in the channel, or <c>null</c> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| string Topic { get; } | string Topic { get; } | ||||
| @@ -72,7 +72,7 @@ namespace Discord | |||||
| /// <param name="id">The ID of the webhook.</param> | /// <param name="id">The ID of the webhook.</param> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A webhook associated with the <paramref name="id"/>, or <see langword="null"/> if not found. | |||||
| /// A webhook associated with the <paramref name="id"/>, or <c>null</c> if not found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IWebhook> GetWebhookAsync(ulong id, RequestOptions options = null); | Task<IWebhook> GetWebhookAsync(ulong id, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -14,7 +14,7 @@ namespace Discord | |||||
| int Bitrate { get; } | int Bitrate { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the max amount of users allowed to be connected to this channel at one time, or | /// Gets the max amount of users allowed to be connected to this channel at one time, or | ||||
| /// <see langword="null"/> if none is set. | |||||
| /// <c>null</c> if none is set. | |||||
| /// </summary> | /// </summary> | ||||
| int? UserLimit { get; } | int? UserLimit { get; } | ||||
| @@ -10,7 +10,7 @@ namespace Discord | |||||
| /// </summary> | /// </summary> | ||||
| public Optional<int> Bitrate { get; set; } | public Optional<int> Bitrate { get; set; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets or sets the maximum number of users that can be present in a channel, or <see langword="null"/> if none. | |||||
| /// Gets or sets the maximum number of users that can be present in a channel, or <c>null</c> if none. | |||||
| /// </summary> | /// </summary> | ||||
| public Optional<int?> UserLimit { get; set; } | public Optional<int?> UserLimit { get; set; } | ||||
| } | } | ||||
| @@ -10,11 +10,11 @@ namespace Discord | |||||
| /// </summary> | /// </summary> | ||||
| public Optional<bool> Enabled { get; set; } | public Optional<bool> Enabled { get; set; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Sets the channel that the invite should place its users in, if not <see langword="null"/>. | |||||
| /// Sets the channel that the invite should place its users in, if not <c>null</c>. | |||||
| /// </summary> | /// </summary> | ||||
| public Optional<IChannel> Channel { get; set; } | public Optional<IChannel> Channel { get; set; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Sets the channel the invite should place its users in, if not <see langword="null"/>. | |||||
| /// Sets the channel the invite should place its users in, if not <c>null</c>. | |||||
| /// </summary> | /// </summary> | ||||
| public Optional<ulong?> ChannelId { get; set; } | public Optional<ulong?> ChannelId { get; set; } | ||||
| } | } | ||||
| @@ -40,19 +40,19 @@ namespace Discord | |||||
| /// </summary> | /// </summary> | ||||
| VerificationLevel VerificationLevel { get; } | VerificationLevel VerificationLevel { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Returns the ID of this guild's icon, or <see langword="null"/> if none is set. | |||||
| /// Returns the ID of this guild's icon, or <c>null</c> if none is set. | |||||
| /// </summary> | /// </summary> | ||||
| string IconId { get; } | string IconId { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Returns the URL of this guild's icon, or <see langword="null"/> if none is set. | |||||
| /// Returns the URL of this guild's icon, or <c>null</c> if none is set. | |||||
| /// </summary> | /// </summary> | ||||
| string IconUrl { get; } | string IconUrl { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Returns the ID of this guild's splash image, or <see langword="null"/> if none is set. | |||||
| /// Returns the ID of this guild's splash image, or <c>null</c> if none is set. | |||||
| /// </summary> | /// </summary> | ||||
| string SplashId { get; } | string SplashId { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Returns the URL of this guild's splash image, or <see langword="null"/> if none is set. | |||||
| /// Returns the URL of this guild's splash image, or <c>null</c> if none is set. | |||||
| /// </summary> | /// </summary> | ||||
| string SplashUrl { get; } | string SplashUrl { get; } | ||||
| /// <summary> | /// <summary> | ||||
| @@ -65,7 +65,7 @@ namespace Discord | |||||
| bool Available { get; } | bool Available { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the ID of the AFK voice channel for this guild, or <see langword="null"/> if none is set. | |||||
| /// Gets the ID of the AFK voice channel for this guild, or <c>null</c> if none is set. | |||||
| /// </summary> | /// </summary> | ||||
| ulong? AFKChannelId { get; } | ulong? AFKChannelId { get; } | ||||
| /// <summary> | /// <summary> | ||||
| @@ -73,11 +73,11 @@ namespace Discord | |||||
| /// </summary> | /// </summary> | ||||
| ulong DefaultChannelId { get; } | ulong DefaultChannelId { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the ID of the embed channel set in the widget settings of this guild, or <see langword="null"/> if none is set. | |||||
| /// Gets the ID of the embed channel set in the widget settings of this guild, or <c>null</c> if none is set. | |||||
| /// </summary> | /// </summary> | ||||
| ulong? EmbedChannelId { get; } | ulong? EmbedChannelId { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the ID of the channel where randomized welcome messages are sent, or <see langword="null"/> if none is set. | |||||
| /// Gets the ID of the channel where randomized welcome messages are sent, or <c>null</c> if none is set. | |||||
| /// </summary> | /// </summary> | ||||
| ulong? SystemChannelId { get; } | ulong? SystemChannelId { get; } | ||||
| /// <summary> | /// <summary> | ||||
| @@ -245,7 +245,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// An awaitable <see cref="Task"/> containing the generic channel with the specified ID, or | /// An awaitable <see cref="Task"/> containing the generic channel with the specified ID, or | ||||
| /// <see langword="null"/> if none is found. | |||||
| /// <c>null</c> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IGuildChannel> GetChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<IGuildChannel> GetChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -269,7 +269,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// An awaitable <see cref="Task"/> containing the text channel with the specified ID, or | /// An awaitable <see cref="Task"/> containing the text channel with the specified ID, or | ||||
| /// <see langword="null"/> if none is found. | |||||
| /// <c>null</c> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<ITextChannel> GetTextChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<ITextChannel> GetTextChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -304,7 +304,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// An awaitable <see cref="Task"/> containing the voice channel with the specified ID, or | /// An awaitable <see cref="Task"/> containing the voice channel with the specified ID, or | ||||
| /// <see langword="null"/> if none is found. | |||||
| /// <c>null</c> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IVoiceChannel> GetVoiceChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<IVoiceChannel> GetVoiceChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -316,7 +316,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// An awaitable <see cref="Task"/> containing the AFK voice channel set within this guild, or | /// An awaitable <see cref="Task"/> containing the AFK voice channel set within this guild, or | ||||
| /// <see langword="null"/> if none is set. | |||||
| /// <c>null</c> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IVoiceChannel> GetAFKChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<IVoiceChannel> GetAFKChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -340,7 +340,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// An awaitable <see cref="Task"/> containing the first viewable text channel in this guild, or | /// An awaitable <see cref="Task"/> containing the first viewable text channel in this guild, or | ||||
| /// <see langword="null"/> if none is found. | |||||
| /// <c>null</c> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<ITextChannel> GetDefaultChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<ITextChannel> GetDefaultChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -352,7 +352,7 @@ namespace Discord | |||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// An awaitable <see cref="Task"/> containing the embed channel set within the server's widget settings, or | /// An awaitable <see cref="Task"/> containing the embed channel set within the server's widget settings, or | ||||
| /// <see langword="null"/> if none is set. | |||||
| /// <c>null</c> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IGuildChannel> GetEmbedChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<IGuildChannel> GetEmbedChannelAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -392,7 +392,7 @@ namespace Discord | |||||
| Task<IReadOnlyCollection<IInviteMetadata>> GetInvitesAsync(RequestOptions options = null); | Task<IReadOnlyCollection<IInviteMetadata>> GetInvitesAsync(RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the role in this guild with the provided ID, or <see langword="null"/> if not found. | |||||
| /// Gets the role in this guild with the provided ID, or <c>null</c> if not found. | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The role ID.</param> | /// <param name="id">The role ID.</param> | ||||
| IRole GetRole(ulong id); | IRole GetRole(ulong id); | ||||
| @@ -424,13 +424,13 @@ namespace Discord | |||||
| /// </remarks> | /// </remarks> | ||||
| Task<IReadOnlyCollection<IGuildUser>> GetUsersAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<IReadOnlyCollection<IGuildUser>> GetUsersAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the user in this guild with the provided ID, or <see langword="null"/> if not found. | |||||
| /// Gets the user in this guild with the provided ID, or <c>null</c> if not found. | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The user ID.</param> | /// <param name="id">The user ID.</param> | ||||
| /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param> | /// <param name="mode">The <see cref="CacheMode"/> that determines whether the object should be fetched from cache.</param> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// An awaitable <see cref="Task"/> containing the guild user with the specified ID, otherwise <see langword="null"/>. | |||||
| /// An awaitable <see cref="Task"/> containing the guild user with the specified ID, otherwise <c>null</c>. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IGuildUser> GetUserAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | Task<IGuildUser> GetUserAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -472,12 +472,12 @@ namespace Discord | |||||
| Task<int> PruneUsersAsync(int days = 30, bool simulate = false, RequestOptions options = null); | Task<int> PruneUsersAsync(int days = 30, bool simulate = false, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the webhook in this guild with the provided ID, or <see langword="null"/> if not found. | |||||
| /// Gets the webhook in this guild with the provided ID, or <c>null</c> if not found. | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The webhook ID.</param> | /// <param name="id">The webhook ID.</param> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// An awaitable <see cref="Task"/> containing the webhook with the specified ID, otherwise <see langword="null"/>. | |||||
| /// An awaitable <see cref="Task"/> containing the webhook with the specified ID, otherwise <c>null</c>. | |||||
| /// </returns> | /// </returns> | ||||
| Task<IWebhook> GetWebhookAsync(ulong id, RequestOptions options = null); | Task<IWebhook> GetWebhookAsync(ulong id, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -495,7 +495,7 @@ namespace Discord | |||||
| /// <param name="id">The guild emote ID.</param> | /// <param name="id">The guild emote ID.</param> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// An awaitable <see cref="Task"/> containing the emote found with the specified ID, or <see langword="null"/> if not found. | |||||
| /// An awaitable <see cref="Task"/> containing the emote found with the specified ID, or <c>null</c> if not found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<GuildEmote> GetEmoteAsync(ulong id, RequestOptions options = null); | Task<GuildEmote> GetEmoteAsync(ulong id, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -7,7 +7,7 @@ namespace Discord | |||||
| /// </summary> | /// </summary> | ||||
| string Name { get; } | string Name { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the icon URL associated with this guild, or <see langword="null"/> if one is not set. | |||||
| /// Gets the icon URL associated with this guild, or <c>null</c> if one is not set. | |||||
| /// </summary> | /// </summary> | ||||
| string IconUrl { get; } | string IconUrl { get; } | ||||
| /// <summary> | /// <summary> | ||||
| @@ -19,11 +19,11 @@ namespace Discord | |||||
| /// </summary> | /// </summary> | ||||
| bool IsTemporary { get; } | bool IsTemporary { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the time (in seconds) until the invite expires, or <see langword="null"/> if it never expires. | |||||
| /// Gets the time (in seconds) until the invite expires, or <c>null</c> if it never expires. | |||||
| /// </summary> | /// </summary> | ||||
| int? MaxAge { get; } | int? MaxAge { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the max amount of times this invite may be used, or <see langword="null"/> if there is no limit. | |||||
| /// Gets the max amount of times this invite may be used, or <c>null</c> if there is no limit. | |||||
| /// </summary> | /// </summary> | ||||
| int? MaxUses { get; } | int? MaxUses { get; } | ||||
| /// <summary> | /// <summary> | ||||
| @@ -106,7 +106,7 @@ namespace Discord | |||||
| /// <summary> Gets or sets the list of <see cref="EmbedFieldBuilder"/> of an <see cref="Embed"/>. </summary> | /// <summary> Gets or sets the list of <see cref="EmbedFieldBuilder"/> of an <see cref="Embed"/>. </summary> | ||||
| /// <exception cref="ArgumentNullException" accessor="set">An embed builder's fields collection is set to | /// <exception cref="ArgumentNullException" accessor="set">An embed builder's fields collection is set to | ||||
| /// <see langword="null"/>.</exception> | |||||
| /// <c>null</c>.</exception> | |||||
| /// <exception cref="ArgumentException" accessor="set">Description length exceeds <see cref="MaxFieldCount"/>. | /// <exception cref="ArgumentException" accessor="set">Description length exceeds <see cref="MaxFieldCount"/>. | ||||
| /// </exception> | /// </exception> | ||||
| /// <returns> The list of existing <see cref="EmbedFieldBuilder"/>.</returns> | /// <returns> The list of existing <see cref="EmbedFieldBuilder"/>.</returns> | ||||
| @@ -13,11 +13,11 @@ namespace Discord | |||||
| /// </summary> | /// </summary> | ||||
| public string Url { get; } | public string Url { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the height of the video, or <see langword="null"/> if none. | |||||
| /// Gets the height of the video, or <c>null</c> if none. | |||||
| /// </summary> | /// </summary> | ||||
| public int? Height { get; } | public int? Height { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the weight of the video, or <see langword="null"/> if none. | |||||
| /// Gets the weight of the video, or <c>null</c> if none. | |||||
| /// </summary> | /// </summary> | ||||
| public int? Width { get; } | public int? Width { get; } | ||||
| @@ -45,14 +45,14 @@ namespace Discord | |||||
| /// Gets the height of this attachment. | /// Gets the height of this attachment. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// The height of this attachment if it is a picture; otherwise <see langword="null"/>. | |||||
| /// The height of this attachment if it is a picture; otherwise <c>null</c>. | |||||
| /// </returns> | /// </returns> | ||||
| int? Height { get; } | int? Height { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the width of this attachment. | /// Gets the width of this attachment. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// The width of this attachment if it is a picture; otherwise <see langword="null"/>. | |||||
| /// The width of this attachment if it is a picture; otherwise <c>null</c>. | |||||
| /// </returns> | /// </returns> | ||||
| int? Width { get; } | int? Width { get; } | ||||
| } | } | ||||
| @@ -39,7 +39,7 @@ namespace Discord | |||||
| /// Gets the time of this message's last edit. | /// Gets the time of this message's last edit. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// Time of when the message was last edited; <see langword="null"/> when the message is never edited. | |||||
| /// Time of when the message was last edited; <c>null</c> when the message is never edited. | |||||
| /// </returns> | /// </returns> | ||||
| DateTimeOffset? EditedTimestamp { get; } | DateTimeOffset? EditedTimestamp { get; } | ||||
| @@ -26,7 +26,7 @@ namespace Discord | |||||
| /// </summary> | /// </summary> | ||||
| bool IsSuppressed { get; } | bool IsSuppressed { get; } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the voice channel this user is currently in, or <see langword="null"/> if none. | |||||
| /// Gets the voice channel this user is currently in, or <c>null</c> if none. | |||||
| /// </summary> | /// </summary> | ||||
| IVoiceChannel VoiceChannel { get; } | IVoiceChannel VoiceChannel { get; } | ||||
| /// <summary> | /// <summary> | ||||
| @@ -23,7 +23,7 @@ namespace Discord.Net | |||||
| /// <returns> | /// <returns> | ||||
| /// A | /// A | ||||
| /// <see href="https://discordapp.com/developers/docs/topics/opcodes-and-status-codes#json">JSON error code</see> | /// <see href="https://discordapp.com/developers/docs/topics/opcodes-and-status-codes#json">JSON error code</see> | ||||
| /// from Discord, or <see langword="null"/> if none. | |||||
| /// from Discord, or <c>null</c> if none. | |||||
| /// </returns> | /// </returns> | ||||
| public int? DiscordCode { get; } | public int? DiscordCode { get; } | ||||
| /// <summary> | /// <summary> | ||||
| @@ -14,7 +14,7 @@ namespace Discord | |||||
| /// <summary> | /// <summary> | ||||
| /// Gets or set the max time, in milliseconds, to wait for this request to complete. If | /// Gets or set the max time, in milliseconds, to wait for this request to complete. If | ||||
| /// <see langword="null"/>, a request will not time out. If a rate limit has been triggered for this | |||||
| /// <c>null</c>, a request will not time out. If a rate limit has been triggered for this | |||||
| /// request's bucket and will not be unpaused in time, this request will fail immediately. | /// request's bucket and will not be unpaused in time, this request will fail immediately. | ||||
| /// </summary> | /// </summary> | ||||
| public int? Timeout { get; set; } | public int? Timeout { get; set; } | ||||
| @@ -25,7 +25,7 @@ namespace Discord | |||||
| /// </summary> | /// </summary> | ||||
| /// <remarks> | /// <remarks> | ||||
| /// This value is not guaranteed to be set; in cases where the entity cannot be pulled from cache, it is | /// This value is not guaranteed to be set; in cases where the entity cannot be pulled from cache, it is | ||||
| /// <see langword="null"/>. | |||||
| /// <c>null</c>. | |||||
| /// </remarks> | /// </remarks> | ||||
| public TEntity Value { get; } | public TEntity Value { get; } | ||||
| private Func<Task<TEntity>> DownloadFunc { get; } | private Func<Task<TEntity>> DownloadFunc { get; } | ||||
| @@ -157,7 +157,7 @@ namespace Discord | |||||
| : this(collection, EqualityComparer<T>.Default) { } | : this(collection, EqualityComparer<T>.Default) { } | ||||
| public ConcurrentHashSet(IEqualityComparer<T> comparer) | public ConcurrentHashSet(IEqualityComparer<T> comparer) | ||||
| : this(DefaultConcurrencyLevel, DefaultCapacity, true, comparer) { } | : this(DefaultConcurrencyLevel, DefaultCapacity, true, comparer) { } | ||||
| /// <exception cref="ArgumentNullException"><paramref name="collection"/> is <see langword="null"/></exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="collection"/> is <c>null</c></exception> | |||||
| public ConcurrentHashSet(IEnumerable<T> collection, IEqualityComparer<T> comparer) | public ConcurrentHashSet(IEnumerable<T> collection, IEqualityComparer<T> comparer) | ||||
| : this(comparer) | : this(comparer) | ||||
| { | { | ||||
| @@ -210,7 +210,7 @@ namespace Discord | |||||
| if (_budget == 0) | if (_budget == 0) | ||||
| _budget = _tables._buckets.Length / _tables._locks.Length; | _budget = _tables._buckets.Length / _tables._locks.Length; | ||||
| } | } | ||||
| /// <exception cref="ArgumentNullException"><paramref name="value"/> is <see langword="null"/></exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="value"/> is <c>null</c></exception> | |||||
| public bool ContainsKey(T value) | public bool ContainsKey(T value) | ||||
| { | { | ||||
| if (value == null) throw new ArgumentNullException(nameof(value)); | if (value == null) throw new ArgumentNullException(nameof(value)); | ||||
| @@ -234,7 +234,7 @@ namespace Discord | |||||
| return false; | return false; | ||||
| } | } | ||||
| /// <exception cref="ArgumentNullException"><paramref name="value"/> is <see langword="null"/></exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="value"/> is <c>null</c></exception> | |||||
| public bool TryAdd(T value) | public bool TryAdd(T value) | ||||
| { | { | ||||
| if (value == null) throw new ArgumentNullException(nameof(value)); | if (value == null) throw new ArgumentNullException(nameof(value)); | ||||
| @@ -284,7 +284,7 @@ namespace Discord | |||||
| } | } | ||||
| } | } | ||||
| /// <exception cref="ArgumentNullException"><paramref name="value"/> is <see langword="null"/></exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="value"/> is <c>null</c></exception> | |||||
| public bool TryRemove(T value) | public bool TryRemove(T value) | ||||
| { | { | ||||
| if (value == null) throw new ArgumentNullException(nameof(value)); | if (value == null) throw new ArgumentNullException(nameof(value)); | ||||
| @@ -59,12 +59,12 @@ namespace Discord.Rest | |||||
| new Task<RestUserMessage> SendFileAsync(Stream stream, string filename, string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null); | new Task<RestUserMessage> SendFileAsync(Stream stream, string filename, string text = null, bool isTTS = false, Embed embed = null, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets a message from this message channel with the given id, or <see langword="null"/> if not found. | |||||
| /// Gets a message from this message channel with the given id, or <c>null</c> if not found. | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The ID of the message.</param> | /// <param name="id">The ID of the message.</param> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// The message gotten from either the cache or the download, or <see langword="null"/> if none is found. | |||||
| /// The message gotten from either the cache or the download, or <c>null</c> if none is found. | |||||
| /// </returns> | /// </returns> | ||||
| Task<RestMessage> GetMessageAsync(ulong id, RequestOptions options = null); | Task<RestMessage> GetMessageAsync(ulong id, RequestOptions options = null); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -14,7 +14,7 @@ namespace Discord.Rest | |||||
| internal static class GuildHelper | internal static class GuildHelper | ||||
| { | { | ||||
| //General | //General | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| public static async Task<Model> ModifyAsync(IGuild guild, BaseDiscordClient client, | public static async Task<Model> ModifyAsync(IGuild guild, BaseDiscordClient client, | ||||
| Action<GuildProperties> func, RequestOptions options) | Action<GuildProperties> func, RequestOptions options) | ||||
| { | { | ||||
| @@ -62,7 +62,7 @@ namespace Discord.Rest | |||||
| return await client.ApiClient.ModifyGuildAsync(guild.Id, apiArgs, options).ConfigureAwait(false); | return await client.ApiClient.ModifyGuildAsync(guild.Id, apiArgs, options).ConfigureAwait(false); | ||||
| } | } | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| public static async Task<EmbedModel> ModifyEmbedAsync(IGuild guild, BaseDiscordClient client, | public static async Task<EmbedModel> ModifyEmbedAsync(IGuild guild, BaseDiscordClient client, | ||||
| Action<GuildEmbedProperties> func, RequestOptions options) | Action<GuildEmbedProperties> func, RequestOptions options) | ||||
| { | { | ||||
| @@ -140,7 +140,7 @@ namespace Discord.Rest | |||||
| var models = await client.ApiClient.GetGuildChannelsAsync(guild.Id, options).ConfigureAwait(false); | var models = await client.ApiClient.GetGuildChannelsAsync(guild.Id, options).ConfigureAwait(false); | ||||
| return models.Select(x => RestGuildChannel.Create(client, guild, x)).ToImmutableArray(); | return models.Select(x => RestGuildChannel.Create(client, guild, x)).ToImmutableArray(); | ||||
| } | } | ||||
| /// <exception cref="ArgumentNullException"><paramref name="name"/> is <see langword="null"/>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception> | |||||
| public static async Task<RestTextChannel> CreateTextChannelAsync(IGuild guild, BaseDiscordClient client, | public static async Task<RestTextChannel> CreateTextChannelAsync(IGuild guild, BaseDiscordClient client, | ||||
| string name, RequestOptions options) | string name, RequestOptions options) | ||||
| { | { | ||||
| @@ -150,7 +150,7 @@ namespace Discord.Rest | |||||
| var model = await client.ApiClient.CreateGuildChannelAsync(guild.Id, args, options).ConfigureAwait(false); | var model = await client.ApiClient.CreateGuildChannelAsync(guild.Id, args, options).ConfigureAwait(false); | ||||
| return RestTextChannel.Create(client, guild, model); | return RestTextChannel.Create(client, guild, model); | ||||
| } | } | ||||
| /// <exception cref="ArgumentNullException"><paramref name="name"/> is <see langword="null"/>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception> | |||||
| public static async Task<RestVoiceChannel> CreateVoiceChannelAsync(IGuild guild, BaseDiscordClient client, | public static async Task<RestVoiceChannel> CreateVoiceChannelAsync(IGuild guild, BaseDiscordClient client, | ||||
| string name, RequestOptions options) | string name, RequestOptions options) | ||||
| { | { | ||||
| @@ -160,7 +160,7 @@ namespace Discord.Rest | |||||
| var model = await client.ApiClient.CreateGuildChannelAsync(guild.Id, args, options).ConfigureAwait(false); | var model = await client.ApiClient.CreateGuildChannelAsync(guild.Id, args, options).ConfigureAwait(false); | ||||
| return RestVoiceChannel.Create(client, guild, model); | return RestVoiceChannel.Create(client, guild, model); | ||||
| } | } | ||||
| /// <exception cref="ArgumentNullException"><paramref name="name"/> is <see langword="null"/>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception> | |||||
| public static async Task<RestCategoryChannel> CreateCategoryChannelAsync(IGuild guild, BaseDiscordClient client, | public static async Task<RestCategoryChannel> CreateCategoryChannelAsync(IGuild guild, BaseDiscordClient client, | ||||
| string name, RequestOptions options) | string name, RequestOptions options) | ||||
| { | { | ||||
| @@ -195,7 +195,7 @@ namespace Discord.Rest | |||||
| } | } | ||||
| //Roles | //Roles | ||||
| /// <exception cref="ArgumentNullException"><paramref name="name"/> is <see langword="null"/>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="name"/> is <c>null</c>.</exception> | |||||
| public static async Task<RestRole> CreateRoleAsync(IGuild guild, BaseDiscordClient client, | public static async Task<RestRole> CreateRoleAsync(IGuild guild, BaseDiscordClient client, | ||||
| string name, GuildPermissions? permissions, Color? color, bool isHoisted, RequestOptions options) | string name, GuildPermissions? permissions, Color? color, bool isHoisted, RequestOptions options) | ||||
| { | { | ||||
| @@ -302,7 +302,7 @@ namespace Discord.Rest | |||||
| var emote = await client.ApiClient.CreateGuildEmoteAsync(guild.Id, apiargs, options).ConfigureAwait(false); | var emote = await client.ApiClient.CreateGuildEmoteAsync(guild.Id, apiargs, options).ConfigureAwait(false); | ||||
| return emote.ToEntity(); | return emote.ToEntity(); | ||||
| } | } | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| public static async Task<GuildEmote> ModifyEmoteAsync(IGuild guild, BaseDiscordClient client, ulong id, Action<EmoteProperties> func, | public static async Task<GuildEmote> ModifyEmoteAsync(IGuild guild, BaseDiscordClient client, ulong id, Action<EmoteProperties> func, | ||||
| RequestOptions options) | RequestOptions options) | ||||
| { | { | ||||
| @@ -132,7 +132,7 @@ namespace Discord.Rest | |||||
| => GuildHelper.DeleteAsync(this, Discord, options); | => GuildHelper.DeleteAsync(this, Discord, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| public async Task ModifyAsync(Action<GuildProperties> func, RequestOptions options = null) | public async Task ModifyAsync(Action<GuildProperties> func, RequestOptions options = null) | ||||
| { | { | ||||
| var model = await GuildHelper.ModifyAsync(this, Discord, func, options).ConfigureAwait(false); | var model = await GuildHelper.ModifyAsync(this, Discord, func, options).ConfigureAwait(false); | ||||
| @@ -140,7 +140,7 @@ namespace Discord.Rest | |||||
| } | } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| public async Task ModifyEmbedAsync(Action<GuildEmbedProperties> func, RequestOptions options = null) | public async Task ModifyEmbedAsync(Action<GuildEmbedProperties> func, RequestOptions options = null) | ||||
| { | { | ||||
| var model = await GuildHelper.ModifyEmbedAsync(this, Discord, func, options).ConfigureAwait(false); | var model = await GuildHelper.ModifyEmbedAsync(this, Discord, func, options).ConfigureAwait(false); | ||||
| @@ -66,7 +66,7 @@ namespace Discord.WebSocket | |||||
| /// <remarks> | /// <remarks> | ||||
| /// This method gets the user present in the WebSocket cache with the given condition. | /// This method gets the user present in the WebSocket cache with the given condition. | ||||
| /// <note> | /// <note> | ||||
| /// Sometimes a user may return <see langword="null"/> due to Discord not sending offline users in large | |||||
| /// Sometimes a user may return <c>null</c> due to Discord not sending offline users in large | |||||
| /// guilds (i.e. guild with 100+ members) actively. To download users on startup, consider enabling | /// guilds (i.e. guild with 100+ members) actively. To download users on startup, consider enabling | ||||
| /// <see cref="DiscordSocketConfig.AlwaysDownloadUsers"/>. | /// <see cref="DiscordSocketConfig.AlwaysDownloadUsers"/>. | ||||
| /// </note> | /// </note> | ||||
| @@ -76,7 +76,7 @@ namespace Discord.WebSocket | |||||
| /// </note> | /// </note> | ||||
| /// </remarks> | /// </remarks> | ||||
| /// <returns> | /// <returns> | ||||
| /// A WebSocket-based generic user; <see langword="null"/> when the user cannot be found. | |||||
| /// A WebSocket-based generic user; <c>null</c> when the user cannot be found. | |||||
| /// </returns> | /// </returns> | ||||
| public abstract SocketUser GetUser(ulong id); | public abstract SocketUser GetUser(ulong id); | ||||
| @@ -88,7 +88,7 @@ namespace Discord.WebSocket | |||||
| /// <remarks> | /// <remarks> | ||||
| /// This method gets the user present in the WebSocket cache with the given condition. | /// This method gets the user present in the WebSocket cache with the given condition. | ||||
| /// <note> | /// <note> | ||||
| /// Sometimes a user may return <see langword="null"/> due to Discord not sending offline users in large | |||||
| /// Sometimes a user may return <c>null</c> due to Discord not sending offline users in large | |||||
| /// guilds (i.e. guild with 100+ members) actively. To download users on startup, consider enabling | /// guilds (i.e. guild with 100+ members) actively. To download users on startup, consider enabling | ||||
| /// <see cref="DiscordSocketConfig.AlwaysDownloadUsers"/>. | /// <see cref="DiscordSocketConfig.AlwaysDownloadUsers"/>. | ||||
| /// </note> | /// </note> | ||||
| @@ -98,7 +98,7 @@ namespace Discord.WebSocket | |||||
| /// </note> | /// </note> | ||||
| /// </remarks> | /// </remarks> | ||||
| /// <returns> | /// <returns> | ||||
| /// A WebSocket-based generic user; <see langword="null"/> when the user cannot be found. | |||||
| /// A WebSocket-based generic user; <c>null</c> when the user cannot be found. | |||||
| /// </returns> | /// </returns> | ||||
| public abstract SocketUser GetUser(string username, string discriminator); | public abstract SocketUser GetUser(string username, string discriminator); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -115,7 +115,7 @@ namespace Discord.WebSocket | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The guild snowflake ID.</param> | /// <param name="id">The guild snowflake ID.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A WebSocket-based guild; <see langword="null"/> when the guild cannot be found. | |||||
| /// A WebSocket-based guild; <c>null</c> when the guild cannot be found. | |||||
| /// </returns> | /// </returns> | ||||
| public abstract SocketGuild GetGuild(ulong id); | public abstract SocketGuild GetGuild(ulong id); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -123,7 +123,7 @@ namespace Discord.WebSocket | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The unique identifier of the voice region.</param> | /// <param name="id">The unique identifier of the voice region.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A REST-based voice region; <see langword="null"/> if none can be found. | |||||
| /// A REST-based voice region; <c>null</c> if none can be found. | |||||
| /// </returns> | /// </returns> | ||||
| public abstract RestVoiceRegion GetVoiceRegion(string id); | public abstract RestVoiceRegion GetVoiceRegion(string id); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| @@ -15,7 +15,7 @@ namespace Discord.WebSocket | |||||
| public const string GatewayEncoding = "json"; | public const string GatewayEncoding = "json"; | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets or sets the WebSocket host to connect to. If <see langword="null"/>, the client will use the | |||||
| /// Gets or sets the WebSocket host to connect to. If <c>null</c>, the client will use the | |||||
| /// /gateway endpoint. | /// /gateway endpoint. | ||||
| /// </summary> | /// </summary> | ||||
| public string GatewayHost { get; set; } = null; | public string GatewayHost { get; set; } = null; | ||||
| @@ -72,7 +72,7 @@ namespace Discord.WebSocket | |||||
| /// </summary> | /// </summary> | ||||
| /// <param name="id">The ID of the message.</param> | /// <param name="id">The ID of the message.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// Cached message object; <see langword="null"/> if it doesn't exist in the cache. | |||||
| /// Cached message object; <c>null</c> if it doesn't exist in the cache. | |||||
| /// </returns> | /// </returns> | ||||
| SocketMessage GetCachedMessage(ulong id); | SocketMessage GetCachedMessage(ulong id); | ||||
| /// <summary> | /// <summary> | ||||
| @@ -34,7 +34,7 @@ namespace Discord.WebSocket | |||||
| /// Gets the parent category of this channel. | /// Gets the parent category of this channel. | ||||
| /// </summary> | /// </summary> | ||||
| /// <returns> | /// <returns> | ||||
| /// A parent category ID associated with this channel, or <see langword="null"/> if none is set. | |||||
| /// A parent category ID associated with this channel, or <c>null</c> if none is set. | |||||
| /// </returns> | /// </returns> | ||||
| public ICategoryChannel Category | public ICategoryChannel Category | ||||
| => CategoryId.HasValue ? Guild.GetChannel(CategoryId.Value) as ICategoryChannel : null; | => CategoryId.HasValue ? Guild.GetChannel(CategoryId.Value) as ICategoryChannel : null; | ||||
| @@ -152,7 +152,7 @@ namespace Discord.WebSocket | |||||
| /// <param name="id">The ID of the webhook.</param> | /// <param name="id">The ID of the webhook.</param> | ||||
| /// <param name="options">The options to be used when sending the request.</param> | /// <param name="options">The options to be used when sending the request.</param> | ||||
| /// <returns> | /// <returns> | ||||
| /// A webhook associated with the <paramref name="id"/>, or <see langword="null"/> if not found. | |||||
| /// A webhook associated with the <paramref name="id"/>, or <c>null</c> if not found. | |||||
| /// </returns> | /// </returns> | ||||
| public Task<RestWebhook> GetWebhookAsync(ulong id, RequestOptions options = null) | public Task<RestWebhook> GetWebhookAsync(ulong id, RequestOptions options = null) | ||||
| => ChannelHelper.GetWebhookAsync(this, Discord, id, options); | => ChannelHelper.GetWebhookAsync(this, Discord, id, options); | ||||
| @@ -116,7 +116,7 @@ namespace Discord.WebSocket | |||||
| } | } | ||||
| } | } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the embed channel set in the widget settings of this guild, or <see langword="null"/> if none is set. | |||||
| /// Gets the embed channel set in the widget settings of this guild, or <c>null</c> if none is set. | |||||
| /// </summary> | /// </summary> | ||||
| public SocketGuildChannel EmbedChannel | public SocketGuildChannel EmbedChannel | ||||
| { | { | ||||
| @@ -127,7 +127,7 @@ namespace Discord.WebSocket | |||||
| } | } | ||||
| } | } | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the channel where randomized welcome messages are sent, or <see langword="null"/> if none is set. | |||||
| /// Gets the channel where randomized welcome messages are sent, or <c>null</c> if none is set. | |||||
| /// </summary> | /// </summary> | ||||
| public SocketTextChannel SystemChannel | public SocketTextChannel SystemChannel | ||||
| { | { | ||||
| @@ -372,12 +372,12 @@ namespace Discord.WebSocket | |||||
| => GuildHelper.DeleteAsync(this, Discord, options); | => GuildHelper.DeleteAsync(this, Discord, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| public Task ModifyAsync(Action<GuildProperties> func, RequestOptions options = null) | public Task ModifyAsync(Action<GuildProperties> func, RequestOptions options = null) | ||||
| => GuildHelper.ModifyAsync(this, Discord, func, options); | => GuildHelper.ModifyAsync(this, Discord, func, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| public Task ModifyEmbedAsync(Action<GuildEmbedProperties> func, RequestOptions options = null) | public Task ModifyEmbedAsync(Action<GuildEmbedProperties> func, RequestOptions options = null) | ||||
| => GuildHelper.ModifyEmbedAsync(this, Discord, func, options); | => GuildHelper.ModifyEmbedAsync(this, Discord, func, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| @@ -671,7 +671,7 @@ namespace Discord.WebSocket | |||||
| public Task<GuildEmote> CreateEmoteAsync(string name, Image image, Optional<IEnumerable<IRole>> roles = default(Optional<IEnumerable<IRole>>), RequestOptions options = null) | public Task<GuildEmote> CreateEmoteAsync(string name, Image image, Optional<IEnumerable<IRole>> roles = default(Optional<IEnumerable<IRole>>), RequestOptions options = null) | ||||
| => GuildHelper.CreateEmoteAsync(this, Discord, name, image, roles, options); | => GuildHelper.CreateEmoteAsync(this, Discord, name, image, roles, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <see langword="null"/>.</exception> | |||||
| /// <exception cref="ArgumentNullException"><paramref name="func"/> is <c>null</c>.</exception> | |||||
| public Task<GuildEmote> ModifyEmoteAsync(GuildEmote emote, Action<EmoteProperties> func, RequestOptions options = null) | public Task<GuildEmote> ModifyEmoteAsync(GuildEmote emote, Action<EmoteProperties> func, RequestOptions options = null) | ||||
| => GuildHelper.ModifyEmoteAsync(this, Discord, emote.Id, func, options); | => GuildHelper.ModifyEmoteAsync(this, Discord, emote.Id, func, options); | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||
| @@ -23,7 +23,7 @@ namespace Discord.WebSocket | |||||
| private readonly Flags _voiceStates; | private readonly Flags _voiceStates; | ||||
| /// <summary> | /// <summary> | ||||
| /// Gets the voice channel that the user is currently in; or <see langword="null"/> if none. | |||||
| /// Gets the voice channel that the user is currently in; or <c>null</c> if none. | |||||
| /// </summary> | /// </summary> | ||||
| public SocketVoiceChannel VoiceChannel { get; } | public SocketVoiceChannel VoiceChannel { get; } | ||||
| /// <inheritdoc /> | /// <inheritdoc /> | ||||