Partager via


defaultExecutor, propriété de Sys.Net.WebRequestManager

Mise à jour : novembre 2007

Obtient ou définit le type de l'exécuteur du réseau par défaut utilisé pour faire des requêtes réseau.

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, vous appelez la méthode get_cancel ou set_cancel pour obtenir ou définir une valeur pour une propriété telle que annuler.

var dExecutor = Sys.WebRequestManager.get_defaultExecutorType ();
Sys.Net.WebRequestManager.set_defaultExecutorType(value);

Paramètres

Paramètre

Description

value

Référence à une implémentation de la classe WebRequestExecutor.

Exceptions

Type d'exception

Condition

Sys.ArgumentException

Un paramètre non valide a été passé.

Valeur de retour

Objet qui représente l'exécuteur de requête Web par défaut.

Notes

Utilisez la propriété defaultExecutor pour obtenir ou définir l'exécuteur par défaut qui est une référence à l'objet WebRequestExecutor actuel.

Lorsque l'objet WebRequestExecutor est prêt à envoyer une requête Web à l'exécuteur, il utilise l'exécuteur de requête que vous avez fourni. Si vous ne fournissez pas d'exécuteur, WebRequestExecutor crée une instance de la classe XmlHttpExecutor.

Exemple

L'exemple suivant indique comment obtenir et définir l'exécuteur par défaut à l'aide de la propriété defaultExecutorType. Ce code fait partie d'un exemple complet disponible dans la vue d'ensemble de la classe WebRequestManager.

// Gets and sets the default executor.
function DefaultExecutor()
{
    // Clear the previous results. 
    resultElement.innerHTML = "";

    // Get system default executor type.
    var sysDefaultExecutor = 
        Sys.Net.WebRequestManager.get_defaultExecutorType();
    alert("Get default executor:" + sysDefaultExecutor);


    // Modify the default executor type.
    Sys.Net.WebRequestManager.set_defaultExecutorType(
    "Sys.Net.CustomExecutor");

    var customDefaultExecutor = 
        Sys.Net.WebRequestManager.get_defaultExecutorType();

    alert("Set default executor: " + customDefaultExecutor);

    // Set the executor back to the system default. This is 
    // to allow the WebRequest script to run.
    executor = "Sys.Net.XMLHttpExecutor";
    Sys.Net.WebRequestManager.set_defaultExecutorType(
    sysDefaultExecutor);    

}

Voir aussi

Référence

Sys.Net.WebRequestManager, classe

Sys.Net.WebRequestExecutor, classe

Sys.Net.XMLHttpExecutor, classe