XmlValidatingReader.ReadString Método

Definição

Espaço de Nomes:

System.Xml

Assemblagem:

System.Xml.dll

Lê o conteúdo de um elemento ou nó de texto como uma cadeia de caracteres.

public:
 override System::String ^ ReadString();

public override string ReadString();

override this.ReadString : unit -> string

Public Overrides Function ReadString () As String

Devoluções

String

O conteúdo do elemento ou do nó de texto. Esta pode ser uma cadeia vazia se o leitor estiver posicionado em algo que não seja um elemento ou nó de texto, ou se não houver mais conteúdo de texto para devolver no contexto atual.

Observações

O nó de texto pode ser tanto um elemento como um nó de texto de atributo.

Note

A classe XmlValidatingReader está obsoleta no .NET Framework 2.0. Pode criar uma instância de validação XmlReader usando a XmlReaderSettings classe e o Create método. Para obter mais informações, consulte a seção Comentários da XmlReader página de referência.

Se posicionado num elemento, ReadString concatena todo o texto, espaço em branco significativo, espaço em branco e tipos de nós de secção CDATA e retorna os dados concatenados como conteúdo do elemento. O leitor para quando é encontrado qualquer marcação, incluindo comentários e instruções de processamento. Isto pode ocorrer num modelo de conteúdo misto, ou quando uma etiqueta final de elemento é lida.

Se posicionado num nó de texto, ReadString realiza a mesma concatenação do nó de texto para a etiqueta final do elemento. Se o leitor estiver posicionado num nó de texto de atribuido, ReadString tem a mesma funcionalidade que se o leitor estivesse posicionado na etiqueta de início do elemento. Devolve todos os nós de texto dos elementos concatenados.

A EntityHandling propriedade determina como ReadString funciona da seguinte forma:

valor	Description
ExpandEntities	Devolve carácter expandido e entidades gerais. Este é o padrão.
ExpandCharEntities	Retorna o conteúdo textual até, mas não incluindo, uma referência geral de entidade. Isto significa que uma entidade geral faz com que a ReadString pare. Deve ligar Read para passar por cima da referência da entidade.

Ver também

• XmlReader