* Fixed some warnings * Another fixed warning * Changed the SSendFileAsync to SendFileAsync * Removed para AlwaysAcknowledgeInteractions * Moved it back to the previous version * Added periods to the end like quin requested!! :(( Co-authored-by: MrCakeSlayer <13650699+MrCakeSlayer@users.noreply.github.com>pull/1923/head
| @@ -1138,13 +1138,15 @@ | |||
| </param> | |||
| <param name="isTTS">Specifies if Discord should read this <paramref name="message"/> aloud using text-to-speech.</param> | |||
| <param name="embed">An embed to be displayed alongside the <paramref name="message"/>.</param> | |||
| <param name="embeds">A array of <see cref="T:Discord.Embed"/>s to send with this response. Max 10</param> /// <param name="allowedMentions"> | |||
| <param name="allowedMentions"> | |||
| Specifies if notifications are sent for mentioned users and roles in the <paramref name="message"/>. | |||
| If <c>null</c>, all mentioned roles and users will be notified. | |||
| </param> | |||
| <param name="options">The request options for this async request.</param> | |||
| <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| <param name="stickers">A collection of stickers to send with the file.</param> | |||
| <param name="embeds">A array of <see cref="T:Discord.Embed"/>s to send with this response. Max 10.</param> | |||
| </member> | |||
| <member name="M:Discord.Commands.ModuleBase`1.BeforeExecute(Discord.Commands.CommandInfo)"> | |||
| <summary> | |||
| @@ -38,9 +38,9 @@ namespace Discord.Commands | |||
| /// </param> | |||
| /// <param name="options">The request options for this async request.</param> | |||
| /// <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| /// <param name="stickers">A collection of stickers to send with the file.</param> | |||
| /// <param name="embeds">A array of <see cref="Embed"/>s to send with this response. Max 10</param> | |||
| /// <param name="embeds">A array of <see cref="Embed"/>s to send with this response. Max 10.</param> | |||
| protected virtual async Task<IUserMessage> ReplyAsync(string message = null, bool isTTS = false, Embed embed = null, RequestOptions options = null, AllowedMentions allowedMentions = null, MessageReference messageReference = null, MessageComponent component = null, ISticker[] stickers = null, Embed[] embeds = null) | |||
| { | |||
| return await Context.Channel.SendMessageAsync(message, isTTS, embed, options, allowedMentions, messageReference, component, stickers, embeds).ConfigureAwait(false); | |||
| @@ -181,7 +181,7 @@ namespace Discord | |||
| /// Gets a stickers url based off the id and format. | |||
| /// </summary> | |||
| /// <param name="stickerId">The id of the sticker.</param> | |||
| /// <param name="format">The format of the sticker</param> | |||
| /// <param name="format">The format of the sticker.</param> | |||
| /// <returns> | |||
| /// A URL to the sticker. | |||
| /// </returns> | |||
| @@ -217,7 +217,7 @@ | |||
| Gets a stickers url based off the id and format. | |||
| </summary> | |||
| <param name="stickerId">The id of the sticker.</param> | |||
| <param name="format">The format of the sticker</param> | |||
| <param name="format">The format of the sticker.</param> | |||
| <returns> | |||
| A URL to the sticker. | |||
| </returns> | |||
| @@ -1526,9 +1526,9 @@ | |||
| If <c>null</c>, all mentioned roles and users will be notified. | |||
| </param> | |||
| <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| <param name="stickers">A collection of stickers to send with the message.</param> | |||
| <param name="embeds">A array of <see cref="T:Discord.Embed"/>s to send with this response. Max 10</param> | |||
| <param name="embeds">A array of <see cref="T:Discord.Embed"/>s to send with this response. Max 10.</param> | |||
| <returns> | |||
| A task that represents an asynchronous send operation for delivering the message. The task result | |||
| contains the sent message. | |||
| @@ -1567,7 +1567,7 @@ | |||
| If <c>null</c>, all mentioned roles and users will be notified. | |||
| </param> | |||
| <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| <param name="stickers">A collection of stickers to send with the file.</param> | |||
| <returns> | |||
| A task that represents an asynchronous send operation for delivering the message. The task result | |||
| @@ -1604,7 +1604,7 @@ | |||
| If <c>null</c>, all mentioned roles and users will be notified. | |||
| </param> | |||
| <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| <param name="stickers">A collection of stickers to send with the file.</param> | |||
| <returns> | |||
| A task that represents an asynchronous send operation for delivering the message. The task result | |||
| @@ -1870,7 +1870,7 @@ | |||
| await guildChannel.CreateInviteAsync(maxAge: 43200, maxUses: 3); | |||
| </code> | |||
| </example> | |||
| <param name="applicationId">The id of the embedded application to open for this invite</param> | |||
| <param name="applicationId">The id of the embedded application to open for this invite.</param> | |||
| <param name="maxAge">The time (in seconds) until the invite expires. Set to <c>null</c> to never expire.</param> | |||
| <param name="maxUses">The max amount of times this invite may be used. Set to <c>null</c> to have unlimited uses.</param> | |||
| <param name="isTemporary">If <c>true</c>, the user accepting this invite will be kicked from the guild after closing their client.</param> | |||
| @@ -1892,7 +1892,7 @@ | |||
| await guildChannel.CreateInviteAsync(maxAge: 43200, maxUses: 3); | |||
| </code> | |||
| </example> | |||
| <param name="user">The id of the user whose stream to display for this invite</param> | |||
| <param name="user">The id of the user whose stream to display for this invite.</param> | |||
| <param name="maxAge">The time (in seconds) until the invite expires. Set to <c>null</c> to never expire.</param> | |||
| <param name="maxUses">The max amount of times this invite may be used. Set to <c>null</c> to have unlimited uses.</param> | |||
| <param name="isTemporary">If <c>true</c>, the user accepting this invite will be kicked from the guild after closing their client.</param> | |||
| @@ -1979,7 +1979,7 @@ | |||
| Starts the stage, creating a stage instance. | |||
| </summary> | |||
| <param name="topic">The topic for the stage/</param> | |||
| <param name="privacyLevel">The privacy level of the stage</param> | |||
| <param name="privacyLevel">The privacy level of the stage.</param> | |||
| <param name="options">The options to be used when sending the request.</param> | |||
| <returns> | |||
| A task that represents the asynchronous start operation. | |||
| @@ -3996,7 +3996,7 @@ | |||
| <param name="description">The description of the sticker.</param> | |||
| <param name="tags">The tags of the sticker.</param> | |||
| <param name="stream">The stream containing the file data.</param> | |||
| <param name="filename">The name of the file <b>with</b> the extension, ex: image.png</param> | |||
| <param name="filename">The name of the file <b>with</b> the extension, ex: image.png.</param> | |||
| <param name="options">The options to be used when sending the request.</param> | |||
| <returns> | |||
| A task that represents the asynchronous creation operation. The task result contains the created sticker. | |||
| @@ -5007,25 +5007,25 @@ | |||
| Responds to an Interaction with type <see cref="F:Discord.InteractionResponseType.ChannelMessageWithSource"/>. | |||
| </summary> | |||
| <param name="text">The text of the message to be sent.</param> | |||
| <param name="embeds">A array of embeds to send with this response. Max 10</param> | |||
| <param name="embeds">A array of embeds to send with this response. Max 10.</param> | |||
| <param name="isTTS"><see langword="true"/> if the message should be read out by a text-to-speech reader, otherwise <see langword="false"/>.</param> | |||
| <param name="ephemeral"><see langword="true"/> if the response should be hidden to everyone besides the invoker of the command, otherwise <see langword="false"/>.</param> | |||
| <param name="allowedMentions">The allowed mentions for this response.</param> | |||
| <param name="options">The request options for this response.</param> | |||
| <param name="component">A <see cref="T:Discord.MessageComponent"/> to be sent with this response</param> | |||
| <param name="component">A <see cref="T:Discord.MessageComponent"/> to be sent with this response.</param> | |||
| <param name="embed">A single embed to send with this response. If this is passed alongside an array of embeds, the single embed will be ignored.</param> | |||
| </member> | |||
| <member name="M:Discord.IDiscordInteraction.FollowupAsync(System.String,Discord.Embed[],System.Boolean,System.Boolean,Discord.AllowedMentions,Discord.RequestOptions,Discord.MessageComponent,Discord.Embed)"> | |||
| <summary> | |||
| Sends a followup message for this interaction. | |||
| </summary> | |||
| <param name="text">The text of the message to be sent</param> | |||
| <param name="embeds">A array of embeds to send with this response. Max 10</param> | |||
| <param name="text">The text of the message to be sent.</param> | |||
| <param name="embeds">A array of embeds to send with this response. Max 10.</param> | |||
| <param name="isTTS"><see langword="true"/> if the message should be read out by a text-to-speech reader, otherwise <see langword="false"/>.</param> | |||
| <param name="ephemeral"><see langword="true"/> if the response should be hidden to everyone besides the invoker of the command, otherwise <see langword="false"/>.</param> | |||
| <param name="allowedMentions">The allowed mentions for this response.</param> | |||
| <param name="options">The request options for this response.</param> | |||
| <param name="component">A <see cref="T:Discord.MessageComponent"/> to be sent with this response</param> | |||
| <param name="component">A <see cref="T:Discord.MessageComponent"/> to be sent with this response.</param> | |||
| <param name="embed">A single embed to send with this response. If this is passed alongside an array of embeds, the single embed will be ignored.</param> | |||
| <returns> | |||
| The sent message. | |||
| @@ -5414,10 +5414,10 @@ | |||
| </summary> | |||
| <param name="label">The label to use on the newly created link button.</param> | |||
| <param name="url">The url of this button.</param> | |||
| <param name="customId">The custom ID of this button</param> | |||
| <param name="style">The custom ID of this button</param> | |||
| <param name="emote">The emote of this button</param> | |||
| <param name="disabled">Disabled this button or not</param> | |||
| <param name="customId">The custom ID of this button.</param> | |||
| <param name="style">The custom ID of this button.</param> | |||
| <param name="emote">The emote of this button.</param> | |||
| <param name="disabled">Disabled this button or not.</param> | |||
| </member> | |||
| <member name="M:Discord.ButtonBuilder.#ctor(Discord.ButtonComponent)"> | |||
| <summary> | |||
| @@ -5430,7 +5430,7 @@ | |||
| </summary> | |||
| <param name="label">The label for this link button.</param> | |||
| <param name="url">The url for this link button to go to.</param> | |||
| <param name="emote">The emote for this link button</param> | |||
| <param name="emote">The emote for this link button.</param> | |||
| <returns>A builder with the newly created button.</returns> | |||
| </member> | |||
| <member name="M:Discord.ButtonBuilder.CreateDangerButton(System.String,System.String,Discord.IEmote)"> | |||
| @@ -5439,7 +5439,7 @@ | |||
| </summary> | |||
| <param name="label">The label for this danger button.</param> | |||
| <param name="customId">The custom id for this danger button.</param> | |||
| <param name="emote">The emote for this danger button</param> | |||
| <param name="emote">The emote for this danger button.</param> | |||
| <returns>A builder with the newly created button.</returns> | |||
| </member> | |||
| <member name="M:Discord.ButtonBuilder.CreatePrimaryButton(System.String,System.String,Discord.IEmote)"> | |||
| @@ -5448,7 +5448,7 @@ | |||
| </summary> | |||
| <param name="label">The label for this primary button.</param> | |||
| <param name="customId">The custom id for this primary button.</param> | |||
| <param name="emote">The emote for this primary button</param> | |||
| <param name="emote">The emote for this primary button.</param> | |||
| <returns>A builder with the newly created button.</returns> | |||
| </member> | |||
| <member name="M:Discord.ButtonBuilder.CreateSecondaryButton(System.String,System.String,Discord.IEmote)"> | |||
| @@ -5457,7 +5457,7 @@ | |||
| </summary> | |||
| <param name="label">The label for this secondary button.</param> | |||
| <param name="customId">The custom id for this secondary button.</param> | |||
| <param name="emote">The emote for this secondary button</param> | |||
| <param name="emote">The emote for this secondary button.</param> | |||
| <returns>A builder with the newly created button.</returns> | |||
| </member> | |||
| <member name="M:Discord.ButtonBuilder.CreateSuccessButton(System.String,System.String,Discord.IEmote)"> | |||
| @@ -5466,14 +5466,14 @@ | |||
| </summary> | |||
| <param name="label">The label for this success button.</param> | |||
| <param name="customId">The custom id for this success button.</param> | |||
| <param name="emote">The emote for this success button</param> | |||
| <param name="emote">The emote for this success button.</param> | |||
| <returns>A builder with the newly created button.</returns> | |||
| </member> | |||
| <member name="M:Discord.ButtonBuilder.WithLabel(System.String)"> | |||
| <summary> | |||
| Sets the current buttons label to the specified text. | |||
| </summary> | |||
| <param name="label">The text for the label</param> | |||
| <param name="label">The text for the label.</param> | |||
| <inheritdoc cref="P:Discord.ButtonBuilder.Label"/> | |||
| <returns>The current builder.</returns> | |||
| </member> | |||
| @@ -9114,6 +9114,12 @@ | |||
| <member name="P:Discord.GuildPermissions.CreatePrivateThreads"> | |||
| <summary> If <c>true</c>, a user may create private threads in this guild. </summary> | |||
| </member> | |||
| <member name="P:Discord.GuildPermissions.UsePublicThreads"> | |||
| <summary> If <c>true</c>, a user may use public threads in this guild. </summary> | |||
| </member> | |||
| <member name="P:Discord.GuildPermissions.UsePrivateThreads"> | |||
| <summary> If <c>true</c>, a user may use private threads in this guild. </summary> | |||
| </member> | |||
| <member name="P:Discord.GuildPermissions.UseExternalStickers"> | |||
| <summary> If <c>true</c>, a user may use external stickers in this guild. </summary> | |||
| </member> | |||
| @@ -9129,10 +9135,10 @@ | |||
| <member name="M:Discord.GuildPermissions.#ctor(System.String)"> | |||
| <summary> Creates a new <see cref="T:Discord.GuildPermissions"/> with the provided packed value after converting to ulong. </summary> | |||
| </member> | |||
| <member name="M:Discord.GuildPermissions.#ctor(System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean)"> | |||
| <member name="M:Discord.GuildPermissions.#ctor(System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean,System.Boolean)"> | |||
| <summary> Creates a new <see cref="T:Discord.GuildPermissions"/> structure with the provided permissions. </summary> | |||
| </member> | |||
| <member name="M:Discord.GuildPermissions.Modify(System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean})"> | |||
| <member name="M:Discord.GuildPermissions.Modify(System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean},System.Nullable{System.Boolean})"> | |||
| <summary> Creates a new <see cref="T:Discord.GuildPermissions"/> from this one, changing the provided non-null permissions. </summary> | |||
| </member> | |||
| <member name="M:Discord.GuildPermissions.Has(Discord.GuildPermission)"> | |||
| @@ -11058,7 +11064,7 @@ | |||
| </code> | |||
| </example> | |||
| <param name="msg">The message to add reactions to.</param> | |||
| <param name="reactions">An array of reactions to add to the message</param> | |||
| <param name="reactions">An array of reactions to add to the message.</param> | |||
| <param name="options">The options to be used when sending the request.</param> | |||
| <returns> | |||
| A task that represents the asynchronous operation for adding a reaction to this message. | |||
| @@ -11080,7 +11086,7 @@ | |||
| </code> | |||
| </example> | |||
| <param name="msg">The message to remove reactions from.</param> | |||
| <param name="reactions">An array of reactions to remove from the message</param> | |||
| <param name="reactions">An array of reactions to remove from the message.</param> | |||
| <param name="options">The options to be used when sending the request.</param> | |||
| <returns> | |||
| A task that represents the asynchronous operation for removing a reaction to this message. | |||
| @@ -11095,7 +11101,7 @@ | |||
| <param name="text">The message to be sent.</param> | |||
| <param name="isTTS">Determines whether the message should be read aloud by Discord or not.</param> | |||
| <param name="embed">The <see cref="F:Discord.EmbedType.Rich"/> <see cref="T:Discord.Embed"/> to be sent.</param> | |||
| <param name="embeds">A array of <see cref="T:Discord.Embed"/>s to send with this response. Max 10</param> | |||
| <param name="embeds">A array of <see cref="T:Discord.Embed"/>s to send with this response. Max 10.</param> | |||
| <param name="allowedMentions"> | |||
| Specifies if notifications are sent for mentioned users and roles in the message <paramref name="text"/>. | |||
| If <c>null</c>, all mentioned roles and users will be notified. | |||
| @@ -11130,13 +11136,13 @@ | |||
| <param name="text">The message to be sent.</param> | |||
| <param name="isTTS">Whether the message should be read aloud by Discord or not.</param> | |||
| <param name="embed">The <see cref="F:Discord.EmbedType.Rich"/> <see cref="T:Discord.Embed"/> to be sent.</param> | |||
| <param name="embeds">A array of <see cref="T:Discord.Embed"/>s to send with this response. Max 10</param> | |||
| <param name="embeds">A array of <see cref="T:Discord.Embed"/>s to send with this response. Max 10.</param> | |||
| <param name="options">The options to be used when sending the request.</param> | |||
| <param name="allowedMentions"> | |||
| Specifies if notifications are sent for mentioned users and roles in the message <paramref name="text"/>. | |||
| If <c>null</c>, all mentioned roles and users will be notified. | |||
| </param> | |||
| <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| <returns> | |||
| A task that represents the asynchronous send operation. The task result contains the sent message. | |||
| </returns> | |||
| @@ -12782,7 +12788,7 @@ | |||
| <summary> | |||
| Not full URL validation right now. Just ensures protocol is present and that it's either http or https | |||
| </summary> | |||
| <param name="url">url to validate before sending to Discord</param> | |||
| <param name="url">url to validate before sending to Discord.</param> | |||
| <exception cref="T:System.InvalidOperationException">A URL must include a protocol (http or https).</exception> | |||
| <returns>true if url is valid by our standard, false if null, throws an error upon invalid </returns> | |||
| </member> | |||
| @@ -28,9 +28,9 @@ namespace Discord | |||
| /// If <c>null</c>, all mentioned roles and users will be notified. | |||
| /// </param> | |||
| /// <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| /// <param name="stickers">A collection of stickers to send with the message.</param> | |||
| /// <param name="embeds">A array of <see cref="Embed"/>s to send with this response. Max 10</param> | |||
| /// <param name="embeds">A array of <see cref="Embed"/>s to send with this response. Max 10.</param> | |||
| /// <returns> | |||
| /// A task that represents an asynchronous send operation for delivering the message. The task result | |||
| /// contains the sent message. | |||
| @@ -68,7 +68,7 @@ namespace Discord | |||
| /// If <c>null</c>, all mentioned roles and users will be notified. | |||
| /// </param> | |||
| /// <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| /// <param name="stickers">A collection of stickers to send with the file.</param> | |||
| /// <returns> | |||
| /// A task that represents an asynchronous send operation for delivering the message. The task result | |||
| @@ -104,7 +104,7 @@ namespace Discord | |||
| /// If <c>null</c>, all mentioned roles and users will be notified. | |||
| /// </param> | |||
| /// <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| /// <param name="stickers">A collection of stickers to send with the file.</param> | |||
| /// <returns> | |||
| /// A task that represents an asynchronous send operation for delivering the message. The task result | |||
| @@ -67,7 +67,7 @@ namespace Discord | |||
| /// await guildChannel.CreateInviteAsync(maxAge: 43200, maxUses: 3); | |||
| /// </code> | |||
| /// </example> | |||
| /// <param name="applicationId">The id of the embedded application to open for this invite</param> | |||
| /// <param name="applicationId">The id of the embedded application to open for this invite.</param> | |||
| /// <param name="maxAge">The time (in seconds) until the invite expires. Set to <c>null</c> to never expire.</param> | |||
| /// <param name="maxUses">The max amount of times this invite may be used. Set to <c>null</c> to have unlimited uses.</param> | |||
| /// <param name="isTemporary">If <c>true</c>, the user accepting this invite will be kicked from the guild after closing their client.</param> | |||
| @@ -89,7 +89,7 @@ namespace Discord | |||
| /// await guildChannel.CreateInviteAsync(maxAge: 43200, maxUses: 3); | |||
| /// </code> | |||
| /// </example> | |||
| /// <param name="user">The id of the user whose stream to display for this invite</param> | |||
| /// <param name="user">The id of the user whose stream to display for this invite.</param> | |||
| /// <param name="maxAge">The time (in seconds) until the invite expires. Set to <c>null</c> to never expire.</param> | |||
| /// <param name="maxUses">The max amount of times this invite may be used. Set to <c>null</c> to have unlimited uses.</param> | |||
| /// <param name="isTemporary">If <c>true</c>, the user accepting this invite will be kicked from the guild after closing their client.</param> | |||
| @@ -44,7 +44,7 @@ namespace Discord | |||
| /// Starts the stage, creating a stage instance. | |||
| /// </summary> | |||
| /// <param name="topic">The topic for the stage/</param> | |||
| /// <param name="privacyLevel">The privacy level of the stage</param> | |||
| /// <param name="privacyLevel">The privacy level of the stage.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous start operation. | |||
| @@ -1009,7 +1009,7 @@ namespace Discord | |||
| /// <param name="description">The description of the sticker.</param> | |||
| /// <param name="tags">The tags of the sticker.</param> | |||
| /// <param name="stream">The stream containing the file data.</param> | |||
| /// <param name="filename">The name of the file <b>with</b> the extension, ex: image.png</param> | |||
| /// <param name="filename">The name of the file <b>with</b> the extension, ex: image.png.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous creation operation. The task result contains the created sticker. | |||
| @@ -7,7 +7,7 @@ using System.Threading.Tasks; | |||
| namespace Discord | |||
| { | |||
| /// <summary> | |||
| /// Options for the <see cref="IApplicationCommand"/>, see <see href="https://discord.com/developers/docs/interactions/slash-commands#applicationcommandoption"/>The docs</see>. | |||
| /// Options for the <see cref="IApplicationCommand"/>, see <see href="https://discord.com/developers/docs/interactions/slash-commands#applicationcommandoption">The docs</see>. | |||
| /// </summary> | |||
| public interface IApplicationCommandOption | |||
| { | |||
| @@ -44,12 +44,12 @@ namespace Discord | |||
| /// Responds to an Interaction with type <see cref="InteractionResponseType.ChannelMessageWithSource"/>. | |||
| /// </summary> | |||
| /// <param name="text">The text of the message to be sent.</param> | |||
| /// <param name="embeds">A array of embeds to send with this response. Max 10</param> | |||
| /// <param name="embeds">A array of embeds to send with this response. Max 10.</param> | |||
| /// <param name="isTTS"><see langword="true"/> if the message should be read out by a text-to-speech reader, otherwise <see langword="false"/>.</param> | |||
| /// <param name="ephemeral"><see langword="true"/> if the response should be hidden to everyone besides the invoker of the command, otherwise <see langword="false"/>.</param> | |||
| /// <param name="allowedMentions">The allowed mentions for this response.</param> | |||
| /// <param name="options">The request options for this response.</param> | |||
| /// <param name="component">A <see cref="MessageComponent"/> to be sent with this response</param> | |||
| /// <param name="component">A <see cref="MessageComponent"/> to be sent with this response.</param> | |||
| /// <param name="embed">A single embed to send with this response. If this is passed alongside an array of embeds, the single embed will be ignored.</param> | |||
| Task RespondAsync (string text = null, Embed[] embeds = null, bool isTTS = false, | |||
| bool ephemeral = false, AllowedMentions allowedMentions = null, RequestOptions options = null, MessageComponent component = null, Embed embed = null); | |||
| @@ -57,13 +57,13 @@ namespace Discord | |||
| /// <summary> | |||
| /// Sends a followup message for this interaction. | |||
| /// </summary> | |||
| /// <param name="text">The text of the message to be sent</param> | |||
| /// <param name="embeds">A array of embeds to send with this response. Max 10</param> | |||
| /// <param name="text">The text of the message to be sent.</param> | |||
| /// <param name="embeds">A array of embeds to send with this response. Max 10.</param> | |||
| /// <param name="isTTS"><see langword="true"/> if the message should be read out by a text-to-speech reader, otherwise <see langword="false"/>.</param> | |||
| /// <param name="ephemeral"><see langword="true"/> if the response should be hidden to everyone besides the invoker of the command, otherwise <see langword="false"/>.</param> | |||
| /// <param name="allowedMentions">The allowed mentions for this response.</param> | |||
| /// <param name="options">The request options for this response.</param> | |||
| /// <param name="component">A <see cref="MessageComponent"/> to be sent with this response</param> | |||
| /// <param name="component">A <see cref="MessageComponent"/> to be sent with this response.</param> | |||
| /// <param name="embed">A single embed to send with this response. If this is passed alongside an array of embeds, the single embed will be ignored.</param> | |||
| /// <returns> | |||
| /// The sent message. | |||
| @@ -240,7 +240,7 @@ namespace Discord | |||
| /// <summary> | |||
| /// Builds this builder into a <see cref="MessageComponent"/> used to send your components. | |||
| /// </summary> | |||
| /// <returns>A <see cref="MessageComponent"/> that can be sent with <see cref="IMessageChannel.SendMessageAsync(string, bool, Embed, RequestOptions, AllowedMentions, MessageReference, MessageComponent)"/>.</returns> | |||
| /// <returns>A <see cref="MessageComponent"/> that can be sent with <see cref="IMessageChannel.SendMessageAsync"/>.</returns> | |||
| public MessageComponent Build() | |||
| { | |||
| if (this._actionRows != null) | |||
| @@ -427,10 +427,10 @@ namespace Discord | |||
| /// </summary> | |||
| /// <param name="label">The label to use on the newly created link button.</param> | |||
| /// <param name="url">The url of this button.</param> | |||
| /// <param name="customId">The custom ID of this button</param> | |||
| /// <param name="style">The custom ID of this button</param> | |||
| /// <param name="emote">The emote of this button</param> | |||
| /// <param name="disabled">Disabled this button or not</param> | |||
| /// <param name="customId">The custom ID of this button.</param> | |||
| /// <param name="style">The custom ID of this button.</param> | |||
| /// <param name="emote">The emote of this button.</param> | |||
| /// <param name="disabled">Disabled this button or not.</param> | |||
| public ButtonBuilder(string label = null, string customId = null, ButtonStyle style = ButtonStyle.Primary, string url = null, IEmote emote = null, bool disabled = false) | |||
| { | |||
| this.CustomId = customId; | |||
| @@ -459,7 +459,7 @@ namespace Discord | |||
| /// </summary> | |||
| /// <param name="label">The label for this link button.</param> | |||
| /// <param name="url">The url for this link button to go to.</param> | |||
| /// <param name="emote">The emote for this link button</param> | |||
| /// <param name="emote">The emote for this link button.</param> | |||
| /// <returns>A builder with the newly created button.</returns> | |||
| public static ButtonBuilder CreateLinkButton(string label, string url, IEmote emote = null) | |||
| => new ButtonBuilder(label, null, ButtonStyle.Link, url, emote: emote); | |||
| @@ -469,7 +469,7 @@ namespace Discord | |||
| /// </summary> | |||
| /// <param name="label">The label for this danger button.</param> | |||
| /// <param name="customId">The custom id for this danger button.</param> | |||
| /// <param name="emote">The emote for this danger button</param> | |||
| /// <param name="emote">The emote for this danger button.</param> | |||
| /// <returns>A builder with the newly created button.</returns> | |||
| public static ButtonBuilder CreateDangerButton(string label, string customId, IEmote emote = null) | |||
| => new ButtonBuilder(label, customId, ButtonStyle.Danger, emote: emote); | |||
| @@ -479,7 +479,7 @@ namespace Discord | |||
| /// </summary> | |||
| /// <param name="label">The label for this primary button.</param> | |||
| /// <param name="customId">The custom id for this primary button.</param> | |||
| /// <param name="emote">The emote for this primary button</param> | |||
| /// <param name="emote">The emote for this primary button.</param> | |||
| /// <returns>A builder with the newly created button.</returns> | |||
| public static ButtonBuilder CreatePrimaryButton(string label, string customId, IEmote emote = null) | |||
| => new ButtonBuilder(label, customId, emote: emote); | |||
| @@ -489,7 +489,7 @@ namespace Discord | |||
| /// </summary> | |||
| /// <param name="label">The label for this secondary button.</param> | |||
| /// <param name="customId">The custom id for this secondary button.</param> | |||
| /// <param name="emote">The emote for this secondary button</param> | |||
| /// <param name="emote">The emote for this secondary button.</param> | |||
| /// <returns>A builder with the newly created button.</returns> | |||
| public static ButtonBuilder CreateSecondaryButton(string label, string customId, IEmote emote = null) | |||
| => new ButtonBuilder(label, customId, ButtonStyle.Secondary, emote: emote); | |||
| @@ -499,7 +499,7 @@ namespace Discord | |||
| /// </summary> | |||
| /// <param name="label">The label for this success button.</param> | |||
| /// <param name="customId">The custom id for this success button.</param> | |||
| /// <param name="emote">The emote for this success button</param> | |||
| /// <param name="emote">The emote for this success button.</param> | |||
| /// <returns>A builder with the newly created button.</returns> | |||
| public static ButtonBuilder CreateSuccessButton(string label, string customId, IEmote emote = null) | |||
| => new ButtonBuilder(label, customId, ButtonStyle.Success, emote: emote); | |||
| @@ -507,7 +507,7 @@ namespace Discord | |||
| /// <summary> | |||
| /// Sets the current buttons label to the specified text. | |||
| /// </summary> | |||
| /// <param name="label">The text for the label</param> | |||
| /// <param name="label">The text for the label.</param> | |||
| /// <inheritdoc cref="Label"/> | |||
| /// <returns>The current builder.</returns> | |||
| public ButtonBuilder WithLabel(string label) | |||
| @@ -161,6 +161,7 @@ namespace Discord | |||
| /// <param name="description">The description of this option.</param> | |||
| /// <param name="required">If this option is required for this command.</param> | |||
| /// <param name="isDefault">If this option is the default option.</param> | |||
| /// <param name="isAutocomplete">If this option is set to autocompleate.</param> | |||
| /// <param name="options">The options of the option to add.</param> | |||
| /// <param name="choices">The choices of this option.</param> | |||
| /// <returns>The current builder.</returns> | |||
| @@ -84,7 +84,7 @@ namespace Discord | |||
| /// <example> | |||
| /// <para>The following example checks if the current user has the ability to send a message with attachment in | |||
| /// this channel; if so, uploads a file via <see cref="IMessageChannel.SendFileAsync(string, string, bool, Embed, RequestOptions, bool, AllowedMentions, MessageReference)"/>.</para> | |||
| /// <code language="cs"> | |||
| /// <code language="cs"> | |||
| /// if (currentUser?.GetPermissions(targetChannel)?.AttachFiles) | |||
| /// await targetChannel.SendFileAsync("fortnite.png"); | |||
| /// </code> | |||
| @@ -34,7 +34,7 @@ namespace Discord | |||
| /// </code> | |||
| /// </example> | |||
| /// <param name="msg">The message to add reactions to.</param> | |||
| /// <param name="reactions">An array of reactions to add to the message</param> | |||
| /// <param name="reactions">An array of reactions to add to the message.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous operation for adding a reaction to this message. | |||
| @@ -59,7 +59,8 @@ namespace Discord | |||
| /// </code> | |||
| /// </example> | |||
| /// <param name="msg">The message to remove reactions from.</param> | |||
| /// <param name="reactions">An array of reactions to remove from the message</param> | |||
| /// <param name="user">The user who removed the reaction.</param> | |||
| /// <param name="reactions">An array of reactions to remove from the message.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous operation for removing a reaction to this message. | |||
| @@ -75,15 +76,18 @@ namespace Discord | |||
| /// <summary> | |||
| /// Sends an inline reply that references a message. | |||
| /// </summary> | |||
| /// <param name="msg">The message that is being replyed on.</param> | |||
| /// <param name="text">The message to be sent.</param> | |||
| /// <param name="isTTS">Determines whether the message should be read aloud by Discord or not.</param> | |||
| /// <param name="embed">The <see cref="Discord.EmbedType.Rich"/> <see cref="Embed"/> to be sent.</param> | |||
| /// <param name="embeds">A array of <see cref="Embed"/>s to send with this response. Max 10</param> | |||
| /// <param name="embeds">A array of <see cref="Embed"/>s to send with this response. Max 10.</param> | |||
| /// <param name="allowedMentions"> | |||
| /// Specifies if notifications are sent for mentioned users and roles in the message <paramref name="text"/>. | |||
| /// If <c>null</c>, all mentioned roles and users will be notified. | |||
| /// </param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <param name="components">The message components to be included with this message. Used for interactions.</param> | |||
| /// <param name="stickers">A collection of stickers to send with the message.</param> | |||
| /// <returns> | |||
| /// A task that represents an asynchronous send operation for delivering the message. The task result | |||
| /// contains the sent message. | |||
| @@ -27,13 +27,13 @@ namespace Discord | |||
| /// <param name="text">The message to be sent.</param> | |||
| /// <param name="isTTS">Whether the message should be read aloud by Discord or not.</param> | |||
| /// <param name="embed">The <see cref="EmbedType.Rich"/> <see cref="Embed"/> to be sent.</param> | |||
| /// <param name="embeds">A array of <see cref="Embed"/>s to send with this response. Max 10</param> | |||
| /// <param name="embeds">A array of <see cref="Embed"/>s to send with this response. Max 10.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <param name="allowedMentions"> | |||
| /// Specifies if notifications are sent for mentioned users and roles in the message <paramref name="text"/>. | |||
| /// If <c>null</c>, all mentioned roles and users will be notified. | |||
| /// </param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous send operation. The task result contains the sent message. | |||
| /// </returns> | |||
| @@ -85,6 +85,7 @@ namespace Discord | |||
| /// <param name="isTTS">Whether the message should be read aloud by Discord or not.</param> | |||
| /// <param name="embed">The <see cref="EmbedType.Rich"/> <see cref="Embed"/> to be sent.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <param name="component">The message component to be included with this message. Used for interactions.</param> | |||
| /// <returns> | |||
| /// A task that represents an asynchronous send operation for delivering the message. The task result | |||
| /// contains the sent message. | |||
| @@ -142,6 +143,7 @@ namespace Discord | |||
| /// <param name="isTTS">Whether the message should be read aloud by Discord or not.</param> | |||
| /// <param name="embed">The <see cref="EmbedType.Rich"/> <see cref="Embed"/> to be sent.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <param name="component">The message component to be included with this message. Used for interactions.</param> | |||
| /// <returns> | |||
| /// A task that represents an asynchronous send operation for delivering the message. The task result | |||
| /// contains the sent message. | |||
| @@ -48,12 +48,8 @@ namespace Discord.Net | |||
| /// <summary> | |||
| /// Initializes a new instance of the <see cref="ApplicationCommandException" /> class. | |||
| /// </summary> | |||
| /// <param name="request">The request that was sent prior to the exception.</param> | |||
| /// <param name="requestJson"></param> | |||
| /// <param name="httpError"></param> | |||
| /// <param name="discordCode">The Discord status code returned.</param> | |||
| /// <param name="reason">The reason behind the exception.</param> | |||
| /// <param name="errors"></param> | |||
| public ApplicationCommandException(string requestJson, HttpException httpError) | |||
| : base("The application command failed to be created!", httpError) | |||
| { | |||
| @@ -7,7 +7,7 @@ namespace Discord.Utils | |||
| /// <summary> | |||
| /// Not full URL validation right now. Just ensures protocol is present and that it's either http or https | |||
| /// </summary> | |||
| /// <param name="url">url to validate before sending to Discord</param> | |||
| /// <param name="url">url to validate before sending to Discord.</param> | |||
| /// <exception cref="InvalidOperationException">A URL must include a protocol (http or https).</exception> | |||
| /// <returns>true if url is valid by our standard, false if null, throws an error upon invalid </returns> | |||
| public static bool Validate(string url) | |||
| @@ -1781,9 +1781,9 @@ | |||
| If <c>null</c>, all mentioned roles and users will be notified. | |||
| </param> | |||
| <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| <param name="stickers">A collection of stickers to send with the message.</param> | |||
| <param name="embeds">A array of <see cref="T:Discord.Embed"/>s to send with this response. Max 10</param> | |||
| <param name="embeds">A array of <see cref="T:Discord.Embed"/>s to send with this response. Max 10.</param> | |||
| <returns> | |||
| A task that represents an asynchronous send operation for delivering the message. The task result | |||
| contains the sent message. | |||
| @@ -1809,7 +1809,7 @@ | |||
| If <c>null</c>, all mentioned roles and users will be notified. | |||
| </param> | |||
| <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| <param name="stickers">A collection of stickers to send with the message.</param> | |||
| <returns> | |||
| A task that represents an asynchronous send operation for delivering the message. The task result | |||
| @@ -1836,7 +1836,7 @@ | |||
| If <c>null</c>, all mentioned roles and users will be notified. | |||
| </param> | |||
| <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| <param name="stickers">A collection of stickers to send with the message.</param> | |||
| <returns> | |||
| A task that represents an asynchronous send operation for delivering the message. The task result | |||
| @@ -3666,7 +3666,7 @@ | |||
| <param name="description">The description of the sticker.</param> | |||
| <param name="tags">The tags of the sticker.</param> | |||
| <param name="stream">The stream containing the file data.</param> | |||
| <param name="filename">The name of the file <b>with</b> the extension, ex: image.png</param> | |||
| <param name="filename">The name of the file <b>with</b> the extension, ex: image.png.</param> | |||
| <param name="options">The options to be used when sending the request.</param> | |||
| <returns> | |||
| A task that represents the asynchronous creation operation. The task result contains the created sticker. | |||
| @@ -25,9 +25,9 @@ namespace Discord.Rest | |||
| /// If <c>null</c>, all mentioned roles and users will be notified. | |||
| /// </param> | |||
| /// <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| /// <param name="stickers">A collection of stickers to send with the message.</param> | |||
| /// <param name="embeds">A array of <see cref="Embed"/>s to send with this response. Max 10</param> | |||
| /// <param name="embeds">A array of <see cref="Embed"/>s to send with this response. Max 10.</param> | |||
| /// <returns> | |||
| /// A task that represents an asynchronous send operation for delivering the message. The task result | |||
| /// contains the sent message. | |||
| @@ -52,7 +52,7 @@ namespace Discord.Rest | |||
| /// If <c>null</c>, all mentioned roles and users will be notified. | |||
| /// </param> | |||
| /// <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| /// <param name="stickers">A collection of stickers to send with the message.</param> | |||
| /// <returns> | |||
| /// A task that represents an asynchronous send operation for delivering the message. The task result | |||
| @@ -78,7 +78,7 @@ namespace Discord.Rest | |||
| /// If <c>null</c>, all mentioned roles and users will be notified. | |||
| /// </param> | |||
| /// <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| /// <param name="stickers">A collection of stickers to send with the message.</param> | |||
| /// <returns> | |||
| /// A task that represents an asynchronous send operation for delivering the message. The task result | |||
| @@ -494,7 +494,6 @@ namespace Discord.Rest | |||
| /// <summary> | |||
| /// Gets a collection of all stage channels in this guild. | |||
| /// </summary> | |||
| /// <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> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous get operation. The task result contains a read-only collection of | |||
| @@ -1044,7 +1043,7 @@ namespace Discord.Rest | |||
| /// <param name="description">The description of the sticker.</param> | |||
| /// <param name="tags">The tags of the sticker.</param> | |||
| /// <param name="stream">The stream containing the file data.</param> | |||
| /// <param name="filename">The name of the file <b>with</b> the extension, ex: image.png</param> | |||
| /// <param name="filename">The name of the file <b>with</b> the extension, ex: image.png.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous creation operation. The task result contains the created sticker. | |||
| @@ -27,6 +27,6 @@ namespace Discord.API.Gateway | |||
| public DateTimeOffset JoinedAt { get; set; } | |||
| [JsonProperty("threads")] | |||
| public Channel[] Threads { get; set; } | |||
| public new Channel[] Threads { get; set; } | |||
| } | |||
| } | |||
| @@ -1474,9 +1474,9 @@ | |||
| If <c>null</c>, all mentioned roles and users will be notified. | |||
| </param> | |||
| <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| <param name="stickers">A collection of stickers to send with the message.</param> | |||
| <param name="embeds">A array of <see cref="T:Discord.Embed"/>s to send with this response. Max 10</param> | |||
| <param name="embeds">A array of <see cref="T:Discord.Embed"/>s to send with this response. Max 10.</param> | |||
| <returns> | |||
| A task that represents an asynchronous send operation for delivering the message. The task result | |||
| contains the sent message. | |||
| @@ -1501,7 +1501,7 @@ | |||
| If <c>null</c>, all mentioned roles and users will be notified. | |||
| </param> | |||
| <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| <param name="stickers">A collection of stickers to send with the file.</param> | |||
| <returns> | |||
| A task that represents an asynchronous send operation for delivering the message. The task result | |||
| @@ -1528,7 +1528,7 @@ | |||
| If <c>null</c>, all mentioned roles and users will be notified. | |||
| </param> | |||
| <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| <param name="stickers">A collection of stickers to send with the file.</param> | |||
| <returns> | |||
| A task that represents an asynchronous send operation for delivering the message. The task result | |||
| @@ -3632,7 +3632,7 @@ | |||
| <param name="description">The description of the sticker.</param> | |||
| <param name="tags">The tags of the sticker.</param> | |||
| <param name="stream">The stream containing the file data.</param> | |||
| <param name="filename">The name of the file <b>with</b> the extension, ex: image.png</param> | |||
| <param name="filename">The name of the file <b>with</b> the extension, ex: image.png.</param> | |||
| <param name="options">The options to be used when sending the request.</param> | |||
| <returns> | |||
| A task that represents the asynchronous creation operation. The task result contains the created sticker. | |||
| @@ -4292,12 +4292,12 @@ | |||
| </para> | |||
| </summary> | |||
| <param name="text">The text of the message to be sent.</param> | |||
| <param name="embeds">A array of embeds to send with this response. Max 10</param> | |||
| <param name="embeds">A array of embeds to send with this response. Max 10.</param> | |||
| <param name="isTTS"><see langword="true"/> if the message should be read out by a text-to-speech reader, otherwise <see langword="false"/>.</param> | |||
| <param name="ephemeral"><see langword="true"/> if the response should be hidden to everyone besides the invoker of the command, otherwise <see langword="false"/>.</param> | |||
| <param name="allowedMentions">The allowed mentions for this response.</param> | |||
| <param name="options">The request options for this response.</param> | |||
| <param name="component">A <see cref="T:Discord.MessageComponent"/> to be sent with this response</param> | |||
| <param name="component">A <see cref="T:Discord.MessageComponent"/> to be sent with this response.</param> | |||
| <param name="embed">A single embed to send with this response. If this is passed alongside an array of embeds, the single embed will be ignored.</param> | |||
| <exception cref="T:System.ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="F:Discord.DiscordConfig.MaxMessageSize"/>.</exception> | |||
| <exception cref="T:System.InvalidOperationException">The parameters provided were invalid or the token was invalid.</exception> | |||
| @@ -4306,13 +4306,13 @@ | |||
| <summary> | |||
| Sends a followup message for this interaction. | |||
| </summary> | |||
| <param name="text">The text of the message to be sent</param> | |||
| <param name="embeds">A array of embeds to send with this response. Max 10</param> | |||
| <param name="text">The text of the message to be sent.</param> | |||
| <param name="embeds">A array of embeds to send with this response. Max 10.</param> | |||
| <param name="isTTS"><see langword="true"/> if the message should be read out by a text-to-speech reader, otherwise <see langword="false"/>.</param> | |||
| <param name="ephemeral"><see langword="true"/> if the response should be hidden to everyone besides the invoker of the command, otherwise <see langword="false"/>.</param> | |||
| <param name="allowedMentions">The allowed mentions for this response.</param> | |||
| <param name="options">The request options for this response.</param> | |||
| <param name="component">A <see cref="T:Discord.MessageComponent"/> to be sent with this response</param> | |||
| <param name="component">A <see cref="T:Discord.MessageComponent"/> to be sent with this response.</param> | |||
| <param name="embed">A single embed to send with this response. If this is passed alongside an array of embeds, the single embed will be ignored.</param> | |||
| <returns> | |||
| The sent message. | |||
| @@ -4322,15 +4322,15 @@ | |||
| <summary> | |||
| Sends a followup message for this interaction. | |||
| </summary> | |||
| <param name="text">The text of the message to be sent</param> | |||
| <param name="fileStream">The file to upload</param> | |||
| <param name="fileName">The file name of the attachment</param> | |||
| <param name="embeds">A array of embeds to send with this response. Max 10</param> | |||
| <param name="text">The text of the message to be sent.</param> | |||
| <param name="fileStream">The file to upload.</param> | |||
| <param name="fileName">The file name of the attachment.</param> | |||
| <param name="embeds">A array of embeds to send with this response. Max 10.</param> | |||
| <param name="isTTS"><see langword="true"/> if the message should be read out by a text-to-speech reader, otherwise <see langword="false"/>.</param> | |||
| <param name="ephemeral"><see langword="true"/> if the response should be hidden to everyone besides the invoker of the command, otherwise <see langword="false"/>.</param> | |||
| <param name="allowedMentions">The allowed mentions for this response.</param> | |||
| <param name="options">The request options for this response.</param> | |||
| <param name="component">A <see cref="T:Discord.MessageComponent"/> to be sent with this response</param> | |||
| <param name="component">A <see cref="T:Discord.MessageComponent"/> to be sent with this response.</param> | |||
| <param name="embed">A single embed to send with this response. If this is passed alongside an array of embeds, the single embed will be ignored.</param> | |||
| <returns> | |||
| The sent message. | |||
| @@ -4340,15 +4340,15 @@ | |||
| <summary> | |||
| Sends a followup message for this interaction. | |||
| </summary> | |||
| <param name="text">The text of the message to be sent</param> | |||
| <param name="filePath">The file to upload</param> | |||
| <param name="fileName">The file name of the attachment</param> | |||
| <param name="embeds">A array of embeds to send with this response. Max 10</param> | |||
| <param name="text">The text of the message to be sent.</param> | |||
| <param name="filePath">The file to upload.</param> | |||
| <param name="fileName">The file name of the attachment.</param> | |||
| <param name="embeds">A array of embeds to send with this response. Max 10.</param> | |||
| <param name="isTTS"><see langword="true"/> if the message should be read out by a text-to-speech reader, otherwise <see langword="false"/>.</param> | |||
| <param name="ephemeral"><see langword="true"/> if the response should be hidden to everyone besides the invoker of the command, otherwise <see langword="false"/>.</param> | |||
| <param name="allowedMentions">The allowed mentions for this response.</param> | |||
| <param name="options">The request options for this response.</param> | |||
| <param name="component">A <see cref="T:Discord.MessageComponent"/> to be sent with this response</param> | |||
| <param name="component">A <see cref="T:Discord.MessageComponent"/> to be sent with this response.</param> | |||
| <param name="embed">A single embed to send with this response. If this is passed alongside an array of embeds, the single embed will be ignored.</param> | |||
| <returns> | |||
| The sent message. | |||
| @@ -34,9 +34,9 @@ namespace Discord.WebSocket | |||
| /// If <c>null</c>, all mentioned roles and users will be notified. | |||
| /// </param> | |||
| /// <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| /// <param name="stickers">A collection of stickers to send with the message.</param> | |||
| /// <param name="embeds">A array of <see cref="Embed"/>s to send with this response. Max 10</param> | |||
| /// <param name="embeds">A array of <see cref="Embed"/>s to send with this response. Max 10.</param> | |||
| /// <returns> | |||
| /// A task that represents an asynchronous send operation for delivering the message. The task result | |||
| /// contains the sent message. | |||
| @@ -60,7 +60,7 @@ namespace Discord.WebSocket | |||
| /// If <c>null</c>, all mentioned roles and users will be notified. | |||
| /// </param> | |||
| /// <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| /// <param name="stickers">A collection of stickers to send with the file.</param> | |||
| /// <returns> | |||
| /// A task that represents an asynchronous send operation for delivering the message. The task result | |||
| @@ -86,7 +86,7 @@ namespace Discord.WebSocket | |||
| /// If <c>null</c>, all mentioned roles and users will be notified. | |||
| /// </param> | |||
| /// <param name="messageReference">The message references to be included. Used to reply to specific messages.</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions</param> | |||
| /// <param name="component">The message components to be included with this message. Used for interactions.</param> | |||
| /// <param name="stickers">A collection of stickers to send with the file.</param> | |||
| /// <returns> | |||
| /// A task that represents an asynchronous send operation for delivering the message. The task result | |||
| @@ -1376,7 +1376,7 @@ namespace Discord.WebSocket | |||
| /// <param name="description">The description of the sticker.</param> | |||
| /// <param name="tags">The tags of the sticker.</param> | |||
| /// <param name="stream">The stream containing the file data.</param> | |||
| /// <param name="filename">The name of the file <b>with</b> the extension, ex: image.png</param> | |||
| /// <param name="filename">The name of the file <b>with</b> the extension, ex: image.png.</param> | |||
| /// <param name="options">The options to be used when sending the request.</param> | |||
| /// <returns> | |||
| /// A task that represents the asynchronous creation operation. The task result contains the created sticker. | |||
| @@ -1666,10 +1666,10 @@ namespace Discord.WebSocket | |||
| Task<IVoiceChannel> IGuild.GetVoiceChannelAsync(ulong id, CacheMode mode, RequestOptions options) | |||
| => Task.FromResult<IVoiceChannel>(GetVoiceChannel(id)); | |||
| /// <inheritdoc /> | |||
| Task<IStageChannel> IGuild.GetStageChannelAsync(ulong id, CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null) | |||
| Task<IStageChannel> IGuild.GetStageChannelAsync(ulong id, CacheMode mode, RequestOptions options) | |||
| => Task.FromResult<IStageChannel>(GetStageChannel(id)); | |||
| /// <inheritdoc /> | |||
| Task<IReadOnlyCollection<IStageChannel>> IGuild.GetStageChannelsAsync(CacheMode mode = CacheMode.AllowDownload, RequestOptions options = null) | |||
| Task<IReadOnlyCollection<IStageChannel>> IGuild.GetStageChannelsAsync(CacheMode mode, RequestOptions options) | |||
| => Task.FromResult<IReadOnlyCollection<IStageChannel>>(StageChannels); | |||
| /// <inheritdoc /> | |||
| Task<IVoiceChannel> IGuild.GetAFKChannelAsync(CacheMode mode, RequestOptions options) | |||
| @@ -117,18 +117,14 @@ namespace Discord.WebSocket | |||
| /// <summary> | |||
| /// Responds to an Interaction with type <see cref="InteractionResponseType.ChannelMessageWithSource"/>. | |||
| /// <para> | |||
| /// If you have <see cref="DiscordSocketConfig.AlwaysAcknowledgeInteractions"/> set to <see langword="true"/>, You should use | |||
| /// <see cref="FollowupAsync"/> instead. | |||
| /// </para> | |||
| /// </summary> | |||
| /// <param name="text">The text of the message to be sent.</param> | |||
| /// <param name="embeds">A array of embeds to send with this response. Max 10</param> | |||
| /// <param name="embeds">A array of embeds to send with this response. Max 10.</param> | |||
| /// <param name="isTTS"><see langword="true"/> if the message should be read out by a text-to-speech reader, otherwise <see langword="false"/>.</param> | |||
| /// <param name="ephemeral"><see langword="true"/> if the response should be hidden to everyone besides the invoker of the command, otherwise <see langword="false"/>.</param> | |||
| /// <param name="allowedMentions">The allowed mentions for this response.</param> | |||
| /// <param name="options">The request options for this response.</param> | |||
| /// <param name="component">A <see cref="MessageComponent"/> to be sent with this response</param> | |||
| /// <param name="component">A <see cref="MessageComponent"/> to be sent with this response.</param> | |||
| /// <param name="embed">A single embed to send with this response. If this is passed alongside an array of embeds, the single embed will be ignored.</param> | |||
| /// <exception cref="ArgumentOutOfRangeException">Message content is too long, length must be less or equal to <see cref="DiscordConfig.MaxMessageSize"/>.</exception> | |||
| /// <exception cref="InvalidOperationException">The parameters provided were invalid or the token was invalid.</exception> | |||
| @@ -138,13 +134,13 @@ namespace Discord.WebSocket | |||
| /// <summary> | |||
| /// Sends a followup message for this interaction. | |||
| /// </summary> | |||
| /// <param name="text">The text of the message to be sent</param> | |||
| /// <param name="embeds">A array of embeds to send with this response. Max 10</param> | |||
| /// <param name="text">The text of the message to be sent.</param> | |||
| /// <param name="embeds">A array of embeds to send with this response. Max 10.</param> | |||
| /// <param name="isTTS"><see langword="true"/> if the message should be read out by a text-to-speech reader, otherwise <see langword="false"/>.</param> | |||
| /// <param name="ephemeral"><see langword="true"/> if the response should be hidden to everyone besides the invoker of the command, otherwise <see langword="false"/>.</param> | |||
| /// <param name="allowedMentions">The allowed mentions for this response.</param> | |||
| /// <param name="options">The request options for this response.</param> | |||
| /// <param name="component">A <see cref="MessageComponent"/> to be sent with this response</param> | |||
| /// <param name="component">A <see cref="MessageComponent"/> to be sent with this response.</param> | |||
| /// <param name="embed">A single embed to send with this response. If this is passed alongside an array of embeds, the single embed will be ignored.</param> | |||
| /// <returns> | |||
| /// The sent message. | |||
| @@ -155,15 +151,15 @@ namespace Discord.WebSocket | |||
| /// <summary> | |||
| /// Sends a followup message for this interaction. | |||
| /// </summary> | |||
| /// <param name="text">The text of the message to be sent</param> | |||
| /// <param name="fileStream">The file to upload</param> | |||
| /// <param name="fileName">The file name of the attachment</param> | |||
| /// <param name="embeds">A array of embeds to send with this response. Max 10</param> | |||
| /// <param name="text">The text of the message to be sent.</param> | |||
| /// <param name="fileStream">The file to upload.</param> | |||
| /// <param name="fileName">The file name of the attachment.</param> | |||
| /// <param name="embeds">A array of embeds to send with this response. Max 10.</param> | |||
| /// <param name="isTTS"><see langword="true"/> if the message should be read out by a text-to-speech reader, otherwise <see langword="false"/>.</param> | |||
| /// <param name="ephemeral"><see langword="true"/> if the response should be hidden to everyone besides the invoker of the command, otherwise <see langword="false"/>.</param> | |||
| /// <param name="allowedMentions">The allowed mentions for this response.</param> | |||
| /// <param name="options">The request options for this response.</param> | |||
| /// <param name="component">A <see cref="MessageComponent"/> to be sent with this response</param> | |||
| /// <param name="component">A <see cref="MessageComponent"/> to be sent with this response.</param> | |||
| /// <param name="embed">A single embed to send with this response. If this is passed alongside an array of embeds, the single embed will be ignored.</param> | |||
| /// <returns> | |||
| /// The sent message. | |||
| @@ -174,15 +170,15 @@ namespace Discord.WebSocket | |||
| /// <summary> | |||
| /// Sends a followup message for this interaction. | |||
| /// </summary> | |||
| /// <param name="text">The text of the message to be sent</param> | |||
| /// <param name="filePath">The file to upload</param> | |||
| /// <param name="fileName">The file name of the attachment</param> | |||
| /// <param name="embeds">A array of embeds to send with this response. Max 10</param> | |||
| /// <param name="text">The text of the message to be sent.</param> | |||
| /// <param name="filePath">The file to upload.</param> | |||
| /// <param name="fileName">The file name of the attachment.</param> | |||
| /// <param name="embeds">A array of embeds to send with this response. Max 10.</param> | |||
| /// <param name="isTTS"><see langword="true"/> if the message should be read out by a text-to-speech reader, otherwise <see langword="false"/>.</param> | |||
| /// <param name="ephemeral"><see langword="true"/> if the response should be hidden to everyone besides the invoker of the command, otherwise <see langword="false"/>.</param> | |||
| /// <param name="allowedMentions">The allowed mentions for this response.</param> | |||
| /// <param name="options">The request options for this response.</param> | |||
| /// <param name="component">A <see cref="MessageComponent"/> to be sent with this response</param> | |||
| /// <param name="component">A <see cref="MessageComponent"/> to be sent with this response.</param> | |||
| /// <param name="embed">A single embed to send with this response. If this is passed alongside an array of embeds, the single embed will be ignored.</param> | |||
| /// <returns> | |||
| /// The sent message. | |||
| @@ -18,7 +18,7 @@ namespace TestHelper | |||
| /// Apply the inputted CodeAction to the inputted document. | |||
| /// Meant to be used to apply codefixes. | |||
| /// </summary> | |||
| /// <param name="document">The Document to apply the fix on</param> | |||
| /// <param name="document">The Document to apply the fix on.</param> | |||
| /// <param name="codeAction">A CodeAction that will be applied to the Document.</param> | |||
| /// <returns>A Document with the changes from the CodeAction</returns> | |||
| private static Document ApplyFix(Document document, CodeAction codeAction) | |||
| @@ -33,8 +33,8 @@ namespace TestHelper | |||
| /// Note: Considers Diagnostics to be the same if they have the same Ids. In the case of multiple diagnostics with the same Id in a row, | |||
| /// this method may not necessarily return the new one. | |||
| /// </summary> | |||
| /// <param name="diagnostics">The Diagnostics that existed in the code before the CodeFix was applied</param> | |||
| /// <param name="newDiagnostics">The Diagnostics that exist in the code after the CodeFix was applied</param> | |||
| /// <param name="diagnostics">The Diagnostics that existed in the code before the CodeFix was applied.</param> | |||
| /// <param name="newDiagnostics">The Diagnostics that exist in the code after the CodeFix was applied.</param> | |||
| /// <returns>A list of Diagnostics that only surfaced in the code after the CodeFix was applied</returns> | |||
| private static IEnumerable<Diagnostic> GetNewDiagnostics(IEnumerable<Diagnostic> diagnostics, IEnumerable<Diagnostic> newDiagnostics) | |||
| { | |||
| @@ -61,7 +61,7 @@ namespace TestHelper | |||
| /// <summary> | |||
| /// Get the existing compiler diagnostics on the inputted document. | |||
| /// </summary> | |||
| /// <param name="document">The Document to run the compiler diagnostic analyzers on</param> | |||
| /// <param name="document">The Document to run the compiler diagnostic analyzers on.</param> | |||
| /// <returns>The compiler diagnostics that were found in the code</returns> | |||
| private static IEnumerable<Diagnostic> GetCompilerDiagnostics(Document document) | |||
| { | |||
| @@ -71,7 +71,7 @@ namespace TestHelper | |||
| /// <summary> | |||
| /// Given a document, turn it into a string based on the syntax root | |||
| /// </summary> | |||
| /// <param name="document">The Document to be converted to a string</param> | |||
| /// <param name="document">The Document to be converted to a string.</param> | |||
| /// <returns>A string containing the syntax of the Document after formatting</returns> | |||
| private static string GetStringFromDocument(Document document) | |||
| { | |||
| @@ -35,9 +35,9 @@ namespace TestHelper | |||
| /// <summary> | |||
| /// Given classes in the form of strings, their language, and an IDiagnosticAnlayzer to apply to it, return the diagnostics found in the string after converting it to a document. | |||
| /// </summary> | |||
| /// <param name="sources">Classes in the form of strings</param> | |||
| /// <param name="language">The language the source classes are in</param> | |||
| /// <param name="analyzer">The analyzer to be run on the sources</param> | |||
| /// <param name="sources">Classes in the form of strings.</param> | |||
| /// <param name="language">The language the source classes are in.</param> | |||
| /// <param name="analyzer">The analyzer to be run on the sources.</param> | |||
| /// <returns>An IEnumerable of Diagnostics that surfaced in the source code, sorted by Location</returns> | |||
| private static Diagnostic[] GetSortedDiagnostics(string[] sources, string language, DiagnosticAnalyzer analyzer) | |||
| { | |||
| @@ -48,8 +48,8 @@ namespace TestHelper | |||
| /// Given an analyzer and a document to apply it to, run the analyzer and gather an array of diagnostics found in it. | |||
| /// The returned diagnostics are then ordered by location in the source document. | |||
| /// </summary> | |||
| /// <param name="analyzer">The analyzer to run on the documents</param> | |||
| /// <param name="documents">The Documents that the analyzer will be run on</param> | |||
| /// <param name="analyzer">The analyzer to run on the documents.</param> | |||
| /// <param name="documents">The Documents that the analyzer will be run on.</param> | |||
| /// <returns>An IEnumerable of Diagnostics that surfaced in the source code, sorted by Location</returns> | |||
| protected static Diagnostic[] GetSortedDiagnosticsFromDocuments(DiagnosticAnalyzer analyzer, Document[] documents) | |||
| { | |||
| @@ -93,7 +93,7 @@ namespace TestHelper | |||
| /// <summary> | |||
| /// Sort diagnostics by location in source document | |||
| /// </summary> | |||
| /// <param name="diagnostics">The list of Diagnostics to be sorted</param> | |||
| /// <param name="diagnostics">The list of Diagnostics to be sorted.</param> | |||
| /// <returns>An IEnumerable containing the Diagnostics in order of Location</returns> | |||
| private static Diagnostic[] SortDiagnostics(IEnumerable<Diagnostic> diagnostics) | |||
| { | |||
| @@ -106,8 +106,8 @@ namespace TestHelper | |||
| /// <summary> | |||
| /// Given an array of strings as sources and a language, turn them into a project and return the documents and spans of it. | |||
| /// </summary> | |||
| /// <param name="sources">Classes in the form of strings</param> | |||
| /// <param name="language">The language the source code is in</param> | |||
| /// <param name="sources">Classes in the form of strings.</param> | |||
| /// <param name="language">The language the source code is in.</param> | |||
| /// <returns>A Tuple containing the Documents produced from the sources and their TextSpans if relevant</returns> | |||
| private static Document[] GetDocuments(string[] sources, string language) | |||
| { | |||
| @@ -130,8 +130,8 @@ namespace TestHelper | |||
| /// <summary> | |||
| /// Create a Document from a string through creating a project that contains it. | |||
| /// </summary> | |||
| /// <param name="source">Classes in the form of a string</param> | |||
| /// <param name="language">The language the source code is in</param> | |||
| /// <param name="source">Classes in the form of a string.</param> | |||
| /// <param name="language">The language the source code is in.</param> | |||
| /// <returns>A Document created from the source string</returns> | |||
| protected static Document CreateDocument(string source, string language = LanguageNames.CSharp) | |||
| { | |||
| @@ -141,8 +141,8 @@ namespace TestHelper | |||
| /// <summary> | |||
| /// Create a project using the inputted strings as sources. | |||
| /// </summary> | |||
| /// <param name="sources">Classes in the form of strings</param> | |||
| /// <param name="language">The language the source code is in</param> | |||
| /// <param name="sources">Classes in the form of strings.</param> | |||
| /// <param name="language">The language the source code is in.</param> | |||
| /// <returns>A Project created out of the Documents created from the source strings</returns> | |||
| private static Project CreateProject(string[] sources, string language = LanguageNames.CSharp) | |||
| { | |||
| @@ -1,4 +1,4 @@ | |||
| using Microsoft.CodeAnalysis; | |||
| using Microsoft.CodeAnalysis; | |||
| using Microsoft.CodeAnalysis.CodeActions; | |||
| using Microsoft.CodeAnalysis.CodeFixes; | |||
| using Microsoft.CodeAnalysis.Diagnostics; | |||
| @@ -38,10 +38,10 @@ namespace TestHelper | |||
| /// <summary> | |||
| /// Called to test a C# codefix when applied on the inputted string as a source | |||
| /// </summary> | |||
| /// <param name="oldSource">A class in the form of a string before the CodeFix was applied to it</param> | |||
| /// <param name="newSource">A class in the form of a string after the CodeFix was applied to it</param> | |||
| /// <param name="codeFixIndex">Index determining which codefix to apply if there are multiple</param> | |||
| /// <param name="allowNewCompilerDiagnostics">A bool controlling whether or not the test will fail if the CodeFix introduces other warnings after being applied</param> | |||
| /// <param name="oldSource">A class in the form of a string before the CodeFix was applied to it.</param> | |||
| /// <param name="newSource">A class in the form of a string after the CodeFix was applied to it.</param> | |||
| /// <param name="codeFixIndex">Index determining which codefix to apply if there are multiple.</param> | |||
| /// <param name="allowNewCompilerDiagnostics">A bool controlling whether or not the test will fail if the CodeFix introduces other warnings after being applied.</param> | |||
| protected void VerifyCSharpFix(string oldSource, string newSource, int? codeFixIndex = null, bool allowNewCompilerDiagnostics = false) | |||
| { | |||
| VerifyFix(LanguageNames.CSharp, GetCSharpDiagnosticAnalyzer(), GetCSharpCodeFixProvider(), oldSource, newSource, codeFixIndex, allowNewCompilerDiagnostics); | |||
| @@ -50,10 +50,10 @@ namespace TestHelper | |||
| /// <summary> | |||
| /// Called to test a VB codefix when applied on the inputted string as a source | |||
| /// </summary> | |||
| /// <param name="oldSource">A class in the form of a string before the CodeFix was applied to it</param> | |||
| /// <param name="newSource">A class in the form of a string after the CodeFix was applied to it</param> | |||
| /// <param name="codeFixIndex">Index determining which codefix to apply if there are multiple</param> | |||
| /// <param name="allowNewCompilerDiagnostics">A bool controlling whether or not the test will fail if the CodeFix introduces other warnings after being applied</param> | |||
| /// <param name="oldSource">A class in the form of a string before the CodeFix was applied to it.</param> | |||
| /// <param name="newSource">A class in the form of a string after the CodeFix was applied to it.</param> | |||
| /// <param name="codeFixIndex">Index determining which codefix to apply if there are multiple.</param> | |||
| /// <param name="allowNewCompilerDiagnostics">A bool controlling whether or not the test will fail if the CodeFix introduces other warnings after being applied.</param> | |||
| protected void VerifyBasicFix(string oldSource, string newSource, int? codeFixIndex = null, bool allowNewCompilerDiagnostics = false) | |||
| { | |||
| VerifyFix(LanguageNames.VisualBasic, GetBasicDiagnosticAnalyzer(), GetBasicCodeFixProvider(), oldSource, newSource, codeFixIndex, allowNewCompilerDiagnostics); | |||
| @@ -65,13 +65,13 @@ namespace TestHelper | |||
| /// Then gets the string after the codefix is applied and compares it with the expected result. | |||
| /// Note: If any codefix causes new diagnostics to show up, the test fails unless allowNewCompilerDiagnostics is set to true. | |||
| /// </summary> | |||
| /// <param name="language">The language the source code is in</param> | |||
| /// <param name="analyzer">The analyzer to be applied to the source code</param> | |||
| /// <param name="codeFixProvider">The codefix to be applied to the code wherever the relevant Diagnostic is found</param> | |||
| /// <param name="oldSource">A class in the form of a string before the CodeFix was applied to it</param> | |||
| /// <param name="newSource">A class in the form of a string after the CodeFix was applied to it</param> | |||
| /// <param name="codeFixIndex">Index determining which codefix to apply if there are multiple</param> | |||
| /// <param name="allowNewCompilerDiagnostics">A bool controlling whether or not the test will fail if the CodeFix introduces other warnings after being applied</param> | |||
| /// <param name="language">The language the source code is in.</param> | |||
| /// <param name="analyzer">The analyzer to be applied to the source code.</param> | |||
| /// <param name="codeFixProvider">The codefix to be applied to the code wherever the relevant Diagnostic is found.</param> | |||
| /// <param name="oldSource">A class in the form of a string before the CodeFix was applied to it.</param> | |||
| /// <param name="newSource">A class in the form of a string after the CodeFix was applied to it.</param> | |||
| /// <param name="codeFixIndex">Index determining which codefix to apply if there are multiple.</param> | |||
| /// <param name="allowNewCompilerDiagnostics">A bool controlling whether or not the test will fail if the CodeFix introduces other warnings after being applied.</param> | |||
| private void VerifyFix(string language, DiagnosticAnalyzer analyzer, CodeFixProvider codeFixProvider, string oldSource, string newSource, int? codeFixIndex, bool allowNewCompilerDiagnostics) | |||
| { | |||
| var document = CreateDocument(oldSource, language); | |||
| @@ -126,4 +126,4 @@ namespace TestHelper | |||
| Assert.Equal(newSource, actual); | |||
| } | |||
| } | |||
| } | |||
| } | |||
| @@ -37,8 +37,8 @@ namespace TestHelper | |||
| /// Called to test a C# DiagnosticAnalyzer when applied on the single inputted string as a source | |||
| /// Note: input a DiagnosticResult for each Diagnostic expected | |||
| /// </summary> | |||
| /// <param name="source">A class in the form of a string to run the analyzer on</param> | |||
| /// <param name="expected"> DiagnosticResults that should appear after the analyzer is run on the source</param> | |||
| /// <param name="source">A class in the form of a string to run the analyzer on.</param> | |||
| /// <param name="expected"> DiagnosticResults that should appear after the analyzer is run on the source.</param> | |||
| protected void VerifyCSharpDiagnostic(string source, params DiagnosticResult[] expected) | |||
| { | |||
| VerifyDiagnostics(new[] { source }, LanguageNames.CSharp, GetCSharpDiagnosticAnalyzer(), expected); | |||
| @@ -48,8 +48,8 @@ namespace TestHelper | |||
| /// Called to test a VB DiagnosticAnalyzer when applied on the single inputted string as a source | |||
| /// Note: input a DiagnosticResult for each Diagnostic expected | |||
| /// </summary> | |||
| /// <param name="source">A class in the form of a string to run the analyzer on</param> | |||
| /// <param name="expected">DiagnosticResults that should appear after the analyzer is run on the source</param> | |||
| /// <param name="source">A class in the form of a string to run the analyzer on.</param> | |||
| /// <param name="expected">DiagnosticResults that should appear after the analyzer is run on the source.</param> | |||
| protected void VerifyBasicDiagnostic(string source, params DiagnosticResult[] expected) | |||
| { | |||
| VerifyDiagnostics(new[] { source }, LanguageNames.VisualBasic, GetBasicDiagnosticAnalyzer(), expected); | |||
| @@ -59,8 +59,8 @@ namespace TestHelper | |||
| /// Called to test a C# DiagnosticAnalyzer when applied on the inputted strings as a source | |||
| /// Note: input a DiagnosticResult for each Diagnostic expected | |||
| /// </summary> | |||
| /// <param name="sources">An array of strings to create source documents from to run the analyzers on</param> | |||
| /// <param name="expected">DiagnosticResults that should appear after the analyzer is run on the sources</param> | |||
| /// <param name="sources">An array of strings to create source documents from to run the analyzers on.</param> | |||
| /// <param name="expected">DiagnosticResults that should appear after the analyzer is run on the sources.</param> | |||
| protected void VerifyCSharpDiagnostic(string[] sources, params DiagnosticResult[] expected) | |||
| { | |||
| VerifyDiagnostics(sources, LanguageNames.CSharp, GetCSharpDiagnosticAnalyzer(), expected); | |||
| @@ -70,8 +70,8 @@ namespace TestHelper | |||
| /// Called to test a VB DiagnosticAnalyzer when applied on the inputted strings as a source | |||
| /// Note: input a DiagnosticResult for each Diagnostic expected | |||
| /// </summary> | |||
| /// <param name="sources">An array of strings to create source documents from to run the analyzers on</param> | |||
| /// <param name="expected">DiagnosticResults that should appear after the analyzer is run on the sources</param> | |||
| /// <param name="sources">An array of strings to create source documents from to run the analyzers on.</param> | |||
| /// <param name="expected">DiagnosticResults that should appear after the analyzer is run on the sources.</param> | |||
| protected void VerifyBasicDiagnostic(string[] sources, params DiagnosticResult[] expected) | |||
| { | |||
| VerifyDiagnostics(sources, LanguageNames.VisualBasic, GetBasicDiagnosticAnalyzer(), expected); | |||
| @@ -81,10 +81,10 @@ namespace TestHelper | |||
| /// General method that gets a collection of actual diagnostics found in the source after the analyzer is run, | |||
| /// then verifies each of them. | |||
| /// </summary> | |||
| /// <param name="sources">An array of strings to create source documents from to run the analyzers on</param> | |||
| /// <param name="language">The language of the classes represented by the source strings</param> | |||
| /// <param name="analyzer">The analyzer to be run on the source code</param> | |||
| /// <param name="expected">DiagnosticResults that should appear after the analyzer is run on the sources</param> | |||
| /// <param name="sources">An array of strings to create source documents from to run the analyzers on.</param> | |||
| /// <param name="language">The language of the classes represented by the source strings.</param> | |||
| /// <param name="analyzer">The analyzer to be run on the source code.</param> | |||
| /// <param name="expected">DiagnosticResults that should appear after the analyzer is run on the sources.</param> | |||
| private void VerifyDiagnostics(string[] sources, string language, DiagnosticAnalyzer analyzer, params DiagnosticResult[] expected) | |||
| { | |||
| var diagnostics = GetSortedDiagnostics(sources, language, analyzer); | |||
| @@ -98,9 +98,9 @@ namespace TestHelper | |||
| /// Checks each of the actual Diagnostics found and compares them with the corresponding DiagnosticResult in the array of expected results. | |||
| /// Diagnostics are considered equal only if the DiagnosticResultLocation, Id, Severity, and Message of the DiagnosticResult match the actual diagnostic. | |||
| /// </summary> | |||
| /// <param name="actualResults">The Diagnostics found by the compiler after running the analyzer on the source code</param> | |||
| /// <param name="analyzer">The analyzer that was being run on the sources</param> | |||
| /// <param name="expectedResults">Diagnostic Results that should have appeared in the code</param> | |||
| /// <param name="actualResults">The Diagnostics found by the compiler after running the analyzer on the source code.</param> | |||
| /// <param name="analyzer">The analyzer that was being run on the sources.</param> | |||
| /// <param name="expectedResults">Diagnostic Results that should have appeared in the code.</param> | |||
| private static void VerifyDiagnosticResults(IEnumerable<Diagnostic> actualResults, DiagnosticAnalyzer analyzer, params DiagnosticResult[] expectedResults) | |||
| { | |||
| int expectedCount = expectedResults.Length; | |||
| @@ -173,10 +173,10 @@ namespace TestHelper | |||
| /// <summary> | |||
| /// Helper method to VerifyDiagnosticResult that checks the location of a diagnostic and compares it with the location in the expected DiagnosticResult. | |||
| /// </summary> | |||
| /// <param name="analyzer">The analyzer that was being run on the sources</param> | |||
| /// <param name="diagnostic">The diagnostic that was found in the code</param> | |||
| /// <param name="actual">The Location of the Diagnostic found in the code</param> | |||
| /// <param name="expected">The DiagnosticResultLocation that should have been found</param> | |||
| /// <param name="analyzer">The analyzer that was being run on the sources.</param> | |||
| /// <param name="diagnostic">The diagnostic that was found in the code.</param> | |||
| /// <param name="actual">The Location of the Diagnostic found in the code.</param> | |||
| /// <param name="expected">The DiagnosticResultLocation that should have been found.</param> | |||
| private static void VerifyDiagnosticLocation(DiagnosticAnalyzer analyzer, Diagnostic diagnostic, Location actual, DiagnosticResultLocation expected) | |||
| { | |||
| var actualSpan = actual.GetLineSpan(); | |||
| @@ -215,8 +215,8 @@ namespace TestHelper | |||
| /// <summary> | |||
| /// Helper method to format a Diagnostic into an easily readable string | |||
| /// </summary> | |||
| /// <param name="analyzer">The analyzer that this verifier tests</param> | |||
| /// <param name="diagnostics">The Diagnostics to be formatted</param> | |||
| /// <param name="analyzer">The analyzer that this verifier tests.</param> | |||
| /// <param name="diagnostics">The Diagnostics to be formatted.</param> | |||
| /// <returns>The Diagnostics formatted as a string</returns> | |||
| private static string FormatDiagnostics(DiagnosticAnalyzer analyzer, params Diagnostic[] diagnostics) | |||
| { | |||