Referenshandbok för ActionScript® 3.0 i Adobe® Flash®-plattformen
Hem  |  Dölj paket och klasslista |  Paket  |  Klasser  |  Nyheter  |  Index  |  Bilagor  |  Varför på engelska?
Filter: AIR 30.0 och tidigare, Flash Player 30.0 och tidigare, Flash Lite 4
Flex 4.6 och tidigare, Flash Pro CS6 och tidigare
Dölj filter
flash.filesystem 

File  - AS3

Paketx

Översta nivån
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

Språkelement

Globala konstanter
Globala funktioner
Operatorer
Programsatser, nyckelord och direktiv
Specialtyper

Bilagor

Nyheter
Kompilatorfel
Kompileringsvarningar
Körningsfel
Flytta till ActionScript 3
Teckenuppsättningar som stöds
Endast MXML-taggar
Motion XML-element
Timed Text-taggar
Lista över borttagna element
Konstanter för hjälpmedelsimplementering
Använda ActionScript-exempel
Juridiska meddelanden
Paketflash.filesystem
Klasspublic class File
ArvFile Inheritance FileReference Inheritance EventDispatcher Inheritance Object

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Ett File-objekt representerar en sökväg till en fil eller katalog. Detta kan vara en befintlig fil eller katalog, men även en som inte finns än (till exempel sökvägen till en fil eller katalog som du tänker skapa).

File-klassen har ett antal egenskaper och metoder för att samla in information om filsystemet och utföra åtgärder (till exempel kopiera filer och kataloger).

Du kan använda File-objekt tillsammans med FileStream-klassen för att läsa och skriva filer.

File-klassen utökar FileReference-klassen. FileReference-klassen, som finns i både Flash® Player och Adobe® AIR®, utgör en pekare till en fil, men File-klassen lägger till egenskaper och metoder som av säkerhetsskäl inte visas i Flash Player (i en SWF-fil som körs i en webbläsare).

File-klassen omfattar statiska egenskaper som gör att du kan referera till vanligt förekommande katalogplatser. Dessa statiska egenskaper omfattar:

  • File.applicationStorageDirectory – en lagringskatalog som är unik för varje installerat AIR-program
  • File.applicationDirectory – den skrivskyddade katalog där programmet är installerat (tillsammans med alla installerade resurser)
  • File.desktopDirectory – användarens skrivbordskatalog
  • File.documentsDirectory – användarens dokumentkatalog
  • File.userDirectory – användarkatalogen

Dessa egenskaper har värden som har samma innebörd på olika operativsystem. Mac OS, Linux och Windows har olika inbyggda sökvägar till användarens skrivbordskatalog. Egenskapen File.desktopDirectory pekar emellertid mot rätt sökväg för skrivbordskatalogen på alla dessa plattformar. Om du vill skriva program som fungerar på alla plattformar, ska du använda dessa egenskaper som grund när du refererar till andra filer som används av programmet. Använd sedan metoden resolvePath() för att finjustera sökvägen. Den här koden pekar till exempel mot filen preferences.xml i programlagringskatalogen:

 var prefsFile:File = File.applicationStorageDirectory;
  prefsFile = prefsFile.resolvePath("preferences.xml");

Om du använder en litteral inbyggd sökväg när du refererar till en fil, fungerar den bara på en plattform. Följande File-objekt fungerar till exempel bara i Windows:

new File("C:\Documents and Settings\joe\My Documents\test.txt")

Programlagringskatalogen är särskilt användbar. Den utgör en programspecifik lagringskatalog för AIR-programmet. Den definieras med egenskapen File.applicationStorageDirectory. Notera att på Mac OS ändrades den här platsen mellan AIR 3.2 och AIR 3.3.

Du ska inte lägga till eller ta bort innehåll i programkatalogen (där AIR-programmet är installerat). Om du gör det kan du skada AIR-programmet och göra programsignaturen ogiltig. Med AIR kan du inte som standard skriva till programkatalogen, eftersom alla konton på alla operativsystem inte kan skriva till katalogen. Använd programlagringskatalogen om du vill skriva interna programfiler. Använd dokumentkatalogen om du vill skriva filer som en användare planerar att använda utanför programmet, till exempel redigerade bilder eller textfiler.

Relaterade API-element



Publika egenskaper
 EgenskapDefinieras med
      applicationDirectory : File
[statisk] [skrivskyddad] Den mapp som innehåller installerade filer för programmet.
File
      applicationStorageDirectory : File
[statisk] [skrivskyddad] Programmets privata lagringskatalog.
File
      cacheDirectory : File
[statisk] [skrivskyddad] Programmets cachekatalog.
File
 Inheritedconstructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.
Object
 InheritedcreationDate : Date
[skrivskyddad] Det datum filen skapades på den lokala disken.
FileReference
 Inheritedcreator : String
[skrivskyddad] Macintosh-skapartypen för filen, som endast används i Mac OS-versioner tidigare än Mac OS X.
FileReference
 Inheriteddata : ByteArray
[skrivskyddad] ByteArray-objektet som representerar data från den inlästa filen efter ett lyckat anrop till metoden load().
FileReference
      desktopDirectory : File
[statisk] [skrivskyddad] Användarens skrivbordskatalog.
File
      documentsDirectory : File
[statisk] [skrivskyddad] Användarens dokumentkatalog.
File
      downloaded : Boolean
Anger om den fil eller katalog som referensen gäller har hämtats (från Internet) eller inte.
File
      exists : Boolean
[skrivskyddad] Anger om den fil eller katalog som refereras finns.
File
 Inherited    extension : String
[skrivskyddad] Filnamnstillägget.
FileReference
      icon : Icon
[skrivskyddad] Ett Icon-objekt som innehåller de ikoner som har definierats för filen.
File
      isDirectory : Boolean
[skrivskyddad] Anger om referensen är en katalog.
File
      isHidden : Boolean
[skrivskyddad] Anger om den fil eller katalog som refereras är ”dold”. Värdet är true om den fil eller katalog som refereras är dold och false i annat fall.
File
      isPackage : Boolean
[skrivskyddad] Anger om den katalog som refereras är ett paket.
File
      isSymbolicLink : Boolean
[skrivskyddad] Anger om referensen är en symbolisk länk.
File
      lineEnding : String
[statisk] [skrivskyddad] Den teckensekvens för radslut som används av värdoperativsystemet.
File
 InheritedmodificationDate : Date
[skrivskyddad] Hämtar det datum filen på den lokala disken ändrades senast.
FileReference
 Inheritedname : String
[skrivskyddad] Filens namn på den lokala disken.
FileReference
      nativePath : String
Den fullständiga sökvägen i värdoperativsystemets representation.
File
      parent : File
[skrivskyddad] Den katalog som innehåller filen eller katalogen som refereras av det här File-objektet.
File
      permissionStatus : String
[statisk] [skrivskyddad] Avgör om programmet har beviljats åtkomst till filsystemet.
File
      preventBackup : Boolean
Anger huruvida miljön förhindrar det här File-objektet från att säkerhetskopieras tillbaka till molnet.
File
      separator : String
[statisk] [skrivskyddad] Värdoperativsystemets sökvägsavgränsare.
File
 Inheritedsize : Number
[skrivskyddad] Filens storlek på den lokala disken, i byte.
FileReference
      spaceAvailable : Number
[skrivskyddad] Det tillgängliga utrymmet för användning vid denna File-plats, i byte.
File
      systemCharset : String
[statisk] [skrivskyddad] Den standardkodning som används av värdoperativsystemet.
File
 Inheritedtype : String
[skrivskyddad] Filtypen.
FileReference
      url : String
URL för den här filsökvägen.
File
      userDirectory : File
[statisk] [skrivskyddad] Användarens katalog.
File
Publika metoder
 MetodDefinieras med
  
    File(path:String = null)
Konstruktorfunktionen för File-klassen.
File
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser.
EventDispatcher
 Inherited
browse(typeFilter:Array = null):Boolean
Visar en dialogruta för filbläddring där användaren kan markera en fil att överföra.
FileReference
  
Visar en dialogruta för katalogval, där användaren kan välja en katalog.
File
  
    browseForOpen(title:String, typeFilter:Array = null):void
Visar dialogrutan Öppna fil, där användaren kan välja vilken fil som ska öppnas.
File
  
    browseForOpenMultiple(title:String, typeFilter:Array = null):void
Visar dialogrutan Öppna fil, där användaren kan välja en eller flera filer som ska öppnas.
File
  
    browseForSave(title:String):void
Visar dialogrutan Spara fil, där användaren kan välja en målposition för filen.
File
  
    cancel():void
[åsidosätt] Avbryter alla väntande asynkrona åtgärder.
File
  
    canonicalize():void
Kanoniserar filsökvägen.
File
  
    clone():File
Returnerar en kopia av det här File-objektet.
File
  
    copyTo(newLocation:FileReference, overwrite:Boolean = false):void
Kopierar filen eller katalogen på den plats som anges av det här File-objektet till den plats som anges av parametern newLocation.
File
  
    copyToAsync(newLocation:FileReference, overwrite:Boolean = false):void
Startar kopiering av filen eller katalogen på den plats som anges av det här File-objektet, till den plats som anges av destination-parametern.
File
  
Skapar den angivna katalogen och alla nödvändiga överordnade kataloger.
File
  
[statisk] Returnerar en referens till en ny tillfällig katalog.
File
  
[statisk] Returnerar en referens till en ny tillfällig fil.
File
  
    deleteDirectory(deleteDirectoryContents:Boolean = false):void
Tar bort katalogen.
File
  
    deleteDirectoryAsync(deleteDirectoryContents:Boolean = false):void
Tar bort katalogen asynkront.
File
  
    deleteFile():void
Tar bort filen.
File
  
Tar bort filen asynkront.
File
 Inherited
Skickar en händelse till händelseflödet.
EventDispatcher
 Inherited
download(request:URLRequest, defaultFileName:String = null):void
Öppnar en dialogruta som användaren kan använda för att ladda ned en fil från en fjärrserver.
FileReference
  
Returnerar en array med File-objekt, som motsvarar filer och kataloger i den katalog som representeras av det här File-objektet.
File
  
Hämtar asynkront en array med File-objekt, som motsvarar innehållet i den katalog som representeras av det här File-objektet.
File
  
    getRelativePath(ref:FileReference, useDotDot:Boolean = false):String
Hittar den relativa sökvägen mellan två File-sökvägar.
File
  
[statisk] Returnerar en array med File-objekt, som listar filsystemets rotkataloger.
File
 Inherited
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse.
EventDispatcher
 Inherited
Anger om det finns en egenskap angiven för ett objekt.
Object
 Inherited
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.
Object
 Inherited
Börjar ladda ned en lokal som har markerats av en användare.
FileReference
  
    moveTo(newLocation:FileReference, overwrite:Boolean = false):void
Flyttar filen eller katalogen på den plats som anges av det här File-objektet till den plats som anges av destination-parametern.
File
  
    moveToAsync(newLocation:FileReference, overwrite:Boolean = false):void
Startar flyttning av filen eller katalogen på den plats som anges av det här File-objektet till den plats som anges av newLocation-parametern.
File
  
    moveToTrash():void
Flyttar filen eller katalogen till papperskorgen.
File
  
Flyttar filen eller katalogen till papperskorgen asynkront.
File
  
Öppnar filen med det program som har registrerats i operativsystemet för den här filtypen.
File
 Inherited
Anger om den angivna egenskapen finns och är uppräkningsbar.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Tar bort en avlyssnare från EventDispatcher-objektet.
EventDispatcher
  
[åsidosätt] Begär åtkomst till filsystemet.
File
  
    resolvePath(path:String):File
Skapar ett nytt File-objekt med en sökväg som är relativ till sökvägen för det här File-objektet, baserat på path-parametern (en sträng).
File
 Inherited
save(data:*, defaultFileName:String = null):void
Öppnar en dialogruta som kan användas för att spara en fil på en lokal dator.
FileReference
 Inherited
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.
Object
 Inherited
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.
Object
 Inherited
Returnerar det angivna objektets strängbeteckning.
Object
 Inherited
upload(request:URLRequest, uploadDataFieldName:String = "Filedata", testUpload:Boolean = false):void
Startar överföringen av filen till en fjärrserver.
FileReference
 Inherited
Initiera överföring av en fil till en URL utan kodning.
FileReference
 Inherited
Returnerar det angivna objektets primitiva värde.
Object
 Inherited
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen.
EventDispatcher
Händelser
 Händelse Sammanfattning Definieras med
 Inherited[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt.EventDispatcher
  
    cancel
Skickas när en väntande asynkron åtgärd avbryts.File
  
    complete
Skickas när en asynkron åtgärd har slutförts.File
 Inherited[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt.EventDispatcher
  Skickas när det finns en kataloglista som resultat av ett anrop i metoden getDirectoryListingAsync().File
 InheritedSkickas om ett anrop till metoden upload() eller uploadUnencoded() försöker få åtkomst till data via HTTP, och Adobe AIR upptäcker och returnerar statuskoden för begäran.FileReference
 InheritedSkickas om en överföring misslyckas och det finns en HTTP-statuskod som beskriver felet.FileReference
  
    ioError
Skickas när ett fel inträffar under en asynkron filåtgärd.File
 InheritedSkickas när en överföring eller nedladdning startar.FileReference
  Skickas när programmet begär åtkomst till filsystemet.File
 InheritedSkickas periodiskt under filöverföring eller filnedladdning.FileReference
  Skickas när en åtgärd strider mot en säkerhetsbegränsning.File
  
    select
Skickas när användaren väljer en fil eller katalog i en dialogruta för fil- eller katalogbläddring.File
  Skickas när användaren väljer filer i dialogrutan som öppnas av ett anrop till browseForOpenMultiple()-metoden.File
 InheritedSkickas när data har tagits emot från servern efter en slutförd överföring.FileReference
Egenskapsdetaljer
    

applicationDirectory

egenskap
applicationDirectory:File  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Den mapp som innehåller installerade filer för programmet.

Egenskapen url för det här objektet använder URL-schemat app (inte URL-schemat file). Det innebär att strängen url anges att börja med "app:" (inte ”file:”). Om du skapar ett File-objekt som är relativt till katalogen File.applicationDirectory (med metoden resolvePath()) använder url-egenskapen för File-objektet också URL-schemat app.

Obs! Det går inte att skriva till filer eller kataloger med sökvägar som använder URL-schemat app:. Du kan inte heller ta bort eller skapa filer eller mappar med sökvägar som använder URL-schemat app:. Av säkerhetsskäl bör du aldrig ändra innehåll i programkatalogen och detta tillåts därför inte heller av operativsystemet på vissa plattformar. Om du vill spara programspecifika data bör du använda programlagringskatalogen (File.applicationStorageDirectory). Om du vill att något av innehållet (i programlagringskatalogen) ska ha tillgång till funktioner (AIR-API:er) som är reserverade för programmet, kan du visa de funktionerna med hjälp av en sandlådebrygga.

Med egenskapen applicationDirectory kan du referera till programkatalogen på ett sätt som fungerar på alla plattformar. Om du ställer in ett File-objekt till att referera till programkatalogen med hjälp av egenskapen nativePath eller url, fungerar den bara på plattformen som sökvägen gäller för.

På Android är nativePath-egenskapen för ett File-objekt som pekar på programkatalogen en tom sträng. Använd egenskapen url för att komma åt programfiler.



Implementering
    public static function get applicationDirectory():File

Relaterade API-element

    

applicationStorageDirectory

egenskap 
applicationStorageDirectory:File  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Programmets privata lagringskatalog.

Varje AIR-program har en unik, permanent programlagringskatalog, som skapas första gången du använder File.applicationStorageDirectory. Den här katalogen är unik för varje program och användare. Den här katalogen är praktisk för lagring av användar- och programspecifika data.

När du avinstallerar ett AIR-program beror det på plattformen om avinstallationsprogrammet tar bort programkatalogen och dess filer.

Egenskapen url för det här objektet använder URL-schemat app-storage (inte URL-schemat file). Det innebär att strängen url anges att börja med "app-storage:" (inte ”file:”). Om du skapar ett File-objekt som är relativt till katalogen File.applicationStoreDirectory (med metoden resolvePath()) använder url för File-objektet också URL-schemat app-storage (som i exemplet).

Med egenskapen applicationStorageDirectory kan du referera till programlagringskatalogen på ett sätt som fungerar på alla plattformar. Om du ställer in ett File-objekt till att referera till programlagringskatalogen med hjälp av egenskapen nativePath eller url, fungerar den bara på plattformen som sökvägen gäller för.

Obs! (endast Mac OS): För att uppfylla villkoren för Mac App Store ändrades den fysiska platsen för den här katalogen mellan AIR 3.2 och AIR 3.3:

  • 3.2-namnutrymme och tidigare: ~/Library/Preferences/appid/Local Store/
  • 3.3-namnutrymme och senare: path/Library/Application Support/appid/Local Store, där path är antingen ~/Library/Containers/bundle-id/Data (sandlådemiljö) eller ~ (vid körning utanför sandlådemiljö)



Implementering
    public static function get applicationStorageDirectory():File

Exempel  ( Så här använder du exemplet )
Följande kod skapar ett File-objekt som pekar på bildunderkatalogen i programlagringskatalogen.
import flash.filesystem.File;

var tempFiles:File = File.applicationStorageDirectory;
tempFiles = tempFiles.resolvePath("images/");
trace(tempFiles.url); // app-storage:/images
    

cacheDirectory

egenskap 
cacheDirectory:File  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 3.6

Programmets cachekatalog.

Med egenskapen cacheDirectory kan du referera till cachekatalogen. Programmet bör använda cachekatalogen för att lagra filer som hämtas från en server eller som kan återskapas på något annat sätt. Exempel på filer som du bör placera i cachekatalogen är cachefiler för databaser och nedladdningsbart innehåll, till exempel sådant som används av tidningar och kartprogram.

Om du ställer in ett File-objekt till att referera till cachekatalogen med hjälp av egenskapen nativePath eller url fungerar det bara på plattformar där sökvägen är giltig.

Om operativsystemet inte har stöd för en cachekatalog är cacheDirectory null.



Implementering
    public static function get cacheDirectory():File
    

desktopDirectory

egenskap 
desktopDirectory:File  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Användarens skrivbordskatalog.

Med egenskapen desktopDirectory kan du referera till skrivbordskatalogen på ett sätt som fungerar på alla plattformar. Om du ställer in ett File-objekt till att referera till skrivbordskatalogen med hjälp av egenskapen nativePath eller url, fungerar den bara på plattformen som sökvägen gäller för.

Om ett operativsystem saknar stöd för en skrivbordskatalog används en lämplig katalog på filsystemet i stället.

Enheter med AIR for TV saknar funktioner för skrivbordskataloger för användare. Egenskapen desktopDirectory refererar därför till samma katalogplats som egenskapen File.userDirectory. Användarkatalogen är unik för programmet.



Implementering
    public static function get desktopDirectory():File

Exempel  ( Så här använder du exemplet )
Följande kod genererar en lista över filer och kataloger som finns i användarens skrivbordskatalog.
import flash.filesystem.File;
var desktop:File = File.desktopDirectory;

var files:Array = desktop.getDirectoryListing();

for (var i:uint = 0; i < files.length; i++) {
    trace(files[i].nativePath);
}
    

documentsDirectory

egenskap 
documentsDirectory:File  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Användarens dokumentkatalog.

I Windows är detta katalogen "Mina dokument" (till exempel C:\Documents and Settings\användarnamn\Mina dokument). I Mac OS är standardplatsen /Användare/användarnamn/Dokument. I Linux är standardplatsen /home/användarnamn/Documents (i ett engelskt system) och egenskapen tar hänsyn till inställningen xdg-user-dirs.

Med egenskapen documentsDirectory kan du referera till dokumentkatalogen på ett sätt som fungerar på alla plattformar. Om du ställer in ett File-objekt till att referera till dokumentkatalogen med hjälp av egenskapen nativePath eller url, fungerar den bara på plattformen som sökvägen gäller för.

Om ett operativsystem saknar stöd för en dokumentkatalog används en lämplig katalog på filsystemet i stället.

Enheter med AIR for TV saknar funktioner för dokumentkataloger för användare. Egenskapen documentsDirectory refererar därför till samma katalogplats som egenskapen File.userDirectory. Användarkatalogen är unik för programmet.



Implementering
    public static function get documentsDirectory():File

Exempel  ( Så här använder du exemplet )
Följande kod använder egenskapen File.documentsDirectory och metoden File.createDirectory() för att kontrollera att det finns en katalog med namnet "AIR Test" i användarens dokumentkatalog.
import flash.filesystem.File;

var directory:File = File.documentsDirectory;
directory = directory.resolvePath("AIR Test");

File.createDirectory(directory);
trace(directory.exists); // true
    

downloaded

egenskap 
downloaded:Boolean

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 2

Anger om den fil eller katalog som referensen gäller har hämtats (från Internet) eller inte.

Den här egenskapen har endast betydelse i operativsystem där hämtade filer kan flaggas:

  • Windows XP Service Pack 2 och senare och på Windows Vista
  • Mac OS 10.5 och senare

I system där hämtade filer inte flaggas, t.ex. Linux, saknar egenskapen betydelse (och den ställs in på false).



Implementering
    public function get downloaded():Boolean
    public function set downloaded(value:Boolean):void

Relaterade API-element

    

exists

egenskap 
exists:Boolean  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Anger om den fil eller katalog som refereras finns. Värdet är true om File-objektet pekar på en befintlig fil eller katalog och false i annat fall.



Implementering
    public function get exists():Boolean

Exempel  ( Så här använder du exemplet )
Följande kod skapar en tillfällig fil, tar sedan bort den och använder egenskapen File.exists för att kontrollera om filen finns.
import flash.filesystem.*;

var temp:File = File.createTempFile();
trace(temp.exists); // true
temp.deleteFile();
trace(temp.exists); // false
    

icon

egenskap 
icon:Icon  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Ett Icon-objekt som innehåller de ikoner som har definierats för filen. Ett Icon-objekt är en array med BitmapData-objekt som motsvarar de olika ikonstatusarna. I Linux innehåller Icon-objektet inga ikoner. På Android har egenskapen icon värdet null.



Implementering
    public function get icon():Icon

Exempel  ( Så här använder du exemplet )
Följande kod visar hur du hittar den bild i icon-arrayen som har den största höjden, och ett Bitmap-objekt anges sedan för den bilden.
import flash.filesystem.File;
import flash.display.*;

var directory:File = File.documentsDirectory;
var bitmaps:Array = directory.icon.bitmaps;
var bmpData:BitmapData = new BitmapData(1, 1);
for (var i:uint = 0; i < bitmaps.length; i++) {
    if (bitmaps[i].height > bmpData.height) {
        bmpData = directory.icon.bitmaps[i];
    }
}
var iconBmp:Bitmap = new Bitmap(bmpData);
Du kan lägga till det här Bitmap-objektet som underordnad en visningsobjektbehållare, till exempel ett Sprite-objekt eller UIComponent-objekt i Flex.
    

isDirectory

egenskap 
isDirectory:Boolean  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Anger om referensen är en katalog. Värdet är true om File-objektet pekar på en katalog och false i annat fall.



Implementering
    public function get isDirectory():Boolean

Exempel  ( Så här använder du exemplet )
Följande kod skapar en array med File-objekt, som pekar på filer och kataloger i användarkatalogen, och använder sedan egenskapen isDirectory för att lista endast de File-objekt som pekar på kataloger (inte filer).
import flash.filesystem.*;

var userDirFiles:Array = File.userDirectory.getDirectoryListing();
for (var i:uint = 0; i < userDirFiles.length; i++) {
    if (userDirFiles[i].isDirectory) {
        trace(userDirFiles[i].nativePath);
    }
}    
    

isHidden

egenskap 
isHidden:Boolean  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Anger om den fil eller katalog som refereras är ”dold”. Värdet är true om den fil eller katalog som refereras är dold och false i annat fall.



Implementering
    public function get isHidden():Boolean

Exempel  ( Så här använder du exemplet )
Följande kod skapar en array med File-objekt, som pekar på filer och kataloger i användarkatalogen, och använder sedan egenskapen isHidden för att lista dolda filer och kataloger.
import flash.filesystem.*;

var userDirFiles:Array = File.userDirectory.getDirectoryListing();
for (var i:uint = 0; i < userDirFiles.length; i++) {
    if (userDirFiles[i].isHidden) {
        trace(userDirFiles[i].nativePath);
    }
}    
    

isPackage

egenskap 
isPackage:Boolean  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Anger om den katalog som refereras är ett paket.

Värdet är true om den katalog som refereras är ett paket och false i annat fall. Observera att File-klassen inte tillåter att du skapar paket direkt.

  • I Mac OS kan kataloger anges som paket och visas då som en fil i Finder i stället för som en katalog. Den här är true om den katalog som refereras är ett paket och false om filen inte är en katalog, inte finns eller inte är ett paket.
  • I andra operativsystem är den här egenskapen alltid false.



Implementering
    public function get isPackage():Boolean
    

isSymbolicLink

egenskap 
isSymbolicLink:Boolean  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Anger om referensen är en symbolisk länk.

Värdet är true om File-objektet är en symbolisk länk och false i annat fall. Observera att File-klassen inte tillåter att du skapar symboliska länkar direkt.

Med hjälp av symboliska länkar kan en fil peka på en annan fil eller katalog på disken. Symboliska länkar påminner om alias i Mac OS och genvägar i Windows, men är inte riktigt samma sak. Ett alias eller en genväg rapporteras alltid som en fil (i stället för som en katalog), och om du läser eller skriver till aliaset eller genvägen påverkar detta inte den ursprungliga fil eller katalog som dessa pekar på. En symbolisk länk fungerar däremot i allmänhet som den fil eller katalog den pekar på. Den kan rapporteras som en fil eller katalog, och om du läser eller skriver till en symbolisk länk påverkar detta den fil eller katalog som länken pekar på, inte den symboliska länken. Om du tar bort en symbolisk länk, tas emellertid länken och inte målet för länken bort.

Mac® OS®, Linux och Windows ® Vista ® har stöd för symboliska länkar. I Windows är dessutom egenskapen isSymbolicLink för ett File-objekt som refererar till en knutpunkt (används i NTFS-filsystemet) angiven som true.



Implementering
    public function get isSymbolicLink():Boolean
    

lineEnding

egenskap 
lineEnding:String  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Den teckensekvens för radslut som används av värdoperativsystemet.

I Mac OS och Linux är detta radmatningstecknet (teckenkod 0x0A hexadecimal). I Windows är det vagnreturtecknet (teckenkod 0x0D hexadecimal) följt av radmatningstecknet (teckenkod 0x0A hexadecimal).



Implementering
    public static function get lineEnding():String

Exempel  ( Så här använder du exemplet )
Följande kod skriver en sträng (str) i en textfil och använder den statiska egenskapen File.lineEnding för att ersätta alla instanser av tecknet för ny rad (representeras i koden av det reguljära uttrycket /\n/g) med rätt radslutstecken för värdoperativsystemet.
import flash.filesystem.*;

var str:String = "Hello\n" + 
        "World\n";
str = str.replace(/\n/g, File.lineEnding);
var file:File = File.documentsDirectory.resolvePath("AIR Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.WRITE);
fileStream.writeUTF(str);
fileStream.close();
    

nativePath

egenskap 
nativePath:String

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Den fullständiga sökvägen i värdoperativsystemets representation. I Mac OS och Linux används snedstreck (/) som sökvägsavgränsare. I Windows kan du däremot ställa in egenskapen nativePath genom att använda snedstreck (/) eller omvänt snedstreck (\) som sökvägsavgränsare. AIR ersätter automatiskt snedstreck med korrekt omvänt snedstreck (\).

Innan du skriver kod för att ställa in egenskapen nativePath direkt, bör du vara medveten om att detta kan skapa plattformsspecifik kod. Den inbyggda sökvägen "C:\\Documents and Settings\\bob\\Desktop" kan till exempel bara användas i Windows. Det är mycket bättre att använda följande statiska egenskaper, som representerar vanligt förekommande kataloger och som kan användas på alla plattformar:

  • File.applicationDirectory
  • File.applicationStorageDirectory
  • File.desktopDirectory
  • File.documentsDirectory
  • File.userDirectory

Med metoden resolvePath() kan du skapa en sökväg som är relativ till dessa kataloger.

Vissa Flex API:er, t.ex. source-egenskapen i SWFLoader-klassen, använder ett URL (url-egenskapen för ett File-objekt), inte en inbyggd sökväg (egenskapen nativePath).



Implementering
    public function get nativePath():String
    public function set nativePath(value:String):void

Utlöser
ArgumentError — Syntaxen för sökvägen är ogiltig.
 
SecurityError — Anroparen finns inte i programmets säkerhetssandlåda.

Exempel  ( Så här använder du exemplet )
Följande kod visar skillnaden mellan egenskapen nativePath och egenskapen url för ett File-objekt. Kommentarerna visar resultatet på en exempeldator med Windows.
import flash.filesystem.File;

var docs:File = File.documentsDirectory;
trace(docs.nativePath); // C:\Documents and Settings\turing\My Documents
trace(docs.url); // file:///C:/Documents%20and%20Settings/turing/My%20Documents
    

parent

egenskap 
parent:File  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Den katalog som innehåller filen eller katalogen som refereras av det här File-objektet.

Om filen eller katalogen inte finns returnerar egenskapen parent ändå det File-objekt som pekar på den överordnade katalogen (även om den katalogen inte finns).

Den här egenskapen är identisk med returvärdet för resolvePath(".."), med undantag för att den överordnade katalogen till en rotkatalog är null.



Implementering
    public function get parent():File

Exempel  ( Så här använder du exemplet )
Följande kod använder egenskapen parent för att visa den katalog som innehåller en tillfällig fil.
import flash.filesystem.File;

var tempFile:File = File.createTempDirectory();
trace(tempFile.parent.nativePath);
tempFile.deleteFile();
    

permissionStatus

egenskap 
permissionStatus:String  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 24.0

Avgör om programmet har beviljats åtkomst till filsystemet.



Implementering
    public static function get permissionStatus():String

Relaterade API-element

    

preventBackup

egenskap 
preventBackup:Boolean

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 3.6

Anger huruvida miljön förhindrar det här File-objektet från att säkerhetskopieras tillbaka till molnet.

Om den här egenskapen är true säkerhetskopieras det inte automatiskt till molnet på plattformar som erbjuder den här tjänsten. Standardvärdet för den här egenskapen är false.



Implementering
    public function get preventBackup():Boolean
    public function set preventBackup(value:Boolean):void
    

separator

egenskap 
separator:String  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Värdoperativsystemets sökvägsavgränsare.

I Mac OS och Linux är detta ett snedstreck (/). I Windows är det ett omvänt snedstreck (\).

Obs! När du använder omvänt snedstreck i en strängkonstant måste du skriva tecknet två gånger (som i "katalog\\fil.txt"). Varje par av omvända snedstreck i en strängkonstant representerar ett omvänt snedstreck i själva strängen.



Implementering
    public static function get separator():String

Exempel  ( Så här använder du exemplet )
Följande kod använder metoden getRelativePath() för att hämta den relativa sökvägen mellan en katalog och en fil. Koden använder sedan den statiska egenskapen File.separator för att ersätta snedstreck (/) i sökvägen med den avgränsare som används av operativsystemet, vilket är omvänt snedstreck (\) i Windows och snedstreck i andra operativsystem.
import flash.filesystem.File;

var directory:File = File.documentsDirectory.resolvePath("Apollo Test");
var file:File = File.documentsDirectory.resolvePath("Apollo Test/employees/bob/test.txt");

var relativePath:String = directory.getRelativePath(file); // employees/bob/test.txt
relativePath = relativePath.replace(/\//g, File.separator);
trace(relativePath); 
I det här exemplet använder metoden replace() ett reguljärt uttryck, /\//g, för att matcha alla snedstreck.
    

spaceAvailable

egenskap 
spaceAvailable:Number  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.1

Det tillgängliga utrymmet för användning vid denna File-plats, i byte.

Om filobjektet refererar till en katalog, visar spaceAvailable utrymmet i den katalog som filen kan använda. Om filobjektet refererar till en fil, visar spaceAvailable utrymmet som filen kan växa till. Om filplatsen inte existerar, är spaceAvailable inställd på 0. Om filobjektet refererar till en symbolisk länk, visar spaceAvailable det tillgängliga utrymme som den symboliska länken pekar ut.

Vanligtvis är det tillgängliga utrymmet för en katalog eller fil samma som det tillgängliga utrymmet i volymen som innehåller katalogen eller filen. Kvoter och kataloggränser räknas dock med i tillgängligt utrymme.

Lägga till en fil eller en katalog till en volym kräver generellt mer utrymme än den befintliga storleken på filen eller på innehållet i katalogen. Operativsystemet kan till exempel kräva mer utrymme för att lagra indexinformation. Eller också kan disksektorerna kräva mer utrymme. Tillgängligt utrymme ändras dynamsikt. Du kan alltså inte förvänta dig att tilldelas hela det rapporterade utrymmet för fillagring.



Implementering
    public function get spaceAvailable():Number
    

systemCharset

egenskap 
systemCharset:String  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Den standardkodning som används av värdoperativsystemet.

Möjliga värden är bland annat "windows-1252" "shift-jis", "cn-gb" och "iso-8859-1". En fullständig lista finns i Teckenuppsättningar som stöds.

Du kan använda det här värdet när du använder metoderna readMultiByte() och writeMultiByte() i klassen FileStream.



Implementering
    public static function get systemCharset():String

Relaterade API-element


Exempel  ( Så här använder du exemplet )
Följande kod öppnar en fil (en test.txt-fil i underkatalogen AIR Test i användarens dokumentkatalog) och använder den statiska egenskapen File.systemCharset som charSet-parameter för ett anrop till metoden readMultiByte() i ett FileStream-objekt.
import flash.filesystem.File;

var file:File = File.documentsDirectory.resolvePath("AIR Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.READ);
var str:String = fileStream.readMultiByte(file.size, File.systemCharset);
trace(str);    
    

url

egenskap 
url:String

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

URL för den här filsökvägen.

Om detta är en referens till en sökväg i programmets lagringskatalog är URL-schemat "app-storage". Om det är en referens till en sökväg i programkatalogen är URL-schemat "app". I annat fall är schemat "file".

Du kan använda blanksteg (i stället för "%20") när du tilldelar ett värde till egenskapen url, och strängarna kodas då automatiskt i AIR (till exempel konverteras blanksteg till "%20").



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

Utlöser
ArgumentError — URL-syntaxen är ogiltig.
 
SecurityError — Anroparen finns inte i programmets säkerhetssandlåda.

Relaterade API-element


Exempel  ( Så här använder du exemplet )
Följande kod visar skillnaden mellan egenskapen nativePath och egenskapen url för ett File-objekt. Kommentarerna visar resultatet på en exempeldator med Windows.
import flash.filesystem.File;

var docs:File = File.documentsDirectory;
trace(docs.nativePath); // C:\Documents and Settings\turing\My Documents
trace(docs.url); // file:///C:/Documents%20and%20Settings/turing/My%20Documents
    

userDirectory

egenskap 
userDirectory:File  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Användarens katalog.

I Windows är detta den överordnade katalogen till katalogen ”Mina dokument” (till exempel C:\Documents and Settings\användarnamn). I Mac OS är det /Användare/användarnamn. I Linux är det /home/användarnamn.

Med egenskapen userDirectory kan du referera till användarkatalogen på ett sätt som fungerar på alla plattformar. Om du ställer in egenskapen nativePath eller url för ett File-objekt direkt, fungerar den bara på plattformen som sökvägen gäller för.

Om ett operativsystem saknar stöd för en användarkatalog används en lämplig katalog på filsystemet i stället.

På enheter med AIR for TV refererar egenskapen userDirectory till en användarkatalog som är unik för programmet.



Implementering
    public static function get userDirectory():File

Exempel  ( Så här använder du exemplet )
Följande kod genererar en lista över filer och kataloger som finns i användarkatalogens rot:
import flash.filesystem.File;

var files:Array = File.userDirectory.listDirectory();
for (var i:uint = 0; i < files.length; i++) {
    trace(files[i].nativePath);
}
Konstruktordetaljer
    

File

()Konstruktor
public function File(path:String = null)

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Konstruktorfunktionen för File-klassen.

Om du skickar ett path-argument pekar File-objektet på den angivna sökvägen. Egenskapen nativePath och egenskapen url speglar då den sökvägen.

Även om du kan skicka ett path-argument för att ange en filsökväg, bör du vara medveten om att detta kan skapa plattformsspecifik kod. Den inbyggda sökvägen "C:\\Documents and Settings\\bob\\Desktop" eller en URL som "file:///C:/Documents%20and%20Settings/bob/Desktop" kan till exempel bara användas i Windows. Det är mycket bättre att använda följande statiska egenskaper, som representerar vanligt förekommande kataloger och som kan användas på alla plattformar:

  • File.applicationDirectory
  • File.applicationStorageDirectory
  • File.desktopDirectory
  • File.documentsDirectory
  • File.userDirectory

Med metoden resolvePath() kan du hämta en sökväg som är relativ till dessa kataloger. Följande kod ställer in ett File-objekt till att peka mot filen settings.xml i programlagringskatalogen:

var file:File = File.applicationStorageDirectory.resolvePath("settings.xml");

Viktigt! Om du skickar en URL-sträng i parametern path, kommer URL:n att avkodas för att matcha filsökvägen. Satsen new File("file:///c:/test/demo%20file%201%2e0.txt") skapar till exempel ett File-objekt med den inbyggda sökvägen "c:\test\demo file 1.0.txt". (En URL använder schemaprefixen file:, app:, eller app-storage:.) Om emellertid de giltiga URL-prefixen utelämnas hanteras söksträngen som en inbyggd sökväg och ingen avkodning kommer att äga rum. Du måste tänka på detta beteende när du validerar sökvägar härledda från källor som kan vara opålitliga. Om du bara validerar indatasträngen kan URL-avkodningen tillåta att någon utomstående går förbi dina valideringskontroller. Validera alltid den slutliga sökvägen för det instansierade File-objektet:

     var file:File = new File( taintedString );
     validate( file.nativePath ); //where validate() is your path validation function
     

Parametrar
path:String (default = null) — Sökvägen till filen. Du kan ange sökvägen med en URL eller med en inbyggd (plattformsspecifik) sökvägsnotation.

Om du anger en URL kan du använda följande URL-scheman: file, app eller app-storage. Följande är giltiga värden för parametern path med URL-notation:

  • "app:/DesktopPathTest.xml"
  • "app-storage:/preferences.xml"
  • "file:///C:/Documents%20and%20Settings/bob/Skrivbord" (skrivbordet på Bobs Windows-dator)
  • "file:///Användare/bob/Skrivbord" (skrivbordet på Bobs Macintosh-dator)

Det är praktiskt att använda URL-schemana app och app-storage, eftersom de kan peka på en giltig fil i alla filsystem. I de båda andra exemplen där URL-schemat file används för att peka på användarens skrivbordskatalog, skulle det vara bättre att skicka argumentet no path till File()-konstruktorn och sedan tilldela File.desktopDirectory till File-objektet. Då blir skrivbordskatalogen tillgänglig oavsett plattform och användare.

Om du anger en inbyggd sökväg kan du i Windows använda antingen omvänt snedstreck eller snedstreck som sökvägsavgränsare i det här argumentet. I Mac OS och Linux använder du snedstreck. Följande är giltiga värden för parametern path med inbyggd sökvägsnotation:

  • "C:/Documents and Settings/bob/Skrivbord"
  • "/Användare/bob/Skrivbord"

I de här båda exemplen bör argumentet no path skickas till File()-konstruktorn och sedan bör File.desktopDirectory tilldelas File-objektet. Då blir skrivbordskatalogen tillgänglig oavsett plattform och användare.


Utlöser
ArgumentError — Syntaxen för parametern path är ogiltig.

Relaterade API-element

Metoddetaljer

    browseForDirectory

()metod
public function browseForDirectory(title:String):void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Visar en dialogruta för katalogval, där användaren kan välja en katalog. När användaren väljer katalogen skickas händelsen select. Egenskapen target för select-händelsen är det File-objekt som pekar på den valda katalogen.

Dialogrutan för val av katalog visas inte alltid framför fönster som tillhör ett annat fönster (fönster där egenskapen owner är något annat än null). Undvik problem med fönsterordning genom att dölja ägda fönster innan den här metoden anropas.

Obs! På Android-enheter stöds inte browseForDirectory(). File-objektet skickar omedelbart en cancel-händelse.

Parametrar

title:String — Den sträng som visas i dialogrutans namnlist.


Händelser
cancel:Event — Skickas när användaren klickar på knappen Avbryt i dialogrutan Öppna fil.
 
select:Event — Skickas när användaren väljer en katalog och stänger dialogrutan för katalogval.
 
ioError:IOErrorEvent — Webbläsaråtgärden stöds inte på den här plattformen.

Utlöser
IllegalOperationError — En webbläsaråtgärd (browseForOpen(), browseForOpenMultiple(), browseForSave(), browseForDirectory()) körs för närvarande.
 
SecurityError — Programmet har inte den behörighet som krävs.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande kod använder metoden File.browseForDirectory() för att användaren ska kunna välja en katalog. När katalogen väljs listar koden innehållet i den valda katalogen i trace()-utdata.
import flash.filesystem.File;
import flash.events.Event;

var directory:File = File.documentsDirectory;

try
{
    directory.browseForDirectory("Select Directory");
    directory.addEventListener(Event.SELECT, directorySelected);
}
catch (error:Error)
{
    trace("Failed:", error.message);
}

function directorySelected(event:Event):void 
{
    directory = event.target as File;
    var files:Array = directory.getDirectoryListing();
    for(var i:uint = 0; i < files.length; i++)
    {
        trace(files[i].name);
    }
}

    browseForOpen

()metod 
public function browseForOpen(title:String, typeFilter:Array = null):void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Visar dialogrutan Öppna fil, där användaren kan välja vilken fil som ska öppnas.

När användaren väljer filen skickas händelsen select. Egenskapen target för select-händelsen är det File-objekt som pekar på den valda filen.

Dialogrutan Öppna fil visas inte alltid framför fönster som tillhör ett annat fönster (fönster där egenskapen owner är något annat än null). Undvik problem med fönsterordning genom att dölja ägda fönster innan den här metoden anropas.

Obs! På Android-enheter går det inte att ange titel för fildialogrutan. Parametern title ignoreras.

Parametrar

title:String — Den sträng som visas i dialogrutans namnlist.
 
typeFilter:Array (default = null) — En array med FileFilter-instanser som används för att filtrera filerna som visas i dialogrutan. Om du inte anger parametern visas alla filer. Mer information finns i klassen FileFilter.


Händelser
cancel:Event — Skickas när användaren klickar på knappen Avbryt i dialogrutan Öppna fil.
 
select:Event — Skickas när användaren väljer en fil och stänger dialogrutan Öppna fil.
 
ioError:IOErrorEvent — Webbläsaråtgärden stöds inte på den här plattformen.

Utlöser
IllegalOperationError — En webbläsaråtgärd (browseForOpen(), browseForOpenMultiple(), browseForSave(), browseForDirectory()) körs för närvarande.
 
SecurityError — Programmet har inte den behörighet som krävs.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande kod använder metoden File.browseForOpen() för att användaren ska kunna välja en textfil. När filen väljs läser koden fildata till en sträng.
import flash.filesystem.*;
import flash.events.Event;
import flash.net.FileFilter;

var fileToOpen:File = new File();
var txtFilter:FileFilter = new FileFilter("Text", "*.as;*.css;*.html;*.txt;*.xml");

try 
{
    fileToOpen.browseForOpen("Open", [txtFilter]);
    fileToOpen.addEventListener(Event.SELECT, fileSelected);
}
catch (error:Error)
{
    trace("Failed:", error.message);
}

function fileSelected(event:Event):void 
{
    var stream:FileStream = new FileStream();
    stream.open(event.target, FileMode.READ);
    var fileData:String = stream.readUTFBytes(stream.bytesAvailable);
    trace(fileData);
}

    browseForOpenMultiple

()metod 
public function browseForOpenMultiple(title:String, typeFilter:Array = null):void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Visar dialogrutan Öppna fil, där användaren kan välja en eller flera filer som ska öppnas.

När användaren väljer filerna skickas händelsen selectMultiple. Egenskapen target för select-händelsen är det här File-objektet. Till skillnad från browseForOpen(), med metoden browseForOpenMultiple(), uppdateras inte det här File-objektet så att det refererar till de valda filerna. selectMultiple-händelsen som genereras innehåller istället en array över de valda filerna.

Dialogrutan Öppna fil visas inte alltid framför fönster som tillhör ett annat fönster (fönster där egenskapen owner är något annat än null). Undvik problem med fönsterordning genom att dölja ägda fönster innan den här metoden anropas.

Obs! På Android-enheter går det inte att ange titel för fildialogrutan. Parametern title ignoreras.

Parametrar

title:String — Den sträng som visas i dialogrutans namnlist.
 
typeFilter:Array (default = null) — En array med FileFilter-instanser som används för att filtrera filerna som visas i dialogrutan. Om du inte anger parametern visas alla filer. Mer information finns i klassen FileFilter.


Händelser
cancel:Event — Skickas när användaren klickar på knappen Avbryt i dialogrutan Öppna fil.
 
selectMultiple:FileListEvent — Skickas när användaren väljer filer och stänger dialogrutan Öppna fil.
 
ioError:IOErrorEvent — Webbläsaråtgärden stöds inte på den här plattformen.

Utlöser
IllegalOperationError — En webbläsaråtgärd (browseForOpen(), browseForOpenMultiple(), browseForSave(), browseForDirectory()) körs för närvarande.
 
SecurityError — Programmet har inte den behörighet som krävs.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande kod använder metoden File.browseForOpenMultiple() för att användaren ska kunna välja flera filer. När filerna väljs returnerar koden sökvägarna för de valda filerna.
import flash.filesystem.*;
import flash.events.FileListEvent;

var docsDir:File = File.documentsDirectory;
try
{
    docsDir.browseForOpenMultiple("Select Files");
    docsDir.addEventListener(FileListEvent.SELECT_MULTIPLE, filesSelected);
}
catch (error:Error)
{
    trace("Failed:", error.message);
}

function filesSelected(event:FileListEvent):void 
{
    for (var i:uint = 0; i < event.files.length; i++) 
    {
        trace(event.files[i].nativePath);
    }
}

    browseForSave

()metod 
public function browseForSave(title:String):void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Visar dialogrutan Spara fil, där användaren kan välja en målposition för filen.

När användaren väljer filen skickas händelsen select. Egenskapen target för select-händelsen är det File-objekt som pekar på den valda Spara-platsen.

Dialogrutan Spara fil visas inte alltid framför fönster som tillhör ett annat fönster (fönster där egenskapen owner är något annat än null). Undvik problem med fönsterordning genom att dölja ägda fönster innan den här metoden anropas.

Obs! På Android-enheter går det inte att ange titel för fildialogrutan. Parametern title ignoreras.

Parametrar

title:String — Den sträng som visas i dialogrutans namnlist.


Händelser
cancel:Event — Skickas när användaren klickar på knappen Avbryt i dialogrutan Spara fil.
 
select:Event — Skickas när användaren väljer en fil och stänger dialogrutan Spara fil.
 
ioError:IOErrorEvent — Webbläsaråtgärden stöds inte på den här plattformen.

Utlöser
IllegalOperationError — En webbläsaråtgärd (browseForOpen(), browseForOpenMultiple(), browseForSave(), browseForDirectory()) körs för närvarande.
 
SecurityError — Programmet har inte den behörighet som krävs.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande kod använder metoden File.browseForSave() för att användaren ska kunna välja en sökväg där filen ska sparas. När filerna väljs sparar koden data i den valda filsökvägen.
import flash.filesystem.*;
import flash.events.Event;

var docsDir:File = File.documentsDirectory;
try
{
    docsDir.browseForSave("Save As");
    docsDir.addEventListener(Event.SELECT, saveData);
}
catch (error:Error)
{
    trace("Failed:", error.message);
}

function saveData(event:Event):void 
{
    var newFile:File = event.target as File;
    var str:String = "Hello.";
    if (!newFile.exists)
    {
        var stream:FileStream = new FileStream();
        stream.open(newFile, FileMode.WRITE);
        stream.writeUTFBytes(str);
        stream.close();
    }
}

    cancel

()metod 
override public function cancel():void

Körningsmiljöversioner: AIR 1.0

Avbryter alla väntande asynkrona åtgärder.

    canonicalize

()metod 
public function canonicalize():void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Kanoniserar filsökvägen.

Om File-objektet representerar en befintlig fil eller katalog justerar kanoniseringen sökvägen så att den matchar den verkliga filens eller katalogens namn (med avseende på skiftläge). Om File-objektet är en symbolisk länk justerar kanoniseringen sökvägen så att den matchar den fil eller katalog som länken pekar på, vare sig den filen eller katalogen finns eller inte. I skiftlägeskänsliga filsystem (till exempel Linux), och när det finns flera filer med namn där bara skiftläget skiljer, justerar metoden canonicalize() sökvägen så att den matchar den första filen som hittas (i en ordning som fastställs av filsystemet).

Dessutom konverterar kanoniseringen korta filnamn till långa filnamn i Windows.


Exempel  ( Så här använder du exemplet )

Följande kod visar hur du använder metoden canonicalize() för att hitta korrekt skiftläge för ett katalognamn. Skapa en katalog som heter AIR Test på datorns skrivbord innan du kör det här exemplet.
import flash.filesystem.*;

var path:File = File.desktopDirectory.resolvePath("air test");
trace(path.nativePath); 
path.canonicalize();
trace(path.nativePath); // ...\AIR Test


Följande kod visar hur du använder metoden canonicalize() för att hitta det långa namnet på en Windows-katalog baserat på dess korta namn. Exemplet förutsätter att det finns en katalog som heter AIR Test i C-enhetens rot och att systemet har tilldelat den katalogen det korta namnet AIR~1.
import flash.filesystem.*;

var path:File = new File();
path.nativePath = "C:\\AIR~1";
path.canonicalize();
trace(path.nativePath); // C:\AIR Test

    clone

()metod 
public function clone():File

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Returnerar en kopia av det här File-objektet. Händelseregistreringar kopieras inte.

Obs! Den här metoden kopierar inte själva filen. Det skapas bara en kopia av instansen av File-objektet i ActionScript. Om du vill kopiera en fil använder du metoden copyTo().

Returnerar
File

    copyTo

()metod 
public function copyTo(newLocation:FileReference, overwrite:Boolean = false):void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Kopierar filen eller katalogen på den plats som anges av det här File-objektet till den plats som anges av parametern newLocation. Kopieringen skapar alla nödvändiga överordnade kataloger (om möjligt). När du skriver över filer med copyTo() skrivs även filattributen över.

Parametrar

newLocation:FileReference — Den nya filens målplats. Observera att det här File-objektet anger den fil eller katalog som skapas (kopieras) och inte sökvägen till den överordnade katalogen.
 
overwrite:Boolean (default = false) — Om värdet är false misslyckas kopieringen om den fil som anges av parametern target redan finns. Om värdet är true skriver åtgärden över alla befintliga filer eller kataloger med samma namn.


Utlöser
IOError — Källan existerar inte eller målet finns och overwrite är false, eller också gick det inte att kopiera källan till målet, eller också refererar källan och målet till samma fil eller mapp och overwrite är angivet till true. I Windows kan du inte kopiera en öppen fil eller en katalog som innehåller en öppen fil.
 
SecurityError — Programmet har inte den behörighet som krävs för att skriva till målet.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande kod visar hur du använder metoden copyTo() för att kopiera en fil. Glöm inte att skapa en fil som heter test1.txt i underkatalogen AIR Test i datorns dokumentkatalog innan du kör den här koden. Den kopierade fil som skapas kallas test2.txt och placeras också i underkatalogen AIR Test. När du anger parametern overwrite som true skriver åtgärden över befintliga filer med namnet test2.txt.
import flash.filesystem.File;
import flash.events.Event;

var sourceFile:FileReference = File.documentsDirectory;
sourceFile = sourceFile.resolvePath("AIR Test/test1.txt");
var destination:FileReference = File.documentsDirectory;
destination = destination.resolvePath("AIR Test/test2.txt");

if (sourceFile.copyTo(destination, true)) {
    trace("Done.");
}

Följande kod visar hur du använder metoden copyTo() för att kopiera en fil. Glöm inte att skapa en fil som heter test1.txt i underkatalogen AIR Test i datorns hemkatalog innan du kör den här koden. Den kopierade fil som skapas kallas test2.txt. Programsatserna try och catch visar hur fel ska behandlas.
import flash.filesystem.File;

var sourceFile:File = File.documentsDirectory;
sourceFile = sourceFile.resolvePath("AIR Test/test1.txt");
var destination:File = File.documentsDirectory;
destination = destination.resolvePath("AIR Test/test2.txt");

try 
{
    sourceFile.copyTo(destination, true);
}
catch (error:Error)
{
    trace("Error:", error.message);
}

    copyToAsync

()metod 
public function copyToAsync(newLocation:FileReference, overwrite:Boolean = false):void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Startar kopiering av filen eller katalogen på den plats som anges av det här File-objektet, till den plats som anges av destination-parametern.

När åtgärden är slutförd skickas antingen en complete-händelse (lyckades) eller en ioError-händelse (misslyckades). Kopieringen skapar alla nödvändiga överordnade kataloger (om möjligt).

Parametrar

newLocation:FileReference — Den nya filens målplats. Observera att det här File-objektet anger den fil eller katalog som skapas (kopieras) och inte sökvägen till den överordnade katalogen.
 
overwrite:Boolean (default = false) — Om värdet är false misslyckas kopieringen om den fil som anges av parametern target redan finns. Om värdet är true skriver åtgärden över alla befintliga filer eller kataloger med samma namn.


Händelser
complete:Event — Skickas när filen eller katalogen har kopierats.
 
ioError:IOErrorEvent — Källan existerar inte eller målet finns och overwrite är false, eller också gick det inte att kopiera källan till målet, eller också refererar källan och målet till samma fil eller mapp och overwrite är angivet till true. I Windows kan du inte kopiera en öppen fil eller en katalog som innehåller en öppen fil.

Utlöser
SecurityError — Programmet har inte den behörighet som krävs för att skriva till målet.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande kod visar hur du använder metoden copyToAsync() för att kopiera en fil. Glöm inte att skapa en fil som heter test1.txt i underkatalogen AIR Test i datorns dokumentkatalog innan du kör den här koden. Den kopierade fil som skapas kallas test2.txt och placeras också i underkatalogen AIR Test. När du anger parametern overwrite som true skriver åtgärden över befintliga filer med namnet test2.txt.
import flash.filesystem.File;
import flash.events.Event;

var sourceFile:File = File.documentsDirectory;
sourceFile = sourceFile.resolvePath("AIR Test/test1.txt");
var destination:File = File.documentsDirectory;
destination = destination.resolvePath("AIR Test/test2.txt");

sourceFile.copyToAsync(destination, true);
sourceFile.addEventListener(Event.COMPLETE, fileCopiedHandler);

function fileCopiedHandler(event:Event):void {
    trace("Done.");
}

    createDirectory

()metod 
public function createDirectory():void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Skapar den angivna katalogen och alla nödvändiga överordnade kataloger. Om katalogen redan finns utförs inget.


Utlöser
IOError — Katalogen finns inte och det går inte att skapa den.
 
SecurityError — Programmet har inte den behörighet som krävs.

Exempel  ( Så här använder du exemplet )

Följande kod flyttar en fil med namnet test.txt på skrivbordet till underkatalogen AIR Test i dokumentkatalogen. Anropet till metoden createDirectory() säkerställer att katalogen AIR Test finns innan filen flyttas.
import flash.filesystem.*;

var source:File = File.desktopDirectory.resolvePath("test.txt");
var target:File = File.documentsDirectory.resolvePath("AIR Test/test.txt");
var targetParent:File = target.parent;
targetParent.createDirectory();
source.moveTo(target, true);

    createTempDirectory

()metod 
public static function createTempDirectory():File

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Returnerar en referens till en ny tillfällig katalog. Detta är en ny katalog i sökvägen till systemets tillfälliga katalog.

Med den här metoden kan du identifiera en ny, unik katalog och slipper köra en systemkontroll för att se om katalogen är ny och unik.

Du kanske vill ta bort den tillfälliga katalogen innan du stänger programmet, eftersom den inte tas bort automatiskt på vissa enheter.

Returnerar
File — Ett File-objekt som refererar till den nya tillfälliga katalogen.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande kod använder metoden createTempFile() för att hämta en referens till en ny tillfällig katalog.
import flash.File;

var temp:File = File.createTempDirectory();
trace(temp.nativePath);
Varje gång den här koden körs skapas en ny (unik) fil.

    createTempFile

()metod 
public static function createTempFile():File

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Returnerar en referens till en ny tillfällig fil. Detta är en ny fil i sökvägen till systemets tillfälliga katalog.

Med den här metoden kan du identifiera en ny, unik fil och slipper köra en systemkontroll för att se om filen är ny och unik.

Du kan ta bort den tillfälliga filen innan du avslutar programmet, eftersom den inte tas bort automatiskt.

Returnerar
File — Ett File-objekt som refererar till den nya tillfälliga filen.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande kod använder metoden createTempFile() för att hämta en referens till en ny tillfällig fil.
import flash.File;

var temp:File = File.createTempFile();
trace(temp.nativePath);
Varje gång den här koden körs skapas en ny (unik) fil.

    deleteDirectory

()metod 
public function deleteDirectory(deleteDirectoryContents:Boolean = false):void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Tar bort katalogen. Om den här filen är en symbolisk länk till en katalog, tas länken och inte katalogen bort.

Parametrar

deleteDirectoryContents:Boolean (default = false) — Anger om en katalog som innehåller filer eller underkataloger ska tas bort eller inte. Om värdet är false, och om katalogen innehåller filer eller kataloger, genererar ett anrop till den här metoden ett undantag.


Utlöser
IOError — Katalogen finns inte eller kan inte tas bort. I Windows kan du inte ta bort en katalog som innehåller en öppen fil.
 
SecurityError — Programmet har inte den behörighet som krävs för att ta bort katalogen.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande kod skapar en tom katalog och använder sedan metoden deleteDirectory() för att ta bort katalogen.
import flash.filesystem.File;

var directory:File = File.documentsDirectory.resolvePath("Empty Junk Directory/");
File.createDirectory(directory);
trace(directory.exists); // true
directory.deleteDirectory();
trace(directory.exists); // false

    deleteDirectoryAsync

()metod 
public function deleteDirectoryAsync(deleteDirectoryContents:Boolean = false):void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Tar bort katalogen asynkront. Om den här filen är en symbolisk länk till en katalog, tas länken och inte katalogen bort.

Parametrar

deleteDirectoryContents:Boolean (default = false) — Anger om en katalog som innehåller filer eller underkataloger ska tas bort eller inte. Om värdet är false, och om katalogen innehåller filer eller kataloger, skickar File-objektet en ioError-händelse.


Händelser
complete:Event — Skickas när katalogen har tagits bort.
 
ioError:IOErrorEvent — Katalogen finns inte eller kan inte tas bort. I Windows kan du inte ta bort en katalog som innehåller en öppen fil.

Utlöser
SecurityError — Programmet har inte den behörighet som krävs för att ta bort katalogen.

Relaterade API-element

    deleteFile

()metod 
public function deleteFile():void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Tar bort filen. Om den här filen är en symbolisk länk, tas länken och inte målfilen bort.


Utlöser
IOError — Filen finns inte eller kan inte tas bort. I Windows kan du inte ta bort en fil som är öppen.
 
SecurityError — Programmet har inte den behörighet som krävs för att ta bort filen.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande kod skapar en tillfällig fil och anropar sedan metoden deleteFile() för att ta bort den.
import flash.filesystem.*;

var file:File = File.createTempFile();
trace(file.exists); // true
file.deleteFile();
trace(file.exists); // false

    deleteFileAsync

()metod 
public function deleteFileAsync():void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Tar bort filen asynkront. Om den här filen är en symbolisk länk, tas länken och inte målfilen bort.


Händelser
complete:Event — Skickas när filen har tagits bort.
 
ioError:IOErrorEvent — Filen finns inte eller kan inte tas bort. I Windows kan du inte ta bort en fil som är öppen.

Utlöser
SecurityError — Programmet har inte den behörighet som krävs för att ta bort filen.

Relaterade API-element

    getDirectoryListing

()metod 
public function getDirectoryListing():Array

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Returnerar en array med File-objekt, som motsvarar filer och kataloger i den katalog som representeras av det här File-objektet. Den här metoden utforskar inte innehållet i underkataloger.

Returnerar
Array — En array med File-objekt.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande kod visar hur du använder metoden getDirectoryListing() för att räkna upp innehållet i användarkatalogen.
import flash.filesystem.File;

var directory:File = File.userDirectory;
var list:Array = directory.getDirectoryListing();
for (var i:uint = 0; i < list.length; i++) {
    trace(list[i].nativePath);
}

    getDirectoryListingAsync

()metod 
public function getDirectoryListingAsync():void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Hämtar asynkront en array med File-objekt, som motsvarar innehållet i den katalog som representeras av det här File-objektet.


Händelser
ioError:ErrorEvent — Du har inte tillräcklig behörighet för att läsa den här katalogen, eller också finns inte katalogen.
 
directoryListing:FileListEvent — Katalogens innehåll har räknats upp. Händelsen contents innehåller en files-egenskap som utgör den slutliga arrayen med File-objekt.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande kod visar hur du använder metoden getDirectoryListingAsync() för att räkna upp innehållet i användarkatalogen.
import flash.filesystem.File;
import flash.events.FileListEvent;

var directory:File = File.userDirectory;
directory.getDirectoryListingAsync();
directory.addEventListener(FileListEvent.DIRECTORY_LISTING, directoryListingHandler);

function directoryListingHandler(event:FileListEvent):void {
    var list:Array = event.files;
    for (var i:uint = 0; i < list.length; i++) {
        trace(list[i].nativePath);
    }
}

    getRelativePath

()metod 
public function getRelativePath(ref:FileReference, useDotDot:Boolean = false):String

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Hittar den relativa sökvägen mellan två File-sökvägar.

Den relativa sökvägen är den lista över komponenter som kan läggas till (lösas mot) den här referensen för att den andra referensen (parameter) ska hittas. Den relativa sökvägen returneras med avgränsaren "/".

Relativa sökvägar kan också innehålla ".." -referenser, men sådana sökvägar korsar inte tydliga volymgränser.

Parametrar

ref:FileReference — Ett File-objekt mot vilken sökvägen anges.
 
useDotDot:Boolean (default = false) — Anger om den slutliga relativa sökvägen kan använda ".." -komponenter.

Returnerar
String — Den relativa sökvägen mellan den här filen (eller katalogen) och ref-filen (eller -katalogen), om det är möjligt, i annat fall null.

Utlöser
ArgumentError — Referensen är null.
 
SecurityError — Anroparen finns inte i programmets säkerhetssandlåda.

    getRootDirectories

()metod 
public static function getRootDirectories():Array

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Returnerar en array med File-objekt, som listar filsystemets rotkataloger.

I Windows är det till exempel en lista med volymer som C-enheten och D-enheten. En tom enhet, t.ex. en cd- eller dvd-enhet utan skiva, ingår inte i den här arrayen. I Mac OS och Linux returnerar alltid den här metoden den unika rotkatalogen för datorn (katalogen ”/”).

På filsystem där rotkatalogen inte är läsbar, t.ex. Android-filsystemet, speglar egenskaperna för det returnerade File-objektet inte alltid det verkliga värdet. På Android rapporterar till exempel egenskapen spaceAvailable värdet 0.

Returnerar
Array — En array med File-objekt, som listar rotkatalogerna.

Exempel  ( Så här använder du exemplet )

Följande kod genererar en lista över rotkataloger:
import flash.filesystem.File;
var rootDirs:Array = File.getRootDirectories();

for (var i:uint = 0; i < rootDirs.length; i++) {
    trace(rootDirs[i].nativePath);
}

    moveTo

()metod 
public function moveTo(newLocation:FileReference, overwrite:Boolean = false):void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Flyttar filen eller katalogen på den plats som anges av det här File-objektet till den plats som anges av destination-parametern.

Om du vill byta namn på en fil anger du parametern destination så att den pekar på en sökväg i filens katalog, men med ett annat filnamn.

Flyttningen skapar alla nödvändiga överordnade kataloger (om möjligt).

Parametrar

newLocation:FileReference — Målet för flyttningen. Det här objektet anger sökvägen till den slutliga (flyttade) filen eller katalogen, och inte sökvägen till den överordnade katalogen.
 
overwrite:Boolean (default = false) — Om värdet är false misslyckas flyttningen om target-filen redan finns. Om värdet är true skriver åtgärden över alla befintliga filer eller kataloger med samma namn.


Utlöser
IOError — Källan existerar inte eller målet finns och overwrite är false, eller också gick det inte att flytta källan till målet, eller också refererar källan och målet till samma fil eller mapp och overwrite är angivet till true. I Windows kan du inte flytta en öppen fil eller en katalog som innehåller en öppen fil.
 
SecurityError — Programmet har inte den behörighet som krävs för att flytta filen.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande kod visar hur du använder metoden moveTo() för att byta namn på en fil. Det ursprungliga filnamnet är test1.txt och det nya namnet är test2.txt. Eftersom File-objektet för både källa och mål pekar på samma katalog (underkatalogen Apollo Test i användarens dokumentkatalog) byter metoden moveTo() namn på filen (i stället för att flytta den till en annan katalog). Glöm inte att skapa en fil som heter test1.txt i underkatalogen AIR Test i datorns dokumentkatalog innan du kör den här koden. När du anger parametern overwrite som true skriver åtgärden över befintliga filer med namnet test2.txt.
import flash.filesystem.File;
import flash.events.Event;

var sourceFile:File = File.documentsDirectory;
sourceFile = sourceFile.resolvePath("AIR Test/test1.txt");
var destination:File = File.documentsDirectory;
destination = destination.resolvePath("Apollo Test/test2.txt");

try  
{
    sourceFile.moveTo(destination, true);
}
catch (error:Error)
{
    trace("Error:" + error.message);
}

Följande kod visar hur du använder metoden moveTo() för att flytta en fil. Den ursprungliga filen är test1.txt i underkatalogen Apollo Test i användarens dokumentkatalog, och metoden flyttar filen till underkatalogen Results. Glöm inte att skapa en fil som heter test1.txt i underkatalogen AIR Test i datorns hemkatalog innan du kör den här koden. Programsatserna try och catch visar hur fel ska behandlas.
import flash.filesystem.File;

var sourceFile:File = File.documentsDirectory;
sourceFile = sourceFile.resolvePath("AIR Test/test1.txt");
var destination:File = File.documentsDirectory;
destination = destination.resolvePath("AIR Test/Results/test1.txt");

try 
{
    sourceFile.moveTo(destination, true);
}
catch (error:Error)
{
    trace("Error:" + error.message);
}

    moveToAsync

()metod 
public function moveToAsync(newLocation:FileReference, overwrite:Boolean = false):void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Startar flyttning av filen eller katalogen på den plats som anges av det här File-objektet, till den plats som anges av newLocation-parametern.

Om du vill byta namn på en fil anger du parametern destination så att den pekar på en sökväg i filens katalog, men med ett annat filnamn.

Flyttningen skapar alla nödvändiga överordnade kataloger (om möjligt).

Parametrar

newLocation:FileReference — Målet för flyttningen. Det här objektet anger sökvägen till den slutliga (flyttade) filen eller katalogen, och inte sökvägen till den överordnade katalogen.
 
overwrite:Boolean (default = false) — Om värdet är false misslyckas flyttningen om target-filen redan finns. Om värdet är true skriver åtgärden över alla befintliga filer eller kataloger med samma namn.


Händelser
complete:Event — Skickas när filen eller katalogen har flyttats.
 
ioError:IOErrorEvent — Källan existerar inte eller målet finns och overwrite är false, eller också gick det inte att flytta källan till målet, eller också refererar källan och målet till samma fil eller mapp och overwrite är angivet till true. I Windows kan du inte flytta en öppen fil eller en katalog som innehåller en öppen fil.

Utlöser
SecurityError — Programmet har inte den behörighet som krävs för att flytta filen.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Följande kod visar hur du använder metoden moveToAsync() för att byta namn på en fil. Det ursprungliga filnamnet är test1.txt och det nya namnet är test2.txt. Eftersom File-objektet för både källa och mål pekar på samma katalog (underkatalogen Apollo Test i användarens dokumentkatalog) byter metoden moveToAsync() namn på filen (i stället för att flytta den till en annan katalog). Glöm inte att skapa en fil som heter test1.txt i underkatalogen Apollo Test i datorns dokumentkatalog innan du kör den här koden. När du anger parametern overwrite som true skriver åtgärden över befintliga filer med namnet test2.txt.
import flash.filesystem.File;
import flash.events.Event;

var sourceFile:File = File.documentsDirectory;
sourceFile = sourceFile.resolvePath("Apollo Test/test1.txt");
var destination:File = File.documentsDirectory;
destination = destination.resolvePath("Apollo Test/test2.txt");

sourceFile.moveToAsync(destination, true);
sourceFile.addEventListener(Event.COMPLETE, fileMoveCompleteHandler);

function fileMoveCompleteHandler(event:Event):void 
{
    trace("Done.")
}

    moveToTrash

()metod 
public function moveToTrash():void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Flyttar filen eller katalogen till papperskorgen.

Obs! På operativsystem som saknar stöd för en återställningsbar papperskorg tas filerna bort direkt.


Utlöser
IOError — Operativsystemet tillåter inte åtgärden, eller också finns inte filen eller katalogen. I Windows kan du inte flytta en öppen fil eller en katalog som innehåller en öppen fil.
 
SecurityError — Programmet har inte den behörighet som krävs för att flytta filen till papperskorgen.

Relaterade API-element

    moveToTrashAsync

()metod 
public function moveToTrashAsync():void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Flyttar filen eller katalogen till papperskorgen asynkront.

Obs! På operativsystem som saknar stöd för en återställningsbar papperskorg tas filerna bort direkt.


Händelser
ioError:IOErrorEvent — Operativsystemet tillåter inte åtgärden, eller också finns inte filen eller katalogen. I Windows kan du inte flytta en öppen fil eller en katalog som innehåller en öppen fil.
 
complete:Event — Skickas när filen eller katalogen har flyttats till papperskorgen.

Utlöser
SecurityError — Programmet har inte den behörighet som krävs för att flytta filen till papperskorgen.

Relaterade API-element

    openWithDefaultApplication

()metod 
public function openWithDefaultApplication():void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 2

Öppnar filen med det program som har registrerats i operativsystemet för den här filtypen.

AIR förhindrar att vissa filer öppnas med metoden File.openWithDefaultApplication(). I Windows förhindrar AIR att du öppnar vissa typer av filer (filer med specifika filtillägg, se nedan). I Mac OS och Linux kan du inte öppna filer som startar i ett visst program med AIR, vilket anges nedan. Ett undantag genereras om du försöker öppna en sådan fil med openWithDefaultApplication()-metoden. AIR-program som installerats med ett inbyggt installationsprogram (program med utökad skrivbordsprofil) underkastas inte sådana begränsningar, de kan öppna alla filtyper.

Du kan inte öppna dokument från programkatalogen.

Tabellen nedan anger filtilläggen som inte tillåts i Windows samt programmen som inte tillåts i Mac OS och Linux:

Filtillägg för Windows-dokument Typ Motsvarande Mac OS-program Motsvarande Linux-program
bat Batch-kommandofil Terminal Inget standardprogram
cmd DOS- och Windows-kommandofil Terminal Inget standardprogram
com Kommando Terminal Inget standardprogram
csh UNIX csh skalskript Terminal /bin/csh
dash UNIX dash skalskript Terminal /bin/dash
ksh UNIX ksh skalskript Terminal /bin/ksh
sh UNIX skalskript Terminal /bin/bash
tcsh UNIX tcsh skalskript Terminal /bin/tcsh
zsh UNIX zsh skalskript Terminal /bin/zsh
exe Körbar fil Körbar bit med filtillägget .app /lib/ld.so
lnk Windows genvägsfil Körbar bit med filtillägget .app Länkar i Linux, körbar bit inställd, inget standardprogram
pif Programinformationsfil Körbar bit med filtillägget .app Ej tillämpligt
reg Registreringsinformation/nyckel för Windows registerdatafil Ej tillämpligt Ej tillämpligt
scf Windows Utforskar-kommando ScriptEditor, AutomatorRunner Ej tillämpligt
shb, shs Shell Scrap-objektfil Ej tillämpligt Ej tillämpligt
prg Programfil Ej tillämpligt Ej tillämpligt
vb, vbe, vbs VBScript-filer Ej tillämpligt Ej tillämpligt
vsmacros Visual Studio .NET binärt baserade makroprojekt Ej tillämpligt Ej tillämpligt
ws, wsc, wsf, wsh Windows skriptfiler ScriptEditor, AutomatorRunner Ej tillämpligt
fxp Fox Pro kompilerad källkod Ej tillämpligt Ej tillämpligt
mas Microsoft Access lagrade procedurer Ej tillämpligt Ej tillämpligt
scr Windows skärmsläckare Ej tillämpligt Ej tillämpligt
py, pyc Python skriptfil Python Python
pl Perl skriptfil Terminal perl
cgi Common Gateway Interface skriptfil Terminal perl
msi, msm, msp, mst, idt, cub, pcp Windows installationsfiler installationsprogram Ej tillämpligt
job Windows Schemaläggaren aktivitetsobjekt Ej tillämpligt Ej tillämpligt
jar, js, jse Java-arkivfil, JavaScript-fil, JScript-kodad skriptfil JarLauncher jar
url Internet-genväg Ej tillämpligt Ej tillämpligt
hta HTML-program Ej tillämpligt Ej tillämpligt

Endast Mac OS X Typ Mac OS X-program Motsvarande Linux-program
Ej tillämpligt Mac OS X Java-applet AppletLauncher Ej tillämpligt
Ej tillämpligt Mac OS X AppleScript-plugin systemevents Ej tillämpligt
Ej tillämpligt Mac OS X-widget dock, dashboardlauncher Ej tillämpligt

Dokumenttillägg, endast Linux Typ Motsvarande Mac OS X-program Linux-program
rb Ruby skalskript Ej tillämpligt ruby
desktop Skrivbordsfiler och genvägar Ej tillämpligt Inget standardprogram
directory Katalogfiler och genvägar Ej tillämpligt Inget standardprogram


Utlöser
Error — (Mac OS och Linux) Inga program hittades som kan användas för att öppna filen. (I Windows kommer försök att öppna en fil som inte har något associerat program att misslyckas utan att något märks, utan undantag.)
 
IllegalOperationError — Filen finns i programkatalogen eller så har den en filtyp som inte tillåts. Det här felet gäller inte AIR-program som installerats med ett inbyggt installationsprogram (utökade skrivbordsprofilprogram).
 
IOError — Filen finns inte eller ett program är inte registrerat som kan öppna filen.
 
ReferenceError — Filen finns inte.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

Med följande kod kan en användare navigera till en MP3-fil och öppna den i standardprogrammet för uppspelning av MP3-filer.
import flash.filesystem.File;
import flash.net.FileFilter;

var file:File = File.documentsDirectory; 
var mp3Filter:FileFilter = new FileFilter("MP3 Files", "*.mp3"); 
file.browseForOpen("Open", [mp3Filter]); 
file.addEventListener(Event.SELECT, fileSelected); 
 
function fileSelected(e:Event):void 
{ 
    file.openWithDefaultApplication(); 
}

    requestPermission

()metod 
override public function requestPermission():void

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 24.0

Begär åtkomst till filsystemet.


Händelser
PermissionStatus:PermissionEvent — skickas när begärd behörighet beviljas/nekas av användaren.

    resolvePath

()metod 
public function resolvePath(path:String):File

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Skapar ett nytt File-objekt med en sökväg som är relativ till sökvägen för det här File-objektet, baserat på path-parametern (en sträng).

Du kan använda en relativ sökväg eller en absolut sökväg med path-parametern.

Om du specificerar en relativ sökväg, läggs path till filobjektets sökväg. Men om ”..” används i path kan detta returnera en slutlig sökväg, som inte är underordnad File-objektet. Den slutliga referensen behöver inte referera till en faktisk plats i filsystemet.

Om du specificerar en absolut filreferens returnerar metoden det filobjekt som pekar på sökvägen. Den absoluta filreferensen ska använda en giltig inbyggd sökvägssyntax för användarens operativsystem (till exempel "C:\\test" i Windows). Använd inte en URL (till exempel "file:///c:/test") som path-parameter.

Alla slutliga sökvägar normaliseras enligt följande:

  • Alla "." -element ignoreras.
  • Alla ".." -element inkluderar den överordnade posten.
  • Inga ".." -referenser som når filsystemets rot eller den permanenta programlagringsroten passerar noden; de ignoreras.

Du bör alltid använda vanligt snedstreck (/) som sökvägsavgränsare. I Windows kan du även använda ett bakåtlutande snedstreck (\), men du bör inte göra det. Om du använder ett bakåtlutande snedstreck kan det göra att programmen inte fungerar på andra plattformar.

Filnamn och katalognamn är skiftlägeskänsliga i Linux.

Parametrar

path:String — Sökvägen som ska läggas till det här File-objektets sökväg (om path-parametern är en relativ sökväg) eller sökvägen som ska returneras (om path-parametern är en absolut sökväg).

Returnerar
File — Ett nytt File-objekt pekar på slutlig sökväg.
Händelsedetaljer
    

cancel

Händelse
Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.CANCEL

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Skickas när en väntande asynkron åtgärd avbryts.

Event.CANCEL-konstanten definierar värdet på type-egenskapen i ett cancel-händelseobjekt.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetEn referens till det objekt vars åtgärd avbryts.
    

complete

Händelse  
Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.COMPLETE

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Skickas när en asynkron åtgärd har slutförts.

Event.COMPLETE-konstanten definierar värdet på type-egenskapen i ett complete-händelseobjekt.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetDet nätverksobjekt som har lästs in.
    

directoryListing

Händelse  
Typ av händelseobjekt: flash.events.FileListEvent
egenskap FileListEvent.type = flash.events.FileListEvent.DIRECTORY_LISTING

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Skickas när det finns en kataloglista som resultat av ett anrop till metoden getDirectoryListingAsync().

FileListEvent.DIRECTORY_LISTING-konstanten definierar värdet på type-egenskapen i ett directoryListing-händelseobjekt.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
filerEn array med File-objekt som representerar de filer och kataloger som har hittats.
targetFileListEvent-objektet.

Relaterade API-element

    

ioError

Händelse  
Typ av händelseobjekt: flash.events.IOErrorEvent
egenskap IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Skickas när ett fel inträffar under en asynkron filåtgärd.

Definierar värdet för ett ioError-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
errorIDEtt referensnummer som associeras med det specifika felet (enbart AIR).
targetObjektet är med om ett in-/utdatafel.
textText som visas som felmeddelande.
    

permissionStatus

Händelse  
Typ av händelseobjekt: flash.events.PermissionEvent
egenskap PermissionEvent.type = flash.events.PermissionEvent.PERMISSION_STATUS

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 24.0

Skickas när programmet begär åtkomst till filsystemet. Kontrollera värdet för egenskapen status för att avgöra om behörighet beviljades eller nekades

Relaterade API-element

    

securityError

Händelse  
Typ av händelseobjekt: flash.events.SecurityErrorEvent
egenskap SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Skickas när en åtgärd strider mot en säkerhetsbegränsning.

Konstanten SecurityErrorEvent.SECURITY_ERROR definierar värdet för ett securityError-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetNätverksobjektet rapporterar säkerhetsfelet.
textText som visas som felmeddelande.
    

select

Händelse  
Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.SELECT

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Skickas när användaren väljer en fil eller katalog i en dialogruta för fil- eller katalogbläddring.

Event.SELECT-konstanten definierar värdet på type-egenskapen i ett select-händelseobjekt.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetObjektet för vilket ett objekt har valts.
    

selectMultiple

Händelse  
Typ av händelseobjekt: flash.events.FileListEvent
egenskap FileListEvent.type = flash.events.FileListEvent.SELECT_MULTIPLE

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0

Skickas när användaren väljer filer i dialogrutan som öppnas av ett anrop till browseForOpenMultiple()-metoden.

FileListEvent.SELECT_MULTIPLE-konstanten definierar värdet på type-egenskapen i ett selectMultiple-händelseobjekt.
EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
filerEn array med File-objekt representerar de filer som har valts.
targetFileListEvent-objektet.

Relaterade API-element





[ X ]Varför på engelska?
Innehåll i Referenshandbok för ActionScript 3.0 i Adobe Flash-plattformen är på engelska

Det är inte alla delar av Referenshandbok för ActionScript 3.0 i Adobe Flash-plattformen som översätts till alla språk. Om ett språkelement inte översätts visas det på engelska. Klassen ga.controls.HelpBox översätts till exempel inte till något språk. I den svenska versionen av referenshandboken visas därför klassen ga.controls.HelpBox på engelska.