@@ -4744,8 +4744,11 @@ | |||
Builds this builder into a <see cref="T:Discord.ButtonComponent"/> to be used in a <see cref="T:Discord.ComponentBuilder"/>. | |||
</summary> | |||
<returns>A <see cref="T:Discord.ButtonComponent"/> to be used in a <see cref="T:Discord.ComponentBuilder"/>.</returns> | |||
<exception cref="T:System.InvalidOperationException">A button cannot contain a <see cref="P:Discord.ButtonBuilder.Url"/> and a <see cref="P:Discord.ButtonBuilder.CustomId"/>.</exception> | |||
<exception cref="T:System.InvalidOperationException">A button must contain either a <see cref="P:Discord.ButtonBuilder.Url"/> or a <see cref="P:Discord.ButtonBuilder.CustomId"/>, but not both.</exception> | |||
<exception cref="T:System.InvalidOperationException">A button must have an <see cref="P:Discord.ButtonBuilder.Emote"/> or a <see cref="P:Discord.ButtonBuilder.Label"/>.</exception> | |||
<exception cref="T:System.InvalidOperationException">A link button must contain a URL.</exception> | |||
<exception cref="T:System.InvalidOperationException">A link must include a protocol (http or https).</exception> | |||
<exception cref="T:System.InvalidOperationException">A non-link button must contain a custom id</exception> | |||
</member> | |||
<member name="T:Discord.SelectMenuBuilder"> | |||
<summary> | |||
@@ -6038,6 +6041,7 @@ | |||
The built embed object. | |||
</returns> | |||
<exception cref="T:System.InvalidOperationException">Total embed length exceeds <see cref="F:Discord.EmbedBuilder.MaxEmbedLength"/>.</exception> | |||
<exception cref="T:System.InvalidOperationException">Any Url must include protocols (i.e http:// or https://).</exception> | |||
</member> | |||
<member name="T:Discord.EmbedFieldBuilder"> | |||
<summary> | |||
@@ -520,21 +520,29 @@ namespace Discord | |||
/// Builds this builder into a <see cref="ButtonComponent"/> to be used in a <see cref="ComponentBuilder"/>. | |||
/// </summary> | |||
/// <returns>A <see cref="ButtonComponent"/> to be used in a <see cref="ComponentBuilder"/>.</returns> | |||
/// <exception cref="InvalidOperationException">A button cannot contain a <see cref="Url"/> and a <see cref="CustomId"/>.</exception> | |||
/// <exception cref="InvalidOperationException">A button must contain either a <see cref="Url"/> or a <see cref="CustomId"/>, but not both.</exception> | |||
/// <exception cref="InvalidOperationException">A button must have an <see cref="Emote"/> or a <see cref="Label"/>.</exception> | |||
/// <exception cref="InvalidOperationException">A link button must contain a URL.</exception> | |||
/// <exception cref="InvalidOperationException">A URL must include a protocol (http or https).</exception> | |||
/// <exception cref="InvalidOperationException">A non-link button must contain a custom id</exception> | |||
public ButtonComponent Build() | |||
{ | |||
if (string.IsNullOrEmpty(this.Label) && this.Emote == null) | |||
throw new InvalidOperationException("A button must have an Emote or a label!"); | |||
if (!string.IsNullOrEmpty(this.Url) && !string.IsNullOrEmpty(this.CustomId)) | |||
throw new InvalidOperationException("A button cannot contain a URL and a CustomId!"); | |||
if (!(string.IsNullOrEmpty(this.Url) ^ string.IsNullOrEmpty(this.CustomId))) | |||
throw new InvalidOperationException("A button must contain either a URL or a CustomId, but not both!"); | |||
if (this.Style == ButtonStyle.Link && !string.IsNullOrEmpty(this.CustomId)) | |||
this.CustomId = null; | |||
else if (this.Style != ButtonStyle.Link && !string.IsNullOrEmpty(this.Url)) // Thanks 𝑴𝒓𝑪𝒂𝒌𝒆𝑺𝒍𝒂𝒚𝒆𝒓 :D | |||
this.Url = null; | |||
if (this.Style == ButtonStyle.Link) | |||
{ | |||
if (string.IsNullOrEmpty(this.Url)) | |||
throw new InvalidOperationException("Link buttons must have a link associated with them"); | |||
else if (!Uri.IsWellFormedUriString(this.Url, UriKind.Absolute)) | |||
throw new InvalidOperationException("Urls must be well formatted and include their protocol (either HTTP or HTTPS)"); | |||
} | |||
else if (string.IsNullOrEmpty(this.CustomId)) | |||
throw new InvalidOperationException("Non-link buttons must have a custom id associated with them"); | |||
return new ButtonComponent(this.Style, this.Label, this.Emote, this.CustomId, this.Url, this.Disabled); | |||
} | |||
@@ -401,10 +401,24 @@ namespace Discord | |||
/// The built embed object. | |||
/// </returns> | |||
/// <exception cref="InvalidOperationException">Total embed length exceeds <see cref="MaxEmbedLength"/>.</exception> | |||
/// <exception cref="InvalidOperationException">Any Url must be well formatted include its protocols (i.e http:// or https://).</exception> | |||
public Embed Build() | |||
{ | |||
if (Length > MaxEmbedLength) | |||
throw new InvalidOperationException($"Total embed length must be less than or equal to {MaxEmbedLength}."); | |||
if (!string.IsNullOrEmpty(Url) && !Uri.IsWellFormedUriString(Url, UriKind.Absolute)) | |||
throw new InvalidOperationException("Url must be well formatted and include its protocol (either HTTP or HTTPS)"); | |||
if (!string.IsNullOrEmpty(ThumbnailUrl) && !Uri.IsWellFormedUriString(ThumbnailUrl, UriKind.Absolute)) | |||
throw new InvalidOperationException("Thumbnail Url must be well formatted and include its protocol (either HTTP or HTTPS)"); | |||
if (!string.IsNullOrEmpty(ImageUrl) && !Uri.IsWellFormedUriString(ImageUrl, UriKind.Absolute)) | |||
throw new InvalidOperationException("Image Url must be well formatted and include its protocol (either HTTP or HTTPS)"); | |||
if (Author != null) | |||
{ | |||
if(!string.IsNullOrEmpty(Author.Url) && !Uri.IsWellFormedUriString(Author.Url, UriKind.Absolute)) | |||
throw new InvalidOperationException("Author Url must be well formatted and include its protocol (either HTTP or HTTPS)"); | |||
if (!string.IsNullOrEmpty(Author.IconUrl) && !Uri.IsWellFormedUriString(Author.IconUrl, UriKind.Absolute)) | |||
throw new InvalidOperationException("Author Icon Url must be well formatted and include its protocol (either HTTP or HTTPS)"); | |||
} | |||
var fields = ImmutableArray.CreateBuilder<EmbedField>(Fields.Count); | |||
for (int i = 0; i < Fields.Count; i++) | |||