MailMessage.SubjectEncoding Property

Reference

Definition

Namespace:: System.Net.Mail

Assemblies:: netstandard.dll, System.Net.Mail.dll

Assembly:: System.Net.Mail.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Source:: MailMessage.cs

Source:: MailMessage.cs

Source:: MailMessage.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the encoding used for the subject content for this email message.

public:
 property System::Text::Encoding ^ SubjectEncoding { System::Text::Encoding ^ get(); void set(System::Text::Encoding ^ value); };

public System.Text.Encoding? SubjectEncoding { get; set; }

public System.Text.Encoding SubjectEncoding { get; set; }

member this.SubjectEncoding : System.Text.Encoding with get, set

Public Property SubjectEncoding As Encoding

Property Value

Encoding

An Encoding that was used to encode the Subject property.

Examples

The following code example demonstrates setting the SubjectEncoding property.

MailMessage^ message = gcnew MailMessage(from, to);
message->Body = "This is a test email message sent" +
    " by an application. ";
// Include some non-ASCII characters in body and 
// subject.
String^ someArrows = gcnew String(gcnew array<wchar_t>{L'\u2190', 
    L'\u2191', L'\u2192', L'\u2193'});
message->Body += Environment::NewLine + someArrows;
message->BodyEncoding = System::Text::Encoding::UTF8;
message->Subject = "test message 1" + someArrows;
message->SubjectEncoding = System::Text::Encoding::UTF8;

MailMessage message = new MailMessage(from, to);
message.Body = "This is a test email message sent by an application. ";
// Include some non-ASCII characters in body and subject.
string someArrows = new string(new char[] {'\u2190', '\u2191', '\u2192', '\u2193'});
message.Body += Environment.NewLine + someArrows;
message.BodyEncoding =  System.Text.Encoding.UTF8;
message.Subject = "test message 1" + someArrows;
message.SubjectEncoding = System.Text.Encoding.UTF8;

Dim message As New MailMessage(mailFrom, mailTo)
message.Body = "This is a test email message sent by an application. "
' Include some non-ASCII characters in body and subject.
Dim someArrows As New String(New Char() {ChrW(&H2190), ChrW(&H2191), ChrW(&H2192), ChrW(&H2193)})
message.Body += Environment.NewLine & someArrows
message.BodyEncoding = System.Text.Encoding.UTF8
message.Subject = "test message 1" & someArrows
message.SubjectEncoding = System.Text.Encoding.UTF8

Remarks

If a mail agent has difficulty with a SubjectEncoding of Unicode, use UTF8.

Applies to

Product	Versions
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Share via