Package | flash.net |
Class | public final class URLLoaderDataFormat |
Inheritance | URLLoaderDataFormat Object |
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9, Flash Lite 4 |
Public Properties
Public Methods
Public Constants
Constant | Defined By | ||
---|---|---|---|
BINARY : String = "binary" [static]
Specifies that downloaded data is received as raw binary data. | URLLoaderDataFormat | ||
TEXT : String = "text" [static]
Specifies that downloaded data is received as text. | URLLoaderDataFormat | ||
VARIABLES : String = "variables" [static]
Specifies that downloaded data is received as URL-encoded variables. | URLLoaderDataFormat |
Constant Detail
BINARY | Constant |
public static const BINARY:String = "binary"
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9, Flash Lite 4 |
Specifies that downloaded data is received as raw binary data.
TEXT | Constant |
public static const TEXT:String = "text"
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9, Flash Lite 4 |
Specifies that downloaded data is received as text.
VARIABLES | Constant |
public static const VARIABLES:String = "variables"
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9, Flash Lite 4 |
Specifies that downloaded data is received as URL-encoded variables.
Examples How to use this example
URLLoaderDataFormatExample.as
The following example uses the URLLoaderDataFormatExample class to display
data format and status information for a file loaded at runtime. This is accomplished
using the following steps:
- The class constructor creates a URLLoader instance named
loader
and a URLRequest instance namedrequest
, which is the location and name of the file to be loaded. - The
loader
object is passed to theconfigureListeners()
method, which adds listeners for each of the supported URLLoader events:completeHandler()
: listens for thecomplete
event, which is dispatched after TextFile.txt has successfully loaded.openHandler()
: listens for theopen
event, dispatched upon start of the download (to the player) of TextFile.txt.progressHandler()
: listens for theprogress
events, dispatched when data is received as the download operation progresses.securityErrorHandler()
: listens forsecurityError
events, which would be dispatched if the text file was accessed with the wrong local playback security setting.httpStatusHandler()
: listens forhttpStatusHandler
events, which will not be dispatched in this case since TextFile.txt is local.ioErrorHandler()
: listens forioError
events, which would happen only if there were a serious problem with the file, such as if it were missing.
- The
request
object is then passed to theloader.load()
method, which loads the text file into memory using aDisplayObject
object.
Notes:
- You will need to compile the SWF file with "Local playback security" set to "Access local files only".
- This example requires that a file named TextFile.txt be placed in the same directory as your SWF file. If you would like to see this example identify binary or URL-encoded data files, you will need to provide the file in the proper data format and change TextFile.txt to the name and location of the new file.
package { import flash.display.Sprite; import flash.events.*; import flash.net.*; public class URLLoaderDataFormatExample extends Sprite { private var source:String = "TextFile.txt"; private var dataFormat:String = URLLoaderDataFormat.TEXT; public function URLLoaderDataFormatExample () { var loader:URLLoader = new URLLoader(); loader.dataFormat = dataFormat; configureListeners(loader); var request:URLRequest = new URLRequest(source); try { loader.load(request); } catch (error:Error) { trace("Error loading requested document: " + source); } } private function configureListeners(dispatcher:URLLoader):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); switch(loader.dataFormat) { case URLLoaderDataFormat.TEXT : trace("completeHandler (text): " + loader.data); break; case URLLoaderDataFormat.BINARY : trace("completeHandler (binary): " + loader.data); break; case URLLoaderDataFormat.VARIABLES : trace("completeHandler (variables): " + loader.data); break; } } private function httpStatusHandler(event:Event):void { trace("httpStatusHandler: " + event); } private function ioErrorHandler(event:IOErrorEvent):void { trace("ioErrorHandler: " + event); } 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); } } }
Thu May 20 2010, 02:19 AM -07:00