executor, propriété de Sys.Net.WebRequest

Mise à jour : novembre 2007

Obtient ou définit l'exécuteur de l'instance Sys.Net.WebRequest associée.

Remarque :
Pour obtenir ou définir des valeurs de propriété pour les propriétés API clientes, vous devez appeler des méthodes d'accesseur de propriété dont le nom contient les préfixes get_ et set_. Par exemple, pour obtenir ou définir la valeur d'une propriété telle que cancel, vous appelez la méthode get_cancel ou set_cancel.

var executor = MyWebRequest.get_executor();
myRequest.set_Executor(value);

Paramètres

Valeur de retour

Instance actuelle de WebRequestExecutor.

Exceptions

Notes

Lorsque l'exécution de l'instance WebRequest est terminée, la propriété executor retourne l'exécuteur de réseau actif associé à la requête. Vous pouvez accéder par programme à l'instance WebRequest à partir de l'exécuteur associé.

Définissez la propriété executor uniquement si vous avez besoin d'un exécuteur de réseau personnalisé. Si vous ne définissez pas cette propriété, le système utilise l'exécuteur Sys.Net.XmlHttpExecutor par défaut, qui est défini une fois la méthode invoke appelée.

Vous ne pouvez pas définir la propriété executor si l'instance WebRequest dispose déjà d'un exécuteur associé et si la requête Web a déjà été publiée. Si vous essayez de définir la propriété executor à l'aide d'un exécuteur qui est déjà associé à l'instance de requête, tel que myRequest.set_executor(myRequest.get_executor()), une exception est levée.

Exemple

L'exemple suivant montre comment définir l'exécuteur. Ce code fait partie d'un exemple complet fourni dans la vue d'ensemble de la classe WebRequest.

// This function sets the Web request
// executor, replacing the default one.
function WebRequestExecutor()
{     
    // Instantiate the WebRequest.
    var wRequest =  new Sys.Net.WebRequest();

    // Create the executor. In this case it is an
    // XMLHttpExecutor, equivalent to the default
    // executor. But, you can create a custom one.
    var executor = new Sys.Net.XMLHttpExecutor();

    // Set the executor, replacing the default one. 
    // In this case the executor is equivalent to the
    // default one.
    wRequest.set_executor(executor); 

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

    alert("Response availabe: " + executor.get_responseAvailable())
}

Voir aussi

Référence

Sys.Net.WebRequestManager, classe

Sys.Net.WebRequestExecutor, classe

Sys.Net.XMLHttpExecutor, classe