XmlConvert.VerifyWhitespace(String) Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Retorna a instância de cadeia de caracteres transmitida se todos os caracteres no argumento de cadeia de caracteres forem caracteres de espaço em branco 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

String a ser verificado.

Retornos

String

A instância de cadeia de caracteres transmitida se todos os caracteres no argumento de cadeia de caracteres forem caracteres de espaço em branco válidos; caso contrário, null.

Exemplos

O exemplo a seguir usa o VerifyWhitespace método para detectar a presença de um caractere inválido em um valor atribuído ao elemento inicial.

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

Comentários

Nenhum outro valor que não seja o argumento passado deve ser retornado. Os caracteres válidos para espaço em branco não variam entre edições XML, portanto, nenhuma sobrecarga de versão xml é necessária.

Consulte a produção de especificação XML 1.0 (quarta edição) [3] S para obter detalhes sobre os caracteres permitidos.

Se o parâmetro for nulo, um ArgumentNullException será gerado.

Se qualquer um dos caracteres não for caracteres de espaço em branco válidos, um XmlException será gerado com informações sobre o primeiro caractere inválido encontrado.