XmlConvert.VerifyXmlChars(String) Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Devuelve la cadena que se pasa si todos los caracteres y pares de caracteres suplentes de un argumento de la cadena son caracteres XML válidos, en caso contrario se produce una XmlException con información sobre el primer carácter no válido encontrado.

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

Parámetros

content

String

String que contiene los caracteres que se van a comprobar.

Devoluciones

String

Cadena que se pasa si todos los caracteres y pares de caracteres suplentes de un argumento de la cadena son caracteres XML válidos. En caso contrario, se produce una excepción XmlException con información sobre el primer carácter no válido encontrado.

Ejemplos

En el ejemplo siguiente se usa el VerifyXmlChars método utilizado para detectar un carácter no válido en el 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

Comentarios

No se debe devolver ningún otro valor que el argumento pasado. Consulte producción de especificación XML 1.0 (cuarta edición) [2] Char para obtener más información sobre los caracteres permitidos.

Si el parámetro es null, se producirá una ArgumentNullException excepción . Si alguno de los caracteres no es válido, se produce una XmlException excepción con información sobre el primer carácter no válido encontrado.