XmlConvert.VerifyWhitespace(String) Method

Definition

Namespace:

System.Xml

Assemblies:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlConvert.cs

Returns the passed-in string instance if all the characters in the string argument are valid whitespace characters.

C#

public static string VerifyWhitespace(string content);

Parameters

content

String

String to verify.

Returns

String

The passed-in string instance if all the characters in the string argument are valid whitespace characters, otherwise null.

Examples

The following example uses the VerifyWhitespace method to detect the presence of an invalid character in a value assigned to the start element.

C#

XmlTextWriter writer5 = new XmlTextWriter("outFile.xml", null);
char illegalWhiteSpaceChar = '_';

try
{
    // Write the root element.
    writer5.WriteStartElement("root");

    writer5.WriteStartElement("legalElement");
    // Throw an exception due illegal white space character.
    writer5.WriteString("ValueText" +
        XmlConvert.VerifyWhitespace("\t" + illegalWhiteSpaceChar));

    // Write the end tag for the legal element.
    writer5.WriteEndElement();
    // Write the end tag for the root element.
    writer5.WriteEndElement();
    writer5.Close();
}
catch (Exception e)
{
    Console.WriteLine(e.Message);
    writer5.Close();
}

Remarks

No other values than the passed in argument should be returned. The characters that are valid for whitespace do not vary between XML editions, so no xml version overload is required.

See XML 1.0 spec (fourth edition) production [3] S for details on the allowed characters.

If the parameter is null, an ArgumentNullException will be thrown.

If any of the characters are not valid whitespace characters, an XmlException is thrown with information about the first invalid character encountered.

Applies to