XmlConvert.VerifyWhitespace(String) Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Gibt die übergebene Zeichenfolgeninstanz zurück, wenn alle Zeichen im Zeichenfolgenargument gültige Leerraumzeichen sind.

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

Parameter

content

String

Der zu überprüfende String.

Gibt zurück

String

Die übergebene Zeichenfolgeninstanz, wenn alle Zeichen im Zeichenfolgenargument gültige Leerraumzeichen sind, andernfalls null.

Beispiele

Im folgenden Beispiel wird die VerifyWhitespace Methode verwendet, um das Vorhandensein eines ungültigen Zeichens in einem Wert zu erkennen, der dem Startelement zugewiesen ist.

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

Hinweise

Es sollten keine anderen Werte als das übergebene Argument zurückgegeben werden. Die für Leerzeichen gültigen Zeichen variieren nicht zwischen XML-Editionen, sodass keine XML-Versionsüberladung erforderlich ist.

Details zu den zulässigen Zeichen finden Sie in der XML 1.0-Spezifikation (vierte Edition) [3] S.

Wenn der Parameter null ist, wird ein ArgumentNullException Fehler ausgelöst.

Wenn eines der Zeichen ungültige Leerzeichen sind, wird ein XmlException Zeichen mit Informationen zum ersten ungültigen Zeichen ausgelöst.