Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: AIR 30.0 e versioni precedenti, Flash Player 30.0 e versioni precedenti, Flash Lite 4
Flex 4.6 e versioni precedenti, Flash Pro CS6 e versioni precedenti
Nascondi filtri
flash.net 

URLRequest  - AS3

Pacchettix

Primo livello
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

Elementi del linguaggio

Costanti globali
Funzioni globali
Operatori
Istruzioni, parole chiave e direttive
Tipi speciali

Appendici

Novità
Errori del compilatore
Avvisi del compilatore
Errori runtime
Migrazione a ActionScript 3
Set di caratteri supportati
Tag solo di MXML
Elementi XML di Motion
Tag Timed Text
Elenco degli elementi obsoleti
Costanti di implementazione dell’accessibilità
Utilizzare gli esempi ActionScript
Note legali
Pacchettoflash.net
Classepublic final class URLRequest
EreditarietàURLRequest Inheritance Object

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

La classe URLRequest cattura tutte le informazioni in una richiesta HTTP singola. Gli oggetti URLRequest vengono passati ai metodi load() delle classi Loader, URLStream e URLLoader e ad altre operazioni di caricamento, per avviare lo scaricamento dell'URL. Vengono inoltre passati ai metodi upload() e download() della classe FileReference.

Un file SWF che si trova nella sandbox locale con file system potrebbe non caricare dati da o fornire dati a una risorsa presente nella sandbox di rete.

Per impostazione predefinita, il file SWF chiamante e l'URL da caricare devono trovarsi nello stesso dominio. Un file SWF, ad esempio, sul sito www.adobe.com può caricare i dati solo dalle origini presenti in www.adobe.com. Per caricare dati da un dominio diverso, collocate un file dei criteri degli URL sul server sul quale si trovano i dati.

Tuttavia, in Adobe AIR, il contenuto della sandbox di sicurezza dell'applicazione (contenuto installato con l'applicazione AIR) non è limitato da tali restrizioni di sicurezza. Per il contenuto in esecuzione in Adobe AIR, i file nella funzione di sicurezza sandbox dell'applicazione possono accedere agli URL mediante uno qualunque degli schemi URL seguenti:

  • http e https
  • file
  • app-storage
  • app

Il contenuto in esecuzione in Adobe AIR che non si trova nella sandbox di sicurezza dell'applicazione è sottoposto alle stesse limitazioni del contenuto in esecuzione nel browser (in Flash Player), e il caricamento è regolato dal dominio del contenuto e dalle eventuali autorizzazioni concesse nei file dei criteri degli URL.

Nota: ATS (App Transport Security) è stato introdotto da Apple in iOS9 e non consente le connessioni non protette tra l’app e i servizi web. A causa di questa modifica tutte le connessioni ai siti Web non protetti tramite Loader, URLLoader verranno interrotte e non funzioneranno a causa di ATS (App Transport Security). Per specificare le eccezioni al comportamento predefinito, è possibile aggiungere tasti al descrittore dell’applicazione nell’app.

Specificate le eccezioni per il comportamento predefinito aggiungendo tasti al tag InfoAdditions del descrittore dell'applicazione nell'app.

  <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>
  

Per ulteriori informazioni sulla sicurezza, vedete l'argomento sulla sicurezza nel Centro per sviluppatori di Flash Player .

Vedere gli esempi

Altri esempi

Altre informazioni

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
      authenticate : Boolean
Specifica se le richieste di autenticazione devono essere gestite (true) o meno (false) per questa richiesta.
URLRequest
      cacheResponse : Boolean
Specifica se i dati di risposta corretti devono essere memorizzati nella cache per questa richiesta.
URLRequest
 Inheritedconstructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  contentType : String
Il tipo MIME del contenuto nella proprietà data.
URLRequest
  data : Object
Un oggetto che contiene i dati da trasmettere con la richiesta URL.
URLRequest
  digest : String
Una stringa che identifica in modo univoco il componente piattaforma Adobe firmato da memorizzare nella (o recuperare dalla) cache di Flash Player.
URLRequest
  followRedirects : Boolean
Specifica se i reindirizzamenti devono essere seguiti (true) o meno (false).
URLRequest
      idleTimeout : Number
Specifica il valore del timeout di inattività (in millisecondi) per questa richiesta.
URLRequest
      manageCookies : Boolean
Specifica se lo stack di protocollo HTTP deve gestire i cookie per questa richiesta.
URLRequest
  method : String
Controlla il metodo di invio dei form HTTP.
URLRequest
  requestHeaders : Array
L'array di intestazioni di richiesta HTTP da aggiungere alla richiesta HTTP.
URLRequest
  url : String
L'URL da richiedere.
URLRequest
      useCache : Boolean
Specifica se la cache locale deve essere consultata prima che URLRequest recuperi i dati.
URLRequest
  userAgent : String
Specifica la stringa agente utente da utilizzare nella richiesta HTTP.
URLRequest
Metodi pubblici
 MetodoDefinito da
  
URLRequest(url:String = null)
Crea un oggetto URLRequest.
URLRequest
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
  
useRedirectedURL(sourceRequest:URLRequest, wholeURL:Boolean = false, pattern:* = null, replace:String = null):void
Consente la sostituzione di un URL reindirizzato da un’URLRequest di origine con una porzione dell’URL di una nuova URLRequest.
URLRequest
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà
    

authenticate

proprietà
authenticate:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0

Specifica se le richieste di autenticazione devono essere gestite (true) o meno (false) per questa richiesta. Se false, i problemi di autenticazione restituiscono un errore HTTP.

I metodi di autenticazione supportati sono:

  • Windows: HTTP Basic/Digest, Windows Integrated Authentication (compresi NTLM e Kerberos), SSL Certificate Authentication.
  • Mac: HTTP Standard/Digest, NTLM, SSL Certificate Authentication.

Nota: i metodi FileReference.upload(), FileReference.download() e HTMLLoader.load() non supportano la proprietà URLRequest.authenticate.

Il valore predefinito è true.



Implementazione
    public function get authenticate():Boolean
    public function set authenticate(value:Boolean):void

Genera
SecurityError — Il chiamante non si trova nella funzione di sicurezza sandbox dell'applicazione AIR.

Elementi API correlati

    

cacheResponse

proprietà 
cacheResponse:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0

Specifica se i dati di risposta corretti devono essere memorizzati nella cache per questa richiesta. Quando è true, l'applicazione AIR utilizza la cache HTTP del sistema operativo.

Nota: il metodo HTMLLoader.load() non supporta la proprietà URLRequest.cacheResponse.

Il valore predefinito è true.



Implementazione
    public function get cacheResponse():Boolean
    public function set cacheResponse(value:Boolean):void

Genera
SecurityError — Il chiamante non si trova nella funzione di sicurezza sandbox dell'applicazione AIR.

Elementi API correlati

contentType

proprietà 
contentType:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Il tipo MIME del contenuto nella proprietà data.

Il valore predefinito è application/x-www-form-urlencoded.

Nota: i metodi FileReference.upload(), FileReference.download() e HTMLLoader.load() non supportano la proprietà URLRequest.contentType.

Quando inviate una richiesta POST, i valori delle proprietà contentType e data devono corrispondere correttamente. Il valore della proprietà contentType indica ai server come interpretare il valore della proprietà data.

  • Se il valore della proprietà data è un oggetto URLVariables, il valore di contentType deve essere application/x-www-form-urlencoded.
  • Se il valore della proprietà data è di qualsiasi altro tipo, il valore di contentType dovrebbe indicare il tipo di dati POST da inviare (si tratta dei dati binari o in formato stringa contenuti nel valore della proprietà data).
  • Per FileReference.upload(), il Content-Type della richiesta viene impostato automaticamente su multipart/form-data e il valore della proprietà contentType viene ignorato.

In Flash Player 10 e versioni successive, se utilizzate un Content-Type multipart (ad esempio "multipart/form-data") che contiene un caricamento (indicato da un parametro "filename" in un'intestazione "content-disposition" nel corpo POST), l'operazione POST è soggetta alle regole di sicurezza applicate ai caricamenti:

  • L'operazione POST deve essere eseguita come risposta a un'azione compiuta dall'utente, come un clic del mouse o la pressione di un tasto.
  • Se l'operazione POST è tra più domini (il target POST non si trova sullo stesso server del file SWF che invia la richiesta POST), il server di destinazione deve fornire un file di criteri URL che consenta l'accesso tra più domini.

Inoltre, per qualsiasi Content-Type multipart, la sintassi deve essere valida (in conformità agli standard RFC2046). Se la sintassi non è valida, l'operazione POST è soggetta alle regole di sicurezza applicate ai caricamenti.



Implementazione
    public function get contentType():String
    public function set contentType(value:String):void

Elementi API correlati

data

proprietà 
data:Object

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Un oggetto che contiene i dati da trasmettere con la richiesta URL.

Questa proprietà viene utilizzata insieme alla proprietà method . Quando il valore di method è GET, il valore di data viene aggiunto al valore di URLRequest.url, utilizzando la sintassi della stringa di query HTTP. Quando il valore di method è POST (o qualsiasi valore diverso da GET), il valore di data viene trasmesso nel corpo della richiesta HTTP.

L'API URLRequest offre il supporto POST binario e il supporto per le variabili con codifica URL, oltre al supporto per le stringhe. L'oggetto dati può essere un oggetto ByteArray, URLVariables o String.

Il modo di utilizzo dei dati dipende dal tipo degli oggetti utilizzati:

  • Se l'oggetto è un oggetto ByteArray, i dati binari dell'oggetto ByteArray vengono utilizzati come dati POST. Per GET, i dati di tipo ByteArray non sono supportati. Anche per FileReference.upload() e FileReference.download() i dati di tipo ByteArray non sono supportati.
  • Se l'oggetto è un oggetto URLVariables e il metodo è POST, le variabili vengono codificate utilizzando il formato x-www-form-urlencoded e la stringa risultante viene utilizzata come dati POST. Un'eccezione è rappresentata da una chiamata a FileReference.upload(), in cui le variabili vengono inviate sotto forma di campi separati in un post multipart/form-data.
  • Se l'oggetto è un oggetto URLVariables e il metodo è GET, l'oggetto URLVariables definisce le variabili da inviare con l'oggetto URLRequest.
  • In caso contrario, l'oggetto viene convertito in una stringa, che viene utilizzata come dati POST o GET.

Questi dati vengono inviati fino a quando un metodo, ad esempio navigateToURL() o FileReference.upload(), utilizza l'oggetto URLRequest.

Nota: il valore di contentType deve corrispondere al tipo di dati nella proprietà data. Fate riferimento alla nota nella descrizione della proprietà contentType.



Implementazione
    public function get data():Object
    public function set data(value:Object):void

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio seguente viene aperta l'applicazione remota che risiede all'indirizzo http://www.[yourDomain].com/application.jsp in una nuova finestra del browser e passa all'applicazione i dati relativi a una sessione utente, catturati in un oggetto URLVariables.

Qui di seguito sono riportati i punti salienti dell'esempio:

  1. La funzione di costruzione crea un'istanza URLRequest di nome request, utilizzando l'URL dell'applicazione remota come parametro.
  2. Viene creato un oggetto URLVariables e a due delle sue proprietà vengono assegnati dei valori.
  3. L'oggetto URLVariables viene assegnato alla proprietà data dell'oggetto URLRequest.
  4. Nell'esempio viene chiamato navigateToURL, che apre in una nuova finestra del browser in corrispondenza dell'URL dell'applicazione remota.

Nota: per provare l'esempio, l'URL dell'applicazione remota indicato deve essere sostituito con un URL funzionante. Inoltre, è necessario un codice server per elaborare le informazioni catturate da Flash Player nell'oggetto 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

proprietà 
digest:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4

Una stringa che identifica in modo univoco il componente piattaforma Adobe firmato da memorizzare nella (o recuperare dalla) cache di Flash Player. Un componente della piattaforma Adobe è un file con firma (un file SWZ) che include contenuti SWF inseriti permanentemente nella cache della macchina di un utente. Tutti i file SWZ sono firmati da Adobe. Un digest corrisponde a un singolo file memorizzato nella cache; se modificate il file in qualche modo, il relativo digest cambia in modo imprevedibile. Mediante un digest, potete verificare il file memorizzato nella cache in più domini. Due file con lo stesso digest sono lo stesso file, mentre due file con digest diversi non sono lo stesso file. Un file non può (praticamente) essere creato per effettuare lo "spoofing" di un digest e fingere di essere un altro digest.

Il digest si basa sull'algoritmo di digest messaggi SHA-256 (lunghezza di 64 caratteri in formato esadecimale).

Ad esempio, Flex SDK comprende un SWZ per la struttura Flex (e fornisce la stringa digest per quel file SWZ). Potete inserire questo SWZ sul server web e caricarlo nel file SWF (utilizzando il metodo load() di un oggetto URLLoader). Se il computer di un utente finale ha già il file SWZ corrispondente inserito nella cache, l'applicazione utilizza il file SWZ presente nella cache. Un file SWZ corrisponde se il digest a quello fornito dall'utente. Altrimenti, l'applicazione scarica il file SWZ dall'URL specificato.

Impostate solo il parametro digest in un oggetto URLRequest utilizzato in una chiamata al metodo URLLoader.load() per caricare un file SWZ. Se la proprietà digest di un oggetto URLRequest viene impostata quando lo si utilizza in altri metodi, l'applicazione solleva un'eccezione IOError.



Implementazione
    public function get digest():String
    public function set digest(value:String):void

Genera
ArgumentError — Il digest fornito non corrisponde al digest del file che viene estratto dal file con firma scaricato o dal file con firma estratto dalla cache. L'applicazione genera questo errore anche se il digest fornito ha una lunghezza non corretta o contiene dei caratteri non validi (non esadecimali).

Esempio  ( Come utilizzare questo esempio )
L'esempio seguente carica un file remoto nella cache. Al termine del caricamento, l'array di byte contiene il file vero e proprio (non il file con firma). L'esempio completa l'operazione di caricamento chiamando 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

proprietà 
followRedirects:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Lite 4

Specifica se i reindirizzamenti devono essere seguiti (true) o meno (false).

Nota: i metodi FileReference.upload(), FileReference.download() e HTMLLoader.load() non supportano la proprietà URLRequest.followRedirects.

Il valore predefinito è true.



Implementazione
    public function get followRedirects():Boolean
    public function set followRedirects(value:Boolean):void

Genera
SecurityError — Il chiamante non si trova nella funzione di sicurezza sandbox dell'applicazione AIR.

Elementi API correlati

    

idleTimeout

proprietà 
idleTimeout:Number

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 2

Specifica il valore del timeout di inattività (in millisecondi) per questa richiesta.

Il timeout di inattività è la quantità di tempo di attesa di una risposta dal server da parte del client, dopo l'apertura della connessione, prima di abbandonare la richiesta.

Nota: il metodo HTMLLoader.load() non supporta la proprietà URLRequest.idleTimeout. La classe HTMLLoader definisce la relativa proprietà idleTimeout.

Il valore predefinito è initialized from the URLRequestDefaults.idleTimeout property.



Implementazione
    public function get idleTimeout():Number
    public function set idleTimeout(value:Number):void

Genera
SecurityError — Il chiamante non si trova nella funzione di sicurezza sandbox dell'applicazione AIR.

Elementi API correlati

    

manageCookies

proprietà 
manageCookies:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0

Specifica se lo stack di protocollo HTTP deve gestire i cookie per questa richiesta. Quando è true, alla richiesta vengono aggiunti dei cookie e i cookie di risposta vengono memorizzati. Se è false, alla richiesta non vengono aggiunti cookie e i cookie di risposta non vengono memorizzati, ma gli utenti possono gestire autonomamente i cookie manipolando direttamente le intestazioni. Nota: in Windows, non potete aggiungere manualmente cookie a una richiesta di URL quando manageCookies è impostato su true. In altri sistemi operativi, l'aggiunta di cookie a una richiesta è consentita, indipendentemente dall'impostazione di manageCookies su true o su false. Se consentito, potete aggiungere manualmente cookie a una richiesta inserendo un oggetto URLRequestHeader contenente i dati del cookie all'array requestHeaders.

In Mac OS, i cookie sono condivisi con Safari. Per cancellare i cookie in Mac OS:

  1. Aprite Safari.
  2. Selezionate Safari > Preferenze e fate clic sul pannello Sicurezza.
  3. Fate clic sul pulsante Mostra cookie.
  4. Fate sul pulsante Rimuovi tutto.

Per cancellare i cookie in Windows:

  1. Aprite l'applicazione Proprietà Internet del Pannello di controllo, quindi fate clic sulla scheda Generale.
  2. Fate clic sul pulsante Cancella cookie.

Il valore predefinito è true.



Implementazione
    public function get manageCookies():Boolean
    public function set manageCookies(value:Boolean):void

Genera
SecurityError — Il chiamante non si trova nella funzione di sicurezza sandbox dell'applicazione AIR.

Elementi API correlati

method

proprietà 
method:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Controlla il metodo di invio dei form HTTP.

Per il contenuto SWF in esecuzione in Flash Player (nel browser), questa proprietà è limitata alle operazioni GET o POST, e i valori validi sono URLRequestMethod.GET o URLRequestMethod.POST.

Per il contenuto in esecuzione in Adobe AIR, potete utilizzare qualsiasi valore di stringa se il contenuto si trova nella sandbox di sicurezza dell'applicazione. Diversamente, come per il contenuto in esecuzione in Flash Player, potete utilizzare solo operazioni GET o POST.

Per i contenuti in esecuzione in Adobe AIR, quando utilizzate la funzione navigateToURL(), il runtime considera un oggetto URLRequest che utilizza il metodo POST (ovvero un oggetto la cui proprietà method è impostata su URLRequestMethod.POST) come se utilizzasse il metodo GET.

Nota: se il contenuto è in esecuzione in Flash Player e il modulo a cui fate riferimento è privo di corpo, l'applicazione usa automaticamente un'operazione GET, anche se il metodo è impostato su URLRequestMethod.POST. Per questo motivo, si consiglia di includere sempre un corpo fittizio per assicurare che venga utilizzato il metodo corretto.

Il valore predefinito è URLRequestMethod.GET.



Implementazione
    public function get method():String
    public function set method(value:String):void

Genera
ArgumentError — Se il parametro value non è URLRequestMethod.GET o URLRequestMethod.POST.

Altre informazioni

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio seguente viene aperta l'applicazione remota che risiede all'indirizzo http://www.[yourDomain].com/application.jsp in una nuova finestra del browser e passa all'applicazione i dati relativi a una sessione utente, catturati in un oggetto URLVariables. Imposta esplicitamente il valore della proprietà URLRequest.method su URLRequestMethod.POST.

Qui di seguito sono riportati i punti salienti dell'esempio:

  1. La funzione di costruzione crea un'istanza URLRequest di nome request, utilizzando l'URL dell'applicazione remota come parametro.
  2. Viene creato un oggetto URLVariables e a due delle sue proprietà vengono assegnati dei valori.
  3. L'oggetto URLVariables viene assegnato alla proprietà data dell'oggetto URLRequest.
  4. La proprietà URLRequest.method della richiesta viene impostata su URLRequestMethod.POST.
  5. Nell'esempio viene chiamato navigateToURL, che apre in una nuova finestra del browser in corrispondenza dell'URL dell'applicazione remota.

Nota: per provare l'esempio, l'URL dell'applicazione remota indicato deve essere sostituito con un URL funzionante. Inoltre, è necessario un codice server per elaborare le informazioni catturate da Flash Player nell'oggetto 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

proprietà 
requestHeaders:Array

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

L'array di intestazioni di richiesta HTTP da aggiungere alla richiesta HTTP. L'array è composto da oggetti URLRequestHeader. Ogni oggetto nell'array deve essere un oggetto URLRequestHeader che contiene una stringa nome e un valore stringa, come nell'esempio seguente:

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

Flash Player e il runtime di AIR impongono alcune limitazioni alle intestazioni delle richieste; per ulteriori informazioni, vedete la descrizione della classe URLRequestHeader.

Non tutti i metodi che accettano parametri URLRequest supportano la proprietà requestHeaders; consultate la documentazione relativa al metodo chiamato. I metodi FileReference.upload() eFileReference.download(), ad esempio, non supportano la proprietà URLRequest.requestHeaders.

A causa delle limitazioni del browser, le intestazioni delle richieste HTTP personalizzate sono supportate solo per le richieste POST e non per le richieste GET.



Implementazione
    public function get requestHeaders():Array
    public function set requestHeaders(value:Array):void

Elementi API correlati

url

proprietà 
url:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

L'URL da richiedere.

Assicuratevi di codificare tutti i caratteri che sono descritti come potenzialmente pericolosi nella specifica Uniform Resource Locator (http://www.faqs.org/rfcs/rfc1738.html) o che sono riservati nello schema URL dell'oggetto URLRequest (quando non vengono utilizzati per il relativo scopo riservato). Ad esempio, utilizzate "%25" per il simbolo di percentuale (%) e "%23" per il simbolo di numero (#), come in "http://www.example.com/orderForm.cfm?item=%23B-3&discount=50%25".

Per impostazione predefinita, l'URL deve trovarsi nello stesso dominio del file chiamante, a meno che il contenuto non venga eseguito nella sandbox di sicurezza dell'applicazione di Adobe AIR . Se dovete caricare dati da un dominio diverso, collocate un file dei criteri degli URL sul server che ospita i dati. Per ulteriori informazioni, vedete la descrizione della classe URLRequest.

Per il contenuto in esecuzione in Adobe AIR, i file nella sandbox di sicurezza dell'applicazione (file installati con l'applicazione AIR) possono accedere agli URL mediante uno qualunque degli schemi URL seguenti:

  • http e https
  • file
  • app-storage
  • app

Nota: IPv6 (Protocollo Internet versione 6) è supportato in AIR e in Flash Player 9.0.115.0 e versioni successive. IPv6 è una versione del protocollo Internet che supporta gli indirizzi a 128 bit (rappresenta un miglioramento rispetto al precedente protocollo IPv4 che supportava indirizzi a 32 bit). Potrebbe essere necessario attivare Ipv6 sulle interfacce di rete. Per maggiori informazioni, vedete la guida del sistema operativo sul quale si trovano i dati. Se il sistema host supporta IPv6 è possibile specificare il valore letterale numerico IPv6 degli URL racchiusi tra parentesi quadre ([]), come nel seguente esempio.

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



Implementazione
    public function get url():String
    public function set url(value:String):void

Altri esempi


Esempio  ( Come utilizzare questo esempio )
Nell'esempio seguente viene illustrato come caricare dinamicamente un'immagine utilizzando la classe Loader in ActionScript 3.0. Esempio fornito da 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

proprietà 
useCache:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0

Specifica se la cache locale deve essere consultata prima che URLRequest recuperi i dati.

Nota: il metodo HTMLLoader.load() non supporta la proprietà URLRequest.useCache.

Il valore predefinito è true.



Implementazione
    public function get useCache():Boolean
    public function set useCache(value:Boolean):void

Genera
SecurityError — Il chiamante non si trova nella funzione di sicurezza sandbox dell'applicazione AIR.

Elementi API correlati

userAgent

proprietà 
userAgent:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Lite 4

Specifica la stringa agente utente da utilizzare nella richiesta HTTP.

Il valore predefinito è la stessa stringa agente utente utilizzata da Flash Player, che è diversa in Mac, in Linux e in Windows.

Nota: questa proprietà non influisce sulla stringa agente utente quando l'oggetto URLRequest viene utilizzato con il metodo load() di un oggetto HTMLLoader. Per impostare la stringa agente utente di un oggetto HTMLLoader, impostate la proprietà userAgent dell'oggetto HTMLLoader o impostate la proprietà statica URLRequestDefaults.userAgent.



Implementazione
    public function get userAgent():String
    public function set userAgent(value:String):void

Genera
SecurityError — Il chiamante non si trova nella funzione di sicurezza sandbox dell'applicazione AIR.

Elementi API correlati

Descrizione della funzione di costruzione

URLRequest

()Funzione di costruzione
public function URLRequest(url:String = null)

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Crea un oggetto URLRequest. Se System.useCodePage è true, la richiesta viene codificata utilizzando la tabella codici di sistema, anziché Unicode. Se System.useCodePage è false, la richiesta viene codificata utilizzando Unicode, anziché la tabella codici di sistema.

Parametri
url:String (default = null) — L'URL da richiedere. L'URL può essere impostato successivamente mediante la proprietà url.

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )

Nell'esempio seguente viene illustrato come aprire nuove finestre del browser da Flash Player tramite il metodo navigateToURL(). Esempio fornito da 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");
}
Descrizione dei metodi

useRedirectedURL

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 11.8, AIR 3.8

Consente la sostituzione di un URL reindirizzato da un’URLRequest di origine con una porzione dell’URL di una nuova URLRequest. Quando una richiesta iniziale viene reindirizzata, è possibile inviare le richieste successive direttamente alla posizione del server reindirizzato.

Una volta completata la URLRequest iniziale, se HTTPStatusEvent.redirected è true, è possibile richiamare questo metodo utilizzando la richiesta iniziale come sourceRequest. Per impostazione predefinita, viene utilizzato il dominio dell’URL reindirizzato al posto del dominio dell’URL URLRequest. URLRequest.url deve essere impostato prima di richiamare il metodo. Il metodo deve essere richiamato prima che venga caricata la URLRequest. Facoltativamente, se il parametro wholeURL è true, l’intero URL senza il nome del file dell’URLRequest di origine viene sostituito con l’intero URL senza il nome del file finale in questa URLRequest. Inoltre, il chiamante può facoltativamente fornire una stringa o un’espressione regolare nel parametro pattern. Lo schema viene cercato e sostituito con la stringa del parametro replace. Tale ricerca e sostituzione si verifica dopo la sostituzione dell’URL.

Parametri

sourceRequest:URLRequest — Un oggetto URLRequest che è già stato richiesto e reindirizzato. L’URL reindirizzato verrà utilizzato per sostituire una porzione dell’URL di questo oggetto URLRequest.
 
wholeURL:Boolean (default = false) — Indica se utilizzare solo il dominio dell’URL sourceRequest finale per la sostituzione del dominio dell’URL di questa richiesta o utilizzare, invece, l’intero URL senza il nome del file. Il valore predefinito è false.
 
pattern:* (default = null) — Uno schema da cercare nell’URL. Può essere una stringa o un oggetto RegExp. Il valore predefinito è null.
 
replace:String (default = null) — Una stringa da usare per sostituire lo schema, se presente nell’URL. Il valore predefinito è null.

Elementi API correlati

URLRequestExample.as

Nell'esempio seguente viene creato un nuovo oggetto Loader a cui viene passato un oggetto URLRequest contenente il percorso di un file XML. Se l'operazione di caricamento viene completata correttamente, viene inviato un evento complete e i dati nel file XML vengono tracciati nell'output. Altri gestori di eventi catturano altri eventi, compresi quelli di errore.

Per provare l'esempio, collocate un file di nome XMLFile.xmf nella stessa directory del file 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 ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.