Sys.Net.WebRequest executor (Propiedad)

Actualización: noviembre 2007

Obtiene o establece el elemento de ejecución de la instancia de Sys.Net.WebRequest asociada.

Nota

Para obtener o establecer los valores de las propiedades de la API de cliente, debe llamar a los métodos de descriptor de acceso de propiedades cuyos nombres tienen los prefijos get_ y set_. Por ejemplo, para obtener o establecer un valor para una propiedad como cancel, llame a los métodos get_cancel o set_cancel.

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

Parámetros

Parameter	Description
value	Instancia de una clase que se deriva de Sys.Net.WebRequestExecutor.

Valor devuelto

Instancia de WebRequestExecutor actual.

Excepciones

Tipo de excepción	Condition
Sys.ArgumentNullException	value no puede ser null.
Sys.InvalidOperationException	Se estableció el elemento de ejecución una vez habilitado.
Sys.ArgumentException	value no es un tipo de WebRequestExecutor válido.

Comentarios

Cuando la instancia WebRequest termina de ejecutarse, la propiedad executor devuelve el elemento de ejecución de red activo asociado a la solicitud. Puede obtener acceso mediante programación a la instancia de WebRequest desde el elemento de ejecución asociado.

Sólo debe establecer la propiedad executor si necesita un elemento de ejecución de red personalizado. Si no establece esta propiedad, el sistema utiliza el elemento de ejecución Sys.Net.XmlHttpExecutor predeterminado, que se establece después de llamar al método invoke.

No puede establecer la propiedad executor si la instancia de WebRequest ya tiene un elemento de ejecución asociado y ya se ha enviado la solicitud web. Si intenta establecer la propiedad executor utilizando un elemento de ejecución que ya está asociado a la instancia de la solicitud, como myRequest.set_executor(myRequest.get_executor()), se produce una excepción.

Ejemplo

En el ejemplo siguiente se muestra cómo establecer el elemento de ejecución. Este código forma parte de un ejemplo completo que se encuentra en la información general de la clase 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())
}

Vea también

Referencia

Sys.Net.WebRequestManager (Clase)

Sys.Net.WebRequestExecutor (Clase)

Sys.Net.XMLHttpExecutor (Clase)