Charset Property

[This is preliminary documentation and subject to change.]

The character set for the body part.

[Visual Basic]
Property Charset as String
[C++]
HRESULT get_Charset(BSTR* pVal);
HRESULT put_Charset(BSTR Val);
[IDL]
HRESULT [propget] Charset([out,retval] BSTR* pVal);
HRESULT [propput] Charset([in] BSTR Val);

Remarks

The Charset property corresponds to the "charset" attribute parameter of the Content-Type header field of RFC 2045. Charset does not include any types or subtypes. Only text body parts have an associated character set.

The default content type under RFC 822 is plain text US-ASCII (ANSI X3.4-1986). The currently permissible character set names include "us-ascii", "iso-8859-nnnnn", and "x-ttttt", where "nnnnn" is one to five decimal digits representing an ISO code page and "ttttt" is an extension token. Character set "iso-8859-1" is the same as "us-ascii". However, certain message transfer agents and user agents might require one of these two strings and not accept the other.

Note

When working with body parts that contain mixed character sets, you can specify the character set used in the message's header fields by setting the Message object's IBodyPart.Charset property. There is no corresponding top-level charset parameter in the transmitted stream; this value is used to encode these headers when they are set using the IMessage interface properties, or through fields within the urn:schemas:httpmail: namespace using the mechanism defined in RFC 1522.

You can use any Charset value that is installed/supported on your system. The following table defines some of the module constants that are available through the type library and header files for use with the Charset property.

cdoCharset Module Constants

The contents of Charset are case-insensitive. The default value is "us-ascii".