XmlConvert.VerifyWhitespace(String) Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Devuelve la instancia de cadena pasada si todos los caracteres del argumento de cadena son caracteres de espacio en blanco válidos.

public:
 static System::String ^ VerifyWhitespace(System::String ^ content);

public static string VerifyWhitespace (string content);

static member VerifyWhitespace : string -> string

Public Shared Function VerifyWhitespace (content As String) As String

Parámetros

content

String

Objeto String que se va a comprobar.

Devoluciones

String

Instancia de la cadena pasada si todos los caracteres del argumento de la cadena son caracteres de espacio en blanco válidos; de lo contrario, null.

Ejemplos

En el ejemplo siguiente se usa el VerifyWhitespace método para detectar la presencia de un carácter no válido en un valor asignado al elemento start.

XmlTextWriter writer5 = new XmlTextWriter("outFile.xml", null);
char illegalWhiteSpaceChar = '_';

try
{
    // Write the root element.
    writer5.WriteStartElement("root");

    writer5.WriteStartElement("legalElement");
    // Throw an exception due illegal white space character.
    writer5.WriteString("ValueText" +
        XmlConvert.VerifyWhitespace("\t" + illegalWhiteSpaceChar));

    // Write the end tag for the legal element.
    writer5.WriteEndElement();
    // Write the end tag for the root element.
    writer5.WriteEndElement();
    writer5.Close();
}
catch (Exception e)
{
    Console.WriteLine(e.Message);
    writer5.Close();
}

Dim writer5 As XmlTextWriter = New XmlTextWriter("outFile.xml", Nothing)
Dim illegalWhiteSpaceChar As Char = "_"

Try
    ' Write the root element.
    writer5.WriteStartElement("root")
    writer5.WriteStartElement("legalElement")
    ' Throw an exception due illegal white space character.
    writer5.WriteString("ValueText" + _
        XmlConvert.VerifyWhitespace("   " + illegalWhiteSpaceChar))

    writer5.WriteEndElement()

    ' Write the end tag for the root element.
    writer5.WriteEndElement()

    writer5.Close()

Catch e As XmlException
    Console.WriteLine(e.Message)
    writer5.Close()
End Try

Comentarios

No se debe devolver ningún otro valor que el argumento pasado. Los caracteres válidos para espacios en blanco no varían entre las ediciones XML, por lo que no se requiere ninguna sobrecarga de versión xml.

Consulte PRODUCCIÓN de la especificación XML 1.0 (cuarta edición) [3] S 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.