XmlConvert.VerifyXmlChars(String) Método

Definición

Espacio de nombres:
System.Xml
Ensamblados:
System.Xml.dll, System.Xml.ReaderWriter.dll
Ensamblados:
netstandard.dll, System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.dll
Ensamblado:
netstandard.dll
Source:
XmlConvert.cs
Source:
XmlConvert.cs
Source:
XmlConvert.cs
Source:
XmlConvert.cs
Source:
XmlConvert.cs

Devuelve la cadena pasada si todos los caracteres y los caracteres del par suplente del argumento string son caracteres XML válidos; de lo contrario, se produce una XmlException excepción 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 caracteres que se van a comprobar.

Devoluciones

String

Cadena pasada si todos los caracteres y caracteres suplentes del argumento string son caracteres XML válidos; de lo contrario, se produce una XmlException excepción 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 deben devolver otros valores que el argumento pasado. Consulte PRODUCCIÓN de la 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 son caracteres xml válidos, se produce una XmlException excepción con información sobre el primer carácter no válido encontrado.

Se aplica a