Compartilhar via


Sys.Net.XmlHttpExecutor responseData propriedade

Obtém a representação de texto do corpo da resposta.

ObservaçãoObservação:

Para obter ou conjunto valores de propriedade para propriedades de API do cliente, você deve telefonar métodos de assessor de propriedade são nomeados com o get_ and set_ prefixos. Por exemplo, para obter ou conjunto um valor para uma propriedade, sistema autônomo Cancelar, you telefonar the get_cancel ou set_cancel métodos.

var responseData = MyExecutor.get_responseData();

Exceções

Tipo de exceção

Condição

Sys.InvalidOperationException

The responseData propriedade foi acessada fora o evento manipulador.

- ou -

The responseData propriedade foram acessada depois que o evento concluído ocorrer.

Valor de retorno

A representação de texto do corpo da resposta, se houver um; caso contrário, uma seqüência de caracteres vazia ("").

Comentários

Se a solicitação da Web concluída com êxito, você pode obter o valor do responseData propriedade para obter a representação de texto do corpo da resposta. Se não houver nenhum corpo de resposta, essa propriedade retornará uma seqüência de caracteres vazia ("").

O executor não tentará nenhuma conversões de caractere nos dados de resposta. Em vez disso, ele depende XMLHTTP implementação para o comportamento de conversão de Unicode. Para o Microsoft Internet Explorer, a resposta é retornada sistema autônomo texto UTF-8, a menos que o servidor incluiu um marcador de ordem de byte (BOM) no início da resposta para indicar uma variação diferente do Unicode.

Você pode usar o responseData propriedade somente no código que está sendo executado um concluído evento manipulador ou em execução na pilha de chamadas do concluído evento manipulador. Uma exceção é lançada se você usar o responseData propriedade quando o executor não retornou dados de resposta válido, ou se a resposta ainda não está disponível (se a responseAvailable propriedade de retornafalse). Uma exceção é lançada também se você usar o responseData propriedade depois que o evento concluído ocorrer. Isso ocorre porque o executor lançou sua referência para XMLHTTP objeto.

Exemplo

O exemplo a seguir mostra como usar o responseData propriedade. Este código faz parte de um exemplo completo encontrado no Sys.Net.XmlHttpExecutor visão geral da classe.

// Display Web request body.
resultElementId.innerHTML += "Body: <br/>";
resultElementId.innerText += 
    executor.get_responseData();

Consulte também

Referência

Classe Sys.Net.WebRequestManager

Classe de sys.NET.WebRequestExecutor

Classe Sys.Net.XMLHttpExecutor