XmlConvert.VerifyWhitespace(String) Метод

Определение

Возвращает переданный экземпляр строки, если все символы в строковом аргументе являются допустимыми символами пробелов.

public:
 static System::String ^ VerifyWhitespace(System::String ^ content);
public static string VerifyWhitespace(string content);
static member VerifyWhitespace : string -> string
Public Shared Function VerifyWhitespace (content As String) As String

Параметры

content
String

String для проверки.

Возвращаемое значение

Переданный экземпляр строки, если все символы в строковом аргументе являются допустимыми символами пробелов, в противном случае null.

Примеры

В следующем примере метод используется VerifyWhitespace для обнаружения присутствия недопустимого символа в значении, назначенном начальном элементу.

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();
}
Dim writer5 As XmlTextWriter = New XmlTextWriter("outFile.xml", Nothing)
Dim illegalWhiteSpaceChar As Char = "_"

Try
    ' Write the root element.
    writer5.WriteStartElement("root")
    writer5.WriteStartElement("legalElement")
    ' Throw an exception due illegal white space character.
    writer5.WriteString("ValueText" + _
        XmlConvert.VerifyWhitespace("   " + illegalWhiteSpaceChar))

    writer5.WriteEndElement()

    ' Write the end tag for the root element.
    writer5.WriteEndElement()

    writer5.Close()

Catch e As XmlException
    Console.WriteLine(e.Message)
    writer5.Close()
End Try

Комментарии

Не следует возвращать никакие другие значения, кроме переданных в аргументе. Символы, допустимые для пробелов, не зависят от выпусков XML, поэтому перегрузка версии XML не требуется.

Сведения о допустимых символах см. в спецификации XML 1.0 (четвертый выпуск) [3] S.

Если параметр имеет значение NULL, ArgumentNullException создается исключение.

Если любой из символов не является допустимым символами пробелов, XmlException возникает исключение со сведениями о первом недопустимом символе.

Применяется к