Classe Sys.Net.XMLHttpExecutor

Faz solicitações de rede assíncrono por meio XMLHTTP suporte.

Namespace: Sys.Net

Herda: Nenhum

var executor = new Sys.Net.XMLHttpExecutor();

Membros

Nome	Descrição
Construtor Sys.Net.XMLHttpExecutor	Inicializa uma nova instância do Sys.Net.XMLHttpExecutor classe quando implementada em uma classe derivada.
Método de anulação de Sys.Net.XmlHttpExecutor	Pára a solicitação de rede pendentes emitida pelo executor.
Sys.Net.XmlHttpExecutor executeRequest método	Executa uma solicitação de rede conforme especificado no associado WebRequest instância.
Método Sys.Net.XmlHttpExecutor.getAllResponseHeaders	Retorna os cabeçalhos de resposta.
Método Sys.Net.WebRequestExecutor.getResponseHeader Método Sys.Net.XmlHttpExecutor.getResponseHeader	Obtém o valor de um cabeçalho de resposta especificado.
Sys.Net.XmlHttpExecutor anulada propriedade	Retorna um valor que indica se o executor foi anulado.
Sys.Net.XmlHttpExecutor responseAvailable propriedade	Retorna um valor que indica se a solicitação de rede retornados sem serem anulada ou tempo limite.
Sys.Net.XmlHttpExecutor responseData propriedade	Obtém a representação de texto do corpo da resposta.
Sys.Net.XmlHttpExecutor iniciado propriedade	Retorna um valor que indica se o executor encaminhou a solicitação para o objeto do navegador XMLHTTP.
Sys.Net.XmlHttpExecutor statusCode propriedade	Obtém o código de status da XMLHTTP objeto.
Sys.Net.XmlHttpExecutor statusText propriedade	Obtém o texto de status a partir XMLHTTP objeto.
Sys.Net.XmlHttpExecutor timedOut propriedade	Retorna um valor que indica se o executor esgotado.
Xml Sys.Net.XmlHttpExecutor propriedade	Retorna um XMLDOM objeto que contém a resposta XML a partir do navegador XMLHTTP objeto.

Comentários

The XmlHttpExecutor classe age sistema autônomo o executor padrão e é uma implementação das WebRequestExecutor classe abstrata.

Como o executor padrão já está definido, não é necessário criar uma instância da classe e associá-lo a solicitação da Web. No entanto, se você conjunto um executor personalizado, crie uma instância do executor e defini-la sistema autônomo o executor padrão a solicitação da Web.

Após a telefonar de rede, a XmlHttpExecutor objeto deve ser usado apenas para obter dados de resposta, após o qual deve ser descartada.

Observação:
Para mais informações sobre o XMLHTTP objeto, consulte Sobre a XMLHTTP nativo.

Exemplo

O exemplo a seguir mostra como usar o XmlHttpExecutor classe métodos e propriedades. O exemplo mostra uma página da Web e o script de cliente que interage com o XmlHttpExecutor classe.

var resultElementId;

function pageLoad()
{
    resultElementId = $get("ResultId");
}

// This function aborts a Web request.
function AbortWebRequest()
{
    // Create the WebRequest object.
    wRequest =  new Sys.Net.WebRequest();

    // Set the request Url.  
    wRequest.set_url("getTarget.htm");

   // Clear the results area.
    resultElementId.innerHTML = "";

    // Set the Completed event handler, 
    // for processing return data
    wRequest.add_completed(OnCompleted);

    // Make the request.
    wRequest.invoke();

    // Get the current executor.
    var executor = wRequest.get_executor();


    // Abort the request.
    executor.abort();

    // Check if the executor is aborted.
    var execAborted = 
        executor.get_aborted();

    alert("Executor aborted: " + execAborted);
}

// This function executes a Web request.
function ExecuteWebRequest()
{
    // Create the WebRequest object.
    wRequest =  new Sys.Net.WebRequest();

    // Set the request Url.  
    wRequest.set_url("getTarget.htm");


    // Set the Completed event handler, for processing return data
    wRequest.add_completed(OnCompleted);

      // Clear the results area.
    resultElementId.innerHTML = "";

    // To use executeRequest you must instantiate the
    // executor, assign it to the Web request instance,
    // then call the executeRequest function.
    // Note: Normally to make a Web request you use
    // the invoke method of the WebRequest instance.
    var executor = new Sys.Net.XMLHttpExecutor();
    wRequest.set_executor(executor); 
    executor.executeRequest();

    var started = executor.get_started();

    alert("Executor started: " + started);
}



// This is the event handler called after 
// the Web request returns.
function OnCompleted(executor, eventArgs) 
{
    if(executor.get_responseAvailable()) 
    {

        // Get the Web request instance.
        var webReq = executor.get_webRequest();
        // Display request Url.
        alert(webReq.get_url());

       // Clear the previous results. 
       resultElementId.innerHTML = "";

       // Display the Web request status. 
       resultElementId.innerHTML +=
          "Request Status: [" + executor.get_statusCode() + " " + 
                    executor.get_statusText() + "]" + "<br/>";

        // Display the Web request headers.
        resultElementId.innerHTML += "Headers: <br/>";


        // Get all the headers.    
        resultElementId.innerHTML += 
        "All Request Headers: " +
            executor.getAllResponseHeaders() + "<br/>"; 

        // Get a specific header.
        resultElementId.innerHTML += 
        "Content-Type Header: " +
            executor.getResponseHeader("Content-Type") + 
            "<br/>";       

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


    }
    else
    {
        if (executor.get_timedOut())
            alert("Timed Out");
        else
            if (executor.get_aborted())
                alert("Aborted");
    }

}

// This is the event handler called after 
// the Web request returns. It is designed
// for Web requests that return XML.
function OnSucceededXml(executor, eventArgs) 
{
    if (executor.get_responseAvailable()) 
    {
        // Display XML.
       if (document.all)
            resultElementId.innerText += executor.get_xml().xml;
        else
            // Firefox 
            resultElementId.textContent += "First node: " + 
                executor.get_xml().documentElement.nodeName;

    }
    else
    {
        if (executor.get_timedOut())
            alert("Timed Out");
        else
            if (executor.get_aborted())
                alert("Aborted");
    }
} 

// This function executes a Web request
// to get XML data.
function GetXml()
{
    // Create the WebRequest object.
    wRequest =  new Sys.Net.WebRequest();

    // Set the request Url.  
    wRequest.set_url("getTarget.xml");

     // Set the Completed event handler 
    // for processing return data.
    wRequest.add_completed(OnSucceededXml);

    // Clear the results area.
    resultElementId.innerText = "";

    // Invoke the Web request.
    wRequest.invoke();
}

// This function aborts a Web request.
function AbortWebRequest()
{
    // Create the WebRequest object.
    wRequest =  new Sys.Net.WebRequest();

    // Set the request Url.  
    wRequest.set_url("getTarget.htm");

   // Clear the results area.
    resultElementId.innerHTML = "";

    // Set the Completed event handler, 
    // for processing return data
    wRequest.add_completed(OnCompleted);

    // Make the request.
    wRequest.invoke();

    // Get the current executor.
    var executor = wRequest.get_executor();


    // Abort the request.
    executor.abort();

    // Check if the executor is aborted.
    var execAborted = 
        executor.get_aborted();

    alert("Executor aborted: " + execAborted);
}

Consulte também

Referência

Classe de sys.NET.WebRequestExecutor

Classe Sys.Net.WebRequestManager

Classe sys.NET.WebRequest