XmlConvert.VerifyXmlChars(String) Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Retorna a cadeia de caracteres passada se todos os caracteres e os caracteres do par substituto no argumento de cadeia de caracteres forem caracteres XML válidos, caso contrário, um XmlException será gerado com informações sobre o primeiro caractere invá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 contém caracteres a serem verificados.

Retornos

String

A cadeia de caracteres transmitida se todos os caracteres e os caracteres do par alternativo no argumento de cadeia de caracteres forem caracteres XML válidos; caso contrário, um XmlException será gerado com informações sobre o primeiro caractere inválido encontrado.

Exemplos

O exemplo a seguir usa o VerifyXmlChars método usado para detectar um caractere ilegal no elemento inicial.

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

Comentários

Nenhum outro valor que não seja o argumento passado deve ser retornado. Consulte a produção de especificação XML 1.0 (quarta edição) [2] Char para obter detalhes sobre os caracteres permitidos.

Se o parâmetro for nulo, um ArgumentNullException será gerado. Se qualquer um dos caracteres não forem caracteres xml válidos, um XmlException será gerado com informações sobre o primeiro caractere inválido encontrado.