XmlConvert.VerifyXmlChars(String) Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Quelle:

XmlConvert.cs

Gibt die übergebene Zeichenfolge zurück, wenn alle Zeichen und Ersatzzeichenpaare im Zeichenfolgenargument gültige XML-Zeichen sind, andernfalls wird eine XmlException 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

Der String mit den zu überprüfenden Zeichen.

Gibt zurück

String

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

Beispiele

Im folgenden Beispiel wird die VerifyXmlChars -Methode verwendet, um ein unzulässiges 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. Details zu den zulässigen Zeichen finden Sie unter XML 1.0-Spezifikation (vierte Edition) produktion [2]. Char

Wenn der Parameter NULL ist, wird eine ArgumentNullException ausgelöst. Wenn eines der Zeichen keine gültigen XML-Zeichen sind, wird ein XmlException mit Informationen zum ersten ungültigen Zeichen ausgelöst.