XmlConvert.VerifyXmlChars(String) Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:

System.Xml.dll

Bütünleştirilmiş Kod:

netstandard.dll

Dize bağımsız değişkenindeki tüm karakterler ve vekil çift karakterler geçerli XML karakterleriyse, geçirilen dizeyi döndürür; aksi takdirde, karşılaşılan ilk geçersiz karakterle ilgili bilgilerle bir XmlException oluşturulur.

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

Parametreler

content

String

String bu, doğrulanması gereken karakterleri içerir.

Döndürülenler

String

Dize bağımsız değişkenindeki tüm karakterler ve vekil çift karakterler geçerli XML karakterleriyse, geçirilen dize, aksi takdirde XmlException ilk geçersiz karakterle ilgili bilgilerle bir oluşturulur.

Örnekler

Aşağıdaki örnek, start öğesinde VerifyXmlChars geçersiz bir karakteri algılamak için kullanılan yöntemini kullanır.

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

Açıklamalar

Geçirilen bağımsız değişkenden başka değer döndürülmemelidir. İzin verilen karakterlerle ilgili ayrıntılar için bkz. XML 1.0 belirtimi (dördüncü sürüm) üretimi [2] Char .

Parametre null ise, bir ArgumentNullException oluşturulur. Karakterlerden herhangi biri geçerli xml karakterleri değilse, karşılaşılan ilk geçersiz karakterle ilgili bilgilerle bir XmlException oluşturulur.