XmlConvert.VerifyXmlChars(String) Método

Referencia

Definición

Espacio de nombres:: System.Xml

Ensamblado:: System.Xml.ReaderWriter.dll

Ensamblado:: System.Xml.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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.

Se aplica a