diff --git a/xml/System.Net.Mail/SmtpClient.xml b/xml/System.Net.Mail/SmtpClient.xml index b9c2d21cd2c..c9fc6ed4223 100644 --- a/xml/System.Net.Mail/SmtpClient.xml +++ b/xml/System.Net.Mail/SmtpClient.xml @@ -29,23 +29,25 @@ System.IDisposable - - - System.Obsolete("SmtpClient and its network of types are poorly designed, we strongly recommend you use https://github.com/jstedfast/MailKit and https://github.com/jstedfast/MimeKit instead") - - Allows applications to send email by using the Simple Mail Transfer Protocol (SMTP). The SmtpClient type is now obsolete. [!IMPORTANT] -> We don't recommend that you use the `SmtpClient` class for new development. For more information, see [SmtpClient shouldn't be used](https://github.com/dotnet/platform-compat/blob/master/docs/DE0005.md) on GitHub. +> We don't recommend that you use the `SmtpClient` class for new development because `SmtpClient` doesn't support many modern protocols. Use [MailKit](https://github.com/jstedfast/MailKit) or other libraries instead. For more information, see [SmtpClient shouldn't be used](https://github.com/dotnet/platform-compat/blob/master/docs/DE0005.md) on GitHub. + +The `SmtpClient` class is obsolete in Xamarin. However: + +- It is included in the .NET Standard 2.0 and later versions and therefore must be part of any .NET implementation that supports those versions. +- It is present and can be used in .NET Framework 4 through .NET Framework 4.8. +- It is usable in .NET Core, but its use isn't recommended. - The classes shown in the following table are used to construct email messages that can be sent using . +The classes shown in the following table are used to construct email messages that can be sent using . |Class|Description| |-----------|-----------------|