Description
Type of issue
Missing information
Description
The System.Net.Mail's MailMessage.To property documentation webpage should explicitly/directly mention it uses commas as delimiters.
The page https://learn.microsoft.com/en-us/dotnet/api/system.net.mail.mailmessage.to does not make any mention of this. You must click through to the linked MailAddressCollection documentation page, and then finally click through again to the MailAddress documentation page and scroll down to the halfway point of the remarks page.
I believe this is a major oversight in the documentation because of how common it is for users to send email this way, and there are no shortage of blog posts and articles online that discuss System.Web.Mail or System.Net.Mail, and don't clearly explain this particular, critical difference between the two. Likewise, there are hundreds if not thousands of questions on Stack Overflow and similar online forums/Q&A sites where users have tried to use a comma where a semicolon was required, or vice versa.
All of those questions and headaches could have possibly been avoided if the System.Net.Mail MailMessage.To page simply mentioned multiple addresses must be delimited with commas.
In contrast with the above, the fact that a semicolon is used as the delimiter for System.Web.Mail is mentioned on its MailMessage.To documentation page in the very first sentence: https://learn.microsoft.com/en-us/dotnet/api/system.web.mail.mailmessage.to
Page URL
https://learn.microsoft.com/en-us/dotnet/api/system.net.mail.mailmessage.to?view=net-9.0
Content source URL
https://github.com/dotnet/dotnet-api-docs/blob/main/xml/System.Net.Mail/MailMessage.xml
Document Version Independent Id
e3505744-34fc-ca35-c9d0-9f7c4c9e34a1
Platform Id
a1fe5f74-c0bc-ddf3-1653-356df964823b