Referencia de ActionScript® 3.0 para la plataforma de Adobe® Flash®
Inicio  |  Ocultar lista de paquetes y clases |  Paquetes  |  Clases  |  Novedades  |  Índice  |  Apéndices  |  ¿Por qué hay texto en inglés?
Filtros: AIR 30.0 y versiones anteriores, Flash Player 30.0 y versiones anteriores, Flash Lite 4
Flex 4.6 y versiones anteriores, Flash Pro CS6 y versiones anteriores
Ocultar filtros
flash.net 

URLRequest  - AS3

Paquetesx

Nivel superior
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Elementos del lenguaje

Constantes globales
Funciones globales
Operadores
Sentencias, palabras clave y directivas
Tipos especiales

Apéndices

Novedades
Errores del compilador
Advertencias del compilador
Errores en tiempo de ejecución
Migración a ActionScript 3
Conjuntos de caracteres admitidos
Solo etiquetas MXML
Elementos Motion XML
Etiquetas de texto temporizado
Lista de elementos desfasados
Constantes de implementación de accesibilidad
Cómo utilizar ejemplos de ActionScript
Avisos legales
Paqueteflash.net
Clasepublic final class URLRequest
HerenciaURLRequest Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

La clase URLRequest captura toda la información en una sola petición HTTP. Los objetos URLRequest se transmiten a los métodos load() de las clases Loader, URLStream y URLLoader y a otras operaciones de carga para iniciar descargas de URL. También se transmiten a los métodos upload() y download() de la clase FileReference.

Es posible que un archivo SWF del entorno limitado local-con-sistema-de-archivos no cargue ni proporcione datos a un recurso que se encuentre en el entorno limitado de red.

De forma predeterminada, el archivo SWF que realiza la llamada y la URL que se carga deben estar en el mismo dominio. Por ejemplo, un archivo SWF de www.adobe.com sólo puede cargar datos de orígenes que también estén en www.adobe.com. Para cargar datos desde un dominio distinto, coloque un archivo de política URL en el servidor que aloja los datos.

Sin embargo, en Adobe AIR, el contenido del entorno limitado de seguridad de la aplicación (contenido instalado con la aplicación de AIR) no está limitado por estas restricciones de seguridad. Para el contenido que se ejecuta en Adobe AIR, los archivos del entorno limitado de seguridad de la aplicación pueden acceder a las URL mediante cualquiera de los siguientes esquemas de URL:

  • http y https
  • file
  • app-storage
  • app

El contenido que se ejecuta en Adobe AIR que no se encuentra en el entorno limitado de seguridad de la aplicación está sometido a las mismas restricciones que el contenido que se ejecuta en el navegador(en Flash Player), y la carga está dirigida por el dominio del contenido y cualquier permiso otorgado en los archivos de política URL.

Nota: en iOS9 Apple se introdujo App Transport Security, que no permite conexiones inseguras entre los servicios de aplicaciones y los servicios web. Debido a esta modificación causada por App Transport Security todas las conexiones realizadas con sitios web inseguros por medio de Loader, URLLoader dejarán de funcionar. Especifique las excepciones del comportamiento predeterminado añadiendo claves al descriptor de la aplicación de la suya.

Para especificar las excepciones del comportamiento predeterminado, agregue claves a la etiqueta InfoAdditions del descriptor de la aplicación.

  <iPhone>
  <InfoAdditions>
                   <![CDATA[
                          <key>NSAppTransportSecurity</key>
                              <dict>
                                        <key>NSExceptionDomains</key>
                              <dict>
                                       <key>www.example.com</key>
                              <dict>
                                     <!--Include to allow subdomains-->
                                     <key>NSIncludesSubdomains</key>
                                     <true/>
                                     <!--Include to allow HTTP requests-->
                                     <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
                                     <true/>
                                      <!--Include to specify minimum TLS version-->
                                      <key>NSTemporaryExceptionMinimumTLSVersion</key>
                                      <string>TLSv1.1</string>
                              </dict>
                              </dict>
                              </dict>
                  ]]>
         </InfoAdditions>
  </iPhone>
  

Para obtener más información, consulte el tema del Centro de desarrollo de Flash Player Seguridad.

Ver los ejemplos

Elementos de API relacionados



Propiedades públicas
 PropiedadDefinido por
      authenticate : Boolean
Especifica si deben manejarse peticiones de autenticación (true) o no (false) en esta petición.
URLRequest
      cacheResponse : Boolean
Especifica si los datos correctos de respuesta de esta petición se deben guardar en la memoria caché.
URLRequest
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  contentType : String
El tipo de contenido MIME del contenido de la propiedad data.
URLRequest
  data : Object
Un objeto que contiene datos que se van a transmitir con la petición de URL.
URLRequest
  digest : String
Una cadena que identifica de forma unívoca el componente firmado de la plataforma de Adobe que se va a almacenar (o recuperar) en la caché de Flash Player.
URLRequest
  followRedirects : Boolean
Especifica si se seguirán las redirecciones (true) o no (false).
URLRequest
      idleTimeout : Number
Especifica el valor de tiempo espera de inactividad (en milisegundos) en esta petición.
URLRequest
      manageCookies : Boolean
Especifica si la pila del protocolo HTTP debe administrar las cookies de esta petición.
URLRequest
  method : String
Controla el formulario HTTP para el método de envío.
URLRequest
  requestHeaders : Array
El conjunto de encabezados de petición HTTP que se añadirán a la petición HTTP.
URLRequest
  url : String
La URL que se va a solicitar.
URLRequest
      useCache : Boolean
Especifica si se debe consultar la memoria caché local antes de que URLRequest tome los datos.
URLRequest
  userAgent : String
Especifica la cadena de agente de usuario que se utiliza en la petición HTTP.
URLRequest
Métodos públicos
 MétodoDefinido por
  
URLRequest(url:String = null)
Crea un objeto URLRequest.
URLRequest
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
  
useRedirectedURL(sourceRequest:URLRequest, wholeURL:Boolean = false, pattern:* = null, replace:String = null):void
Permite la sustitución de una URL redirigida desde un objeto URLRequest de origen por alguna parte de la URL en un objeto URLRequest nuevo.
URLRequest
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Información sobre propiedades
    

authenticate

propiedad
authenticate:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

Especifica si deben manejarse peticiones de autenticación (true) o no (false) en esta petición. Si es false, el intento de autenticación devuelve un error HTTP.

Los métodos de autenticación admitidos son:

  • Windows: HTTP Basic/Digest, Autenticación integrada de Windows (incluido NTLM y Kerberos), Autenticación de certificado SSL.
  • Mac: HTTP Basic/Digest, NTLM, Autenticación de certificado SSL.

Nota: los métodos FileReference.upload(), FileReference.download() y HTMLLoader.load() no admiten la propiedad URLRequest.authenticate.

El valor predeterminado es true.



Implementación
    public function get authenticate():Boolean
    public function set authenticate(value:Boolean):void

Emite
SecurityError — La llamada no procede del entorno limitado de seguridad de la aplicación de AIR.

Elementos de API relacionados

    

cacheResponse

propiedad 
cacheResponse:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

Especifica si los datos correctos de respuesta de esta petición se deben guardar en la memoria caché. Si se establece en true, la aplicación de AIR utiliza la caché HTTP del sistema operativo.

Nota: el método HTMLLoader.load() no admite la propiedad URLRequest.cacheResponse.

El valor predeterminado es true.



Implementación
    public function get cacheResponse():Boolean
    public function set cacheResponse(value:Boolean):void

Emite
SecurityError — La llamada no procede del entorno limitado de seguridad de la aplicación de AIR.

Elementos de API relacionados

contentType

propiedad 
contentType:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

El tipo de contenido MIME del contenido de la propiedad data.

El valor predeterminado es application/x-www-form-urlencoded.

Nota: los métodos FileReference.upload(), FileReference.download() y HTMLLoader.load() no admiten la propiedad URLRequest.contentType.

Cuando se envía una petición POST, los valores de las propiedades contentType y data deben corresponderse correctamente. El valor de la propiedad contentType informa a los servidores cómo interpretar el valor de la propiedad data.

  • Si el valor de la propiedad data es un objeto URLVariables, el valor de contentType debe ser application/x-www-form-urlencoded.
  • Si el valor de la propiedad data es de cualquier otro tipo, el valor de contentType debe indicar el tipo de datos POST que se envían (datos binarios o de cadena en el valor de la propiedad data).
  • En FileReference.upload(), el tipo de contenido de la petición se define automáticamente como multipart/form-data, y el valor de la propiedad contentType se omite.

En Flash Player 10 y versiones posteriores, si utiliza una estructura Content-Type de varias partes (por ejemplo, "multipart/form-data") con una acción de carga (indicada por un parámetro "filename" en un encabezado "content-disposition" dentro del cuerpo POST), la operación POST está sujeta a las reglas de seguridad aplicadas a las cargas:

  • Es preciso realizar una operación POST como respuesta a una acción iniciada por el usuario, por ejemplo, un clic de ratón o la pulsación de una tecla.
  • Si la operación POST afecta a varios dominios (el destino POST no se encuentra en el mismo servidor que el archivo SWF que envía la petición POST), el servidor de destino debe proporcionar un archivo de política URL que permita el acceso a varios dominios.

Asimismo, en cualquier estructura Content-Type de varias partes, la sintaxis debe ser válida (de acuerdo con la norma RFC2046). Si la sintaxis no es válida, la operación POST está sujeta a las reglas de seguridad que se aplican a las cargas.



Implementación
    public function get contentType():String
    public function set contentType(value:String):void

Elementos de API relacionados

data

propiedad 
data:Object

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Un objeto que contiene datos que se van a transmitir con la petición de URL.

Esta propiedad se utiliza junto con la propiedad method. Si el valor de method es GET, el valor de data se añade al valor de URLRequest.url, utilizando la sintaxis de cadena de consulta HTTP. Si el valor de method es POST (o cualquier valor distinto a GET), el valor de data se transmite en el cuerpo de la petición HTTP.

La API URLRequest ofrece compatibilidad POST binaria y admite variables con codificación URL, así como compatibilidad con cadenas. El objeto de datos puede ser un objeto ByteArray, URLVariables o String.

El modo en que se utilicen los datos dependerá del tipo de objeto empleado:

  • Si el objeto es ByteArray, los datos binarios del objeto ByteArray se utilizan como datos POST. En el caso de GET, no se admiten los datos de tipo ByteArray. Asimismo, los datos de tipo ByteArray no con compatibles con FileReference.upload() y FileReference.download().
  • Si el objeto es URLVariables y el método es POST, las variables se codifican con formato x-www-form-urlencoded y la cadena resultante se utiliza como datos POST. Una excepción es la llamada a FileReference.upload(), en la que las variables se envían como campos separados en un envío multipart/form-data.
  • Si el objeto es URLVariables y el método GET, el objeto URLVariables define las variables que se enviarán con el objeto URLRequest.
  • En caso contrario, el objeto se convierte en una cadena y ésta se utiliza como datos POST o GET.

Los datos no se envían hasta que un método (por ejemplo, navigateToURL() o FileReference.upload()) utilice el objeto URLRequest.

Nota: el valor de contentType debe corresponder al tipo de datos en la propiedad data. Consulte la nota en la descripción de la propiedad contentType.



Implementación
    public function get data():Object
    public function set data(value:Object):void

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se abre la aplicación remota alojada en http://www.[yourDomain].com/application.jsp en una nueva ventana del navegador y transfiere los datos sobre una sesión de usuario, capturados en un objeto URLVariables, en el servidor web.

A continuación se detallan los fragmentos más importantes del ejemplo:

  1. La función constructora crea una instancia de URLRequest llamada request y toma la URL de la aplicación remota como parámetro.
  2. Se crea un objeto URLVariables y dos de sus propiedades son valores asignados.
  3. Se asigna el objeto URLVariables a la propiedad data del objeto URLRequest.
  4. El ejemplo llama a navigateToURL, que abre una nueva ventana del navegador con la URL de la aplicación remota.

Nota: para ejecutar el ejemplo, la URL de la aplicación remota del ejemplo debe sustituirse por una URL que funcione. Además, necesitará código de servidor para procesar la información capturada por Flash Player en el objeto URLVariables.

package {
    import flash.display.Sprite;
    import flash.net.navigateToURL;
    import flash.net.URLRequest;
    import flash.net.URLVariables;

    public class URLVariablesExample extends Sprite {

        public function URLVariablesExample() {
            var url:String = "http://www.[yourDomain].com/application.jsp";
            var request:URLRequest = new URLRequest(url);
            var variables:URLVariables = new URLVariables();
            variables.exampleSessionId = new Date().getTime();
            variables.exampleUserLabel = "guest";
            request.data = variables;
            navigateToURL(request);
        }
    }
}

digest

propiedad 
digest:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4

Una cadena que identifica de forma unívoca el componente firmado de la plataforma de Adobe que se va a almacenar (o recuperar) en la caché de Flash Player. Un componente de plataforma de Adobe es un archivo firmado (un archivo SWZ) con contenido SWF almacenado de forma persistente en la caché en el equipo de un usuario. Todos los archivos SWZ están firmados por Adobe. Una propiedad digest corresponde a un solo archivo guardado en caché; si se realiza cualquier cambio en el archivo, su propiedad digest cambiará de forma imprevisible. Mediante la propiedad digest es posible verificar el archivo guardado en caché en varios dominios. Dos archivos con la misma propiedad digest son el mismo archivo y dos archivos con distintas propiedades digest no son el mismo archivo. En la práctica , no se puede crear un archivo para “imitar” a las propiedades digest para hacerse pasar por otras.

La propiedad digest está basada en un algoritmo de resumen de mensajes SHA-256 (longitud de 64 caracteres en formato hexadecimal).

Por ejemplo, el SDK de Flex incluye un archivo SWZ para la arquitectura de Flex (y proporciona la cadena digest para dicho archivo SWZ). Puede publicar este archivo SWZ en el servidor web y cargarlo en el archivo SWF (con el método load() de un objeto URLLoader). Si el equipo del usuario final ya contiene el archivo SWZ coincidente en la caché, la aplicación utilizará dicho archivo SWZ. (Un archivo SWZ es coincidente si su propiedad digest coincide con la suministrada por el usuario.) En caso contrario, la aplicación descarga el archivo SWZ desde la dirección URL que se especifique.

Sólo se establece el parámetro digest en un objeto URLRequest utilizado en una llamada al método URLLoader.load() para cargar un archivo SWZ. Si la propiedad digest de un objeto URLRequest se establece cuando se utiliza en otros métodos, la aplicación emite una excepción IOError.



Implementación
    public function get digest():String
    public function set digest(value:String):void

Emite
ArgumentError — La propiedad digest proporcionada no coincide con la del archivo extraído del archivo firmado descargado o del archivo firmado cargado fuera de la caché. La aplicación también emite este error si la propiedad digest proporcionada no tiene la longitud correcta o si contiene caracteres no válidos (no hexadecimales).

Ejemplo  ( Cómo utilizar este ejemplo )
El ejemplo siguiente carga un archivo remoto en la caché. Una vez finalizada la carga, el conjunto de bytes contiene el archivo real (no el firmado). El ejemplo completa la operación de carga mediante una llamada a loadBytes():
 
var myURLReq:URLRequest = new URLRequest();
myURLReq.url = "http://yourdomain/users/jdoe/test01/_rsc/Automated/AssetCaching_rsc/test01/rsl.swz";
myURLReq.digest = "3B0AA28C7A990385E044D80F5637FB036317BB41E044D80F5637FB036317BB41";
var myURLLoader:URLLoader = new URLLoader();
myURLLoader.dataFormat = URLLoaderDataFormat.BINARY;
myURLLoader.addEventListener("complete", onC);

myURLLoad.load(myURLReq);

function onC(e) {
    var someLoader:Loader = new Loader();
    addChild(someLoader);
    someLoader.loadBytes((ByteArray)(myURLLoad.data)); 
}

followRedirects

propiedad 
followRedirects:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Lite 4

Especifica si se seguirán las redirecciones (true) o no (false).

Nota: los métodos FileReference.upload(), FileReference.download() y HTMLLoader.load() no admiten la propiedad URLRequest.followRedirects.

El valor predeterminado es true.



Implementación
    public function get followRedirects():Boolean
    public function set followRedirects(value:Boolean):void

Emite
SecurityError — La llamada no procede del entorno limitado de seguridad de la aplicación de AIR.

Elementos de API relacionados

    

idleTimeout

propiedad 
idleTimeout:Number

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 2

Especifica el valor de tiempo espera de inactividad (en milisegundos) en esta petición.

El tiempo espera de inactividad es el tiempo que cliente espera una respuesta del servidor, una vez establecida la conexión, antes de abandonar la petición.

Nota: el método HTMLLoader.load() no admite la propiedad URLRequest.idleTimeout. La clase HTMLLoader define su propia propiedad idleTimeout.

El valor predeterminado es initialized from the URLRequestDefaults.idleTimeout property.



Implementación
    public function get idleTimeout():Number
    public function set idleTimeout(value:Number):void

Emite
SecurityError — La llamada no procede del entorno limitado de seguridad de la aplicación de AIR.

Elementos de API relacionados

    

manageCookies

propiedad 
manageCookies:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

Especifica si la pila del protocolo HTTP debe administrar las cookies de esta petición. Si es true, las cookies se agregan a la petición y se recuerdan las cookies de la respuesta. Si es false, las cookies no se agregan a la petición y no se recuerdan, pero se pueden autoadministrar manipulando directamente los encabezados. Nota: en Windows, no es posible añadir cookies para una petición de URL manualmente cuando manageCookies se establece en true. En otros sistemas operativos, añadir las cookies con una petición es permitida independientemente de que manageCookies se establezca en true o false. Si está permitido, puede añadir las cookies a una petición manualmente agregando un objeto URLRequestHeader que contenga la cookie al conjunto requestHeaders.

En Mac OS, las cookies se comparten con Safari. Para borrar las cookies de Mac OS:

  1. Abra Safari.
  2. Seleccione Safari > Preferencias y haga clic en el panel Seguridad.
  3. Pulse el botón Mostrar cookies.
  4. Haga clic en Eliminar todo.

Para borrar las cookies en Windows:

  1. En el panel de control Propiedades de Internet, haga clic en la ficha General.
  2. Haga clic en el botón Eliminar cookies.

El valor predeterminado es true.



Implementación
    public function get manageCookies():Boolean
    public function set manageCookies(value:Boolean):void

Emite
SecurityError — La llamada no procede del entorno limitado de seguridad de la aplicación de AIR.

Elementos de API relacionados

method

propiedad 
method:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Controla el formulario HTTP para el método de envío.

Para el contenido SWF que se ejecuta en Flash Player (en el navegador), esta propiedad está limitada a las operaciones GET o POST, y los valores válidos son URLRequestMethod.GET o URLRequestMethod.POST.

Para el contenido que se ejecuta en Adobe AIR, puede utilizar cualquier valor de cadena si el contenido se encuentra en el entorno limitado de seguridad de la aplicación. Por el contrario, cuando el contenido se ejecuta en Flash Player, está limitado al uso de las operaciones GET o POST.

Para contenido ejecutado en Adobe AIR, cuando utiliza la función navigateToURL(), el motor de ejecución trata un URLRequest que utiliza el método POST (uno con su propiedad method establecida en URLRequestMethod.POST ) como lo haría con el método GET.

Nota: si la ejecución se produce en Flash Player y el formulario al que se hace referencia no tiene cuerpo, Flash Player utiliza automáticamente una operación GET, aunque el método se defina como URLRequestMethod.POST. Por este motivo, se recomienda incluir siempre un cuerpo “inactivo” para garantizar que se utilice el método correcto.

El valor predeterminado es URLRequestMethod.GET.



Implementación
    public function get method():String
    public function set method(value:String):void

Emite
ArgumentError — Si el parámetro value no es URLRequestMethod.GET ni URLRequestMethod.POST.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se abre la aplicación remota alojada en http://www.[yourDomain].com/application.jsp en una nueva ventana del navegador y transfiere los datos sobre una sesión de usuario, capturados en un objeto URLVariables, en el servidor web. Establece de forma explícita el valor de la propiedad URLRequest.method como URLRequestMethod.POST.

A continuación se detallan los fragmentos más importantes del ejemplo:

  1. La función constructora crea una instancia de URLRequest llamada request y toma la URL de la aplicación remota como parámetro.
  2. Se crea un objeto URLVariables y dos de sus propiedades son valores asignados.
  3. Se asigna el objeto URLVariables a la propiedad data del objeto URLRequest.
  4. El valor de la propiedad URLRequest.method se define como URLRequestMethod.POST.
  5. El ejemplo llama a navigateToURL, que abre una nueva ventana del navegador con la URL de la aplicación remota.

Nota: para ejecutar el ejemplo, la URL de la aplicación remota del ejemplo debe sustituirse por una URL que funcione. Además, necesitará código de servidor para procesar la información capturada por Flash Player en el objeto URLVariables.

package {
    import flash.display.Sprite;
    import flash.net.navigateToURL;
    import flash.net.URLRequest;
    import flash.net.URLRequestMethod;
    import flash.net.URLVariables;

    public class URLRequest_method extends Sprite {

        public function URLRequest_method() {
            var url:String = "http://www.[yourDomain].com/application.jsp";
            var request:URLRequest = new URLRequest(url);
            
            var variables:URLVariables = new URLVariables();
            variables.exampleSessionId = new Date().getTime();
            variables.exampleUserLabel = "guest";
            request.data = variables;
            request.method = URLRequestMethod.POST;
            
            navigateToURL(request);
        }
    }
}

requestHeaders

propiedad 
requestHeaders:Array

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

El conjunto de encabezados de petición HTTP que se añadirán a la petición HTTP. El conjunto está formado por objetos URLRequestHeader. Cada objeto del conjunto debe ser un objeto URLRequestHeader que contenga una cadena de nombre y de valor, del modo siguiente:

     var rhArray:Array = new Array(new URLRequestHeader("Content-Type", "text/html"));
     

Flash Player y el tiempo de ejecución de AIR imponen determinadas restricciones en los encabezados de solicitud. Para obtener más información, consulte la descripción de la clase URLRequestHeader.

No todos los métodos que aceptan los parámetros URLRequest admiten la propiedad requestHeaders; consulte la documentación del método que vaya a llamar. Por ejemplo, los métodos FileReference.upload() y FileReference.download() no admiten la propiedad URLRequest.requestHeaders.

Debido a las limitaciones del navegador, los encabezados de petición HTTP personalizados sólo se admiten para peticiones POST y no para peticiones GET.



Implementación
    public function get requestHeaders():Array
    public function set requestHeaders(value:Array):void

Elementos de API relacionados

url

propiedad 
url:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

La URL que se va a solicitar.

Es importante codificar todos los caracteres descritos como no seguros en la especificación del localizador uniforme de recursos (consulte http://www.faqs.org/rfcs/rfc1738.html) o reservados en el esquema de URL del objeto URLRequest (cuando no se utilizan para su finalidad reservada). Por ejemplo, utilice "%25" como símbolo de porcentaje (%) y "%23" como signo del número (#), como a continuación "http://www.example.com/orderForm.cfm?item=%23B-3&discount=50%25".

De forma predeterminada, la URL debe estar en el mismo dominio que el archivo que realiza la llamada, a no ser que el contenido se ejecute en el entorno limitado de seguridad de la aplicación de Adobe AIR. Si necesita cargar datos desde un dominio distinto, sitúe un archivo de política URL en el servidor que aloja los datos. Para obtener más información, consulte la descripción de la clase URLRequest.

Para el contenido que se ejecuta en Adobe AIR, los archivos del entorno limitado de seguridad de la aplicación (archivos instalados con la aplicación AIR) pueden acceder a las URL mediante cualquiera de los siguientes esquemas de URL:

  • http y https
  • file
  • app-storage
  • app

Nota: IPv6 (Protocolo de Internet, versión 6) se admite en AIR y en Flash Player 9.0.115.0 y versiones posteriores. IPv6 es una versión del Protocolo de Internet que admite direcciones de 128 bits (una mejora con respecto al protocolo anterior IPv4 que admite direcciones de 32 bits). Es posible que tenga que activar IPv6 en sus interfaces de red. Para más información, consulte la Ayuda del sistema operativo que aloja los datos. Si se admite IPv6 en el sistema de host, puede especificar direcciones literales numéricas de IPv6 en las URL entre corchetes ([]), tal y como se muestra a continuación .

     rtmp://[2001:db8:ccc3:ffff:0:444d:555e:666f]:1935/test
     



Implementación
    public function get url():String
    public function set url(value:String):void

Ejemplo  ( Cómo utilizar este ejemplo )
En el ejemplo siguiente se muestra cómo cargar dinámicamente una imagen mediante la clase Loader en ActionScript 3.0. Ejemplo facilitado por ActionScriptExamples.com.
var url:String = "http://www.helpexamples.com/flash/images/image2.jpg";
var urlRequest:URLRequest = new URLRequest(url);
var loader:Loader = new Loader();
loader.load(urlRequest);
addChild(loader);
    

useCache

propiedad 
useCache:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0

Especifica si se debe consultar la memoria caché local antes de que URLRequest tome los datos.

Nota: el método HTMLLoader.load() no admite la propiedad URLRequest.useCache.

El valor predeterminado es true.



Implementación
    public function get useCache():Boolean
    public function set useCache(value:Boolean):void

Emite
SecurityError — La llamada no procede del entorno limitado de seguridad de la aplicación de AIR.

Elementos de API relacionados

userAgent

propiedad 
userAgent:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Lite 4

Especifica la cadena de agente de usuario que se utiliza en la petición HTTP.

El valor predeterminado es la misma cadena de agente de usuario que utiliza Flash Player. Esta cadena no es la misma en Mac, Linux y en Windows.

Nota: esta propiedad no afecta a la cadena de agente de usuario si el objeto URLRequest object se utiliza con el método load() de un objeto HTMLLoader. Para definir la cadena de agente de usaurio de un objeto HTMLLoader, establezca la propiedad userAgent del objeto HTMLLoader o defina la propiedad estática URLRequestDefaults.userAgent.



Implementación
    public function get userAgent():String
    public function set userAgent(value:String):void

Emite
SecurityError — La llamada no procede del entorno limitado de seguridad de la aplicación de AIR.

Elementos de API relacionados

Información sobre constructores

URLRequest

()Información sobre
public function URLRequest(url:String = null)

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Crea un objeto URLRequest. Si System.useCodePage es true, la solicitud se codifica con la página de códigos del sistema y no con Unicode. Si System.useCodePage es false, la solicitud se codifica con Unicode, y no con la página de códigos del sistema.

Parámetros
url:String (default = null) — La URL que se va a solicitar. Se puede establecer la URL más adelante con la propiedad url.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente se muestra cómo abrir ventanas del navegador desde Flash Player con el método navigateToURL(). Ejemplo facilitado por ActionScriptExamples.com.
// Requires
// - Button symbol on Stage (or a display object, such as a MovieClip) with instance name "buttonSymbol"
//
buttonSymbol.addEventListener(MouseEvent.CLICK, buttonSymbol_click);
 
function buttonSymbol_click(evt:MouseEvent):void {
    var req:URLRequest = new URLRequest("http://www.adobe.com/");
    navigateToURL(req, "_blank");
}
Información sobre métodos

useRedirectedURL

()método
public function useRedirectedURL(sourceRequest:URLRequest, wholeURL:Boolean = false, pattern:* = null, replace:String = null):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 11.8, AIR 3.8

Permite la sustitución de una URL redirigida desde un objeto URLRequest de origen por alguna parte de la URL en un objeto URLRequest nuevo. Una vez que se haya redirigido una solicitud inicial, esto permite que se envíen solicitudes posteriores directamente a la ubicación de redirección del servidor.

Una vez que el objeto URLRequest inicial haya finalizado, si HTTPStatusEvent.redirected es true, este método se puede invocar con la solicitud inicial como sourcerequest. De forma predeterminada, se utilizará el dominio de la URL redirigida en lugar del dominio de la URL del objeto URLRequest. Se debe establecer URLRequest.url antes de llamar a este método. El método se debe invocar antes de que se cargue el objeto URLRequest. Opcionalmente, si el parámetro wholeURL es true, se sustituirá la URL completa (a excepción del nombre de archivo) del objeto URLRequest de origen por la URL completa sin el nombre final de archivo de este objeto URLRequest. Además, quien realice la llamada puede proporcionar, de manera opcional, una cadena o expresión regular en el parámetro pattern. Se busca el patrón y se sustituye por la cadena del parámetro replace. La búsqueda y el reemplazo se llevan a cabo después de la sustitución de la URL.

Parámetros

sourceRequest:URLRequest — Un objeto URLRequest que ya se ha solicitado y redirigido. La URL redirigida se utilizará para sustituir una parte de la URL de este objeto URLRequest.
 
wholeURL:Boolean (default = false) — Indica si se utiliza solo el dominio de la URL final sourceRequest para sustituir el dominio de la URL de la solicitud o si se utiliza la URL completa, pero sin el nombre de archivo. El valor predeterminado es false.
 
pattern:* (default = null) — Un patrón para buscar en la URL. Puede ser una cadena o un objeto RegExp. El valor predeterminado es “null”.
 
replace:String (default = null) — Una cadena con la que se reemplaza el patrón si se encuentra en la URL. El valor predeterminado es “null”.

Elementos de API relacionados

URLRequestExample.as

En el ejemplo siguiente, se crea un nuevo objeto Loader y se transmite a un objeto URLRequest que contiene la ruta a un archivo XML. Si la operación de carga es correcta, se distribuye un evento complete y se realiza un seguimiento de los datos del archivo XML hasta el resultado. Los controladores de eventos adicionales capturan otros eventos, incluidos los eventos de error.

Para ejecutar el ejemplo, coloque un archivo llamado XMLFile.xml en el mismo directorio que el archivo SWF.

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.*;

    public class URLRequestExample extends Sprite {
        private var loader:URLLoader;
        
        public function URLRequestExample() {
            loader = new URLLoader();
            configureListeners(loader);

            var request:URLRequest = new URLRequest("XMLFile.xml");
            try {
                loader.load(request);
            } catch (error:Error) {
                trace("Unable to load requested document.");
            }
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
        }

        private function completeHandler(event:Event):void {
            var loader:URLLoader = URLLoader(event.target);
            trace("completeHandler: " + loader.data);
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            trace("progressHandler loaded:" + event.bytesLoaded + " total: " + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}




[ X ]¿Por qué hay texto en inglés?
Cierto contenido de la Referencia de ActionScript 3.0 se muestra en inglés

No todo el contenido de la Referencia de ActionScript 3.0 se traduce a todos los idiomas. Si un elemento del lenguaje no se traduce, aparecerá en inglés. Por ejemplo, la clase ga.controls.HelpBox no está traducida en ningún idioma. Por lo tanto, en la versión en español de la referencia, la clase ga.controls.HelpBox aparecerá en inglés.