This documentation is archived and is not being maintained.

MailMessage.BodyEncoding Property

Gets or sets the encoding used to encode the message body.

Namespace:  System.Net.Mail
Assembly:  System (in System.dll)

public Encoding BodyEncoding { get; set; }

Property Value

Type: System.Text.Encoding
An Encoding applied to the contents of the Body.

The value specified for the BodyEncoding property sets the character set field in the Content-Type header. The default character set is "us-ascii".

If you set the BodyEncoding property to UTF8, Unicode, or UTF32, the Framework selects a TransferEncoding of Base64 for this MailMessage.

The following code example demonstrates creating a mail message that uses UTF8 encoding.

MailMessage message = new MailMessage(from, to);
message.Body = "This is a test e-mail 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;

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: