NewEncoderReplacementFallback

Initializes a new instance of the EncoderReplacementFallback class using a specified replacement string.

 Public Function NewEncoderReplacementFallback(
	  ByRef Replacement As String ) As EncoderReplacementFallback

Parameters

Replacement

[ByRef] String. A string that is converted in an encoding operation in place of an input character that cannot be encoded.

Return Values

Remarks

The replacement parameter initializes the replacement string that is the value of this EncoderReplacementFallback object. Your application must provide a replacement value that contains only characters that can be encoded in the target encoding. Otherwise, a recursive fallback results, causing an ArgumentExceptionArgumentException. For example, the fallback provided for an ASCIIEncoding object cannot include the character "¿" (U+00BF) because that character is itself not a valid ASCII character.

As a result of this, U+FFFD, which is a good choice for a fallback string for DecoderExceptionFallback, is not generally a good choice for this class. Also, the null character (U+0000) cannot be used in the fallback string.

Exceptions

Exception	Condition
ArgumentException	Replacement contains an invalid surrogate pair. In other words, the surrogate does not consist of one high surrogate component followed by one low surrogate component.

See Also

Project CorLib Overview

Class Constructors Overview