XmlConvert.VerifyXmlChars(String) Metoda

Reference

Definice

Obor názvů:: System.Xml

Sestavení:: System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vrátí předaný řetězec, pokud všechny znaky a náhradní párové znaky v řetězcovém argumentu jsou platné znaky XML, jinak XmlException je vyvolán informace o prvním neplatném znaku.

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

Parametry

content: String

String obsahující znaky k ověření.

Návraty

String

Předaný řetězec, pokud všechny znaky a náhradní párové znaky v řetězcovém argumentu jsou platné znaky XML, jinak XmlException je vyvolán informacemi o prvním neplatném znaku.

Příklady

Následující příklad používá metodu VerifyXmlChars použitou k detekci neplatného znaku v elementu start.

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

Poznámky

Neměly by být vráceny žádné jiné hodnoty než předaný argument. Podrobnosti o povolených znacích najdete v produkční verzi XML 1.0 (čtvrtá edice) Char [2].

Pokud má parametr hodnotu null, vyvolá se chyba ArgumentNullException . Pokud některý z těchto znaků není platný, vyvolá se chyba XmlException s informacemi o prvním neplatném znaku.

Platí pro

Sdílet prostřednictvím