Mailbox.SetDisplayName Method

Sets the display name from a Unicode string, with a hint about the character encoding to use.

[Visual Basic]
Public Sub SetDisplayName( _
ByVal name As String, _
ByVal charset As String _
)

[C#]
public void SetDisplayName(
string name,
string charset
);

Parameters

name: the display name
charset: a hint about the character encoding to use for the display name

Remarks

This method attempts to use the specified character encoding (charset) when the display name is encoded. The character encoding uses the .NET Framework Class Library, so only encodings supported by .NET will succeed. If the character encoding fails, the method throws System.NotSupportedException.

As a special case, if all characters are in the US-ASCII character set, the charset will be changed to US-ASCII and no encoding will be performed.

Use this method to set the display name if:

You anticipate using characters not in ISO 8859-1 (that is, Unicode code points greater than 255)
And, UTF-8 is not your preferred character encoding (for example, if you write in Japanese and you need to use ISO-2022-JP)

Mailbox.SetDisplayName Method

Parameters

Remarks

See Also