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
Параметры
Возвращаемое значение
Переданный экземпляр строки, если все символы в строковом аргументе являются допустимыми символами пробелов, в противном случае 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 возникает исключение со сведениями о первом недопустимом символе.