XmlConvert.VerifyXmlChars(String) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlConvert.cs

Mengembalikan string yang diteruskan jika semua karakter dan karakter pasangan pengganti dalam argumen string adalah karakter XML yang XmlException valid, jika tidak, dilemparkan dengan informasi pada karakter pertama yang tidak valid yang ditemui.

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 yang berisi karakter untuk diverifikasi.

Mengembalikan

String

String yang diteruskan jika semua karakter dan karakter pasangan pengganti dalam argumen string adalah karakter XML yang XmlException valid, jika tidak, string akan dilemparkan dengan informasi tentang karakter pertama yang tidak valid yang ditemui.

Contoh

Contoh berikut menggunakan metode yang VerifyXmlChars digunakan untuk mendeteksi karakter ilegal dalam elemen mulai.

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

Keterangan

Tidak ada nilai lain selain argumen yang diteruskan harus dikembalikan. Lihat produksi spesifikasi XML 1.0 (edisi keempat) [2] Char untuk detail tentang karakter yang diizinkan.

Jika parameter null, akan ArgumentNullException dilemparkan. Jika salah satu karakter bukan karakter xml yang valid, sebuah XmlException dilemparkan dengan informasi tentang karakter pertama yang tidak valid yang ditemui.