Freigeben über


XmlConvert.VerifyWhitespace(String) Methode

Definition

Gibt die übergebene Zeichenfolgeninstanz zurück, wenn alle Zeichen im Zeichenfolgenargument gültige Leerzeichen 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

String um zu überprüfen.

Gibt zurück

Die übergebene Zeichenfolgeninstanz, wenn alle Zeichen im Zeichenfolgenargument gültige Leerzeichen 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.

Ausführliche Informationen zu den zulässigen Zeichen finden Sie in der XML 1.0-Spezifikation (vierte Ausgabe) [3] S.

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

Wenn eines der Zeichen keine gültigen Leerzeichen enthält, wird ein XmlException Zeichen mit Informationen über das erste ungültige Zeichen ausgelöst.

Gilt für: