XmlValidatingReader.ReadString Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> stringPublic Overrides Function ReadString () As StringRetornos
O conteúdo do elemento ou nó de texto. Essa pode ser uma cadeia de caracteres vazia se o leitor estiver posicionado em algo diferente de um elemento ou nó de texto ou se não houver mais conteúdo de texto a ser retornado no contexto atual.
Comentários
O nó de texto pode ser um elemento ou um nó de texto de atributo.
Observação
A XmlValidatingReader classe está obsoleta no .NET Framework 2.0. Você 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 de Comentários da página de referência XmlReader.
Se posicionado em um elemento, ReadString concatena todo o texto, espaço em branco significativo, espaço em branco e tipos de nó de seção CDATA juntos e retorna os dados concatenados como o conteúdo do elemento. O leitor para quando qualquer marcação é encontrada, incluindo comentários e instruções de processamento. Isso pode ocorrer em um modelo de conteúdo misto ou quando uma marca de extremidade de elemento é lida.
Se posicionado em um nó de texto, ReadString executa a mesma concatenação do nó de texto para a marca de extremidade do elemento. Se o leitor estiver posicionado em um nó de texto de atributo, ReadString terá a mesma funcionalidade que se o leitor estivesse posicionado na marca de início do elemento. Ele retorna todos os nós de texto do elemento concatenado.
A EntityHandling propriedade determina como ReadString funciona da seguinte maneira:
| Valor | Descrição |
|---|---|
| Expandentities | Retorna caractere expandido e entidades gerais. Este é o padrão. |
| Expandcharentities | Retorna o conteúdo do texto até, mas não incluindo uma referência de entidade geral. Isso significa que uma entidade geral faz com que ReadString pare. Você deve chamar Read para percorrer a referência de entidade. |
