XmlConvert.VerifyXmlChars(String) Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

netstandard.dll, System.Xml.ReaderWriter.dll

Origine:

XmlConvert.cs

Restituisce la stringa passata se tutti i caratteri e i caratteri della coppia di surrogati nell'argomento stringa sono caratteri XML validi, in caso contrario viene generata un'eccezione XmlException con informazioni sul primo carattere non valido rilevato.

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

Parametri

content

String

String contenente caratteri da verificare.

Valori restituiti

String

Stringa passata se tutti i caratteri e i caratteri della coppia di surrogati nell'argomento stringa sono caratteri XML validi, in caso contrario viene generata un'eccezione XmlException con informazioni sul primo carattere non valido rilevato.

Esempio

Nell'esempio seguente viene utilizzato il VerifyXmlChars metodo utilizzato per rilevare un carattere non valido nell'elemento 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

Commenti

Non devono essere restituiti altri valori dell'argomento passato. Per informazioni dettagliate sui caratteri consentiti, vedere La specifica XML 1.0 (quarta edizione) produzione [2]. Char

Se il parametro è Null, verrà generata un'eccezione ArgumentNullException . Se uno dei caratteri non sono caratteri xml validi, viene generata un'eccezione XmlException con informazioni sul primo carattere non valido rilevato.