XmlConvert.VerifyXmlChars(String) Methode

Definition

Namespace:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Quelle:

XmlConvert.cs

Gibt die übergebene Zeichenfolge zurück, wenn alle Zeichen und Ersatzpaarzeichen im Zeichenfolgenargument gültige XML-Zeichen sind, andernfalls wird ein XmlException Fehler mit Informationen zum ersten ungültigen Zeichen ausgelöst.

public:
 static System::String ^ VerifyXmlChars(System::String ^ content);

public static string VerifyXmlChars(string content);

static member VerifyXmlChars : string -> string

Public Shared Function VerifyXmlChars (content As String) As String

Parameter

content

String

String die zu überprüfende Zeichen enthält.

Gibt zurück

String

Die übergebene Zeichenfolge, wenn alle Zeichen und Ersatzpaarzeichen im Zeichenfolgenargument gültige XML-Zeichen sind, andernfalls wird ein XmlException Fehler mit Informationen zum ersten ungültigen Zeichen ausgelöst.

Beispiele

Im folgenden Beispiel wird die VerifyXmlChars Methode verwendet, um ein ungültiges Zeichen im Startelement zu erkennen.

XmlTextWriter writer3 = new XmlTextWriter("outFile.xml", null);
char illegalChar = '\uFFFE';
string charsToVerify = "Test String ";

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

    // Throw an exception due illegal character.
    writer3.WriteStartElement(
        XmlConvert.VerifyXmlChars(charsToVerify + illegalChar));

    writer3.WriteString("ValueText");
    writer3.WriteEndElement();

    // Write the end tag for the root element.
    writer3.WriteEndElement();

    writer3.Close();
}
catch (XmlException e)
{
    Console.WriteLine(e.Message);
    writer3.Close();
}

Dim writer3 As XmlTextWriter = New XmlTextWriter("outFile.xml", Nothing)
Dim illegalChar As Char = ChrW(CInt("&hFFFE"))
Dim charsToVerify As String = "Test String "

Try
    ' Write the root element.
    writer3.WriteStartElement("root")

    ' Throw an exception for name that contains illegal character.
    writer3.WriteStartElement( _
        XmlConvert.VerifyXmlChars(charsToVerify + illegalChar))

    writer3.WriteString("ValueText")
    writer3.WriteEndElement()

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

    writer3.Close()


Catch e As XmlException

    Console.WriteLine(e.Message)
    writer3.Close()
End Try

Hinweise

Es sollten keine anderen Werte als das übergebene Argument zurückgegeben werden. Ausführliche Informationen zu den zulässigen Zeichen finden Sie in der XML 1.0-Spezifikation (vierte Ausgabe) [2 Char ].

Wenn der Parameter null ist, wird ein ArgumentNullException Fehler ausgelöst. Wenn eines der Zeichen ungültige XML-Zeichen ist, wird ein XmlException Fehler mit Informationen zum ersten ungültigen Zeichen ausgelöst.