Adobe® Flash® Platform için ActionScript® 3.0 Başvurusu
Ana Sayfa  |  Paket ve Sınıf Listesini Gizle |  Paketler  |  Sınıflar  |  Yenilikler  |  Dizin  |  Ekler  |  Niçin İngilizce?
Filtreler: AIR 30.0 ve öncesi, Flash Player 30.0 ve öncesi, Flash Lite 4
Flex 4.6 ve öncesi, Flash Pro CS6 ve öncesi
Filtreleri Gizle
flash.net 

FileReference  - AS3

Paketlerx

Üst Düzey
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

Dil Öğeleri

Global Sabitler
Global İşlevler
Operatörler
İfadeler, Anahtar Kelimeler ve Direktifler
Özel Türler

Ekler

Yenilikler
Derleyici Hataları
Derleyici Uyarıları
Çalışma Zamanı Hataları
ActionScript 3'e Geçiş Yapma
Desteklenen Karakter Kümeleri
Yalnızca MXML Etiketleri
Motion XML Öğeleri
Timed Text Etiketleri
Onaylanmamış öğelerin listesi
Erişilebilirlik Uygulaması Sabitleri
ActionScript Örnekleri Nasıl Kullanılır?
Yasal uyarılar
Paketflash.net
Sınıfpublic class FileReference
Miras AlmaFileReference Inheritance EventDispatcher Inheritance Object
Alt Sınıflar File

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

FileReference sınıfı kullanıcının bilgisayarı ile sunucu arasında dosya yükleme ve indirme olanakları sağlar. Bir işletim sistemi iletişim kutusu, kullanıcıdan bir yüklemek için bir dosya veya indirmek için bir konum seçmesini ister. Her FileReference nesnesi, kullanıcını diski üzerindeki tek bir dosyaya karşılık gelir ve dosyanın boyutu, türü, adı, oluşturma tarihi, değiştirme tarihi ve oluşturan türü (yalnızca Macintosh'ta) hakkında bilgi içeren özelliklere sahiptir.

Not: Adobe AIR'de, FileReference sınıfını genişleten File sınıfı, daha fazla yetenek sağlar ve FileReference sınıfından daha az güvenlik kısıtlamasına sahiptir.

FileReference örnekleri şu şekillerde oluşturulur:

  • FileReference yapıcısıyla birlikte new operatörünü kullandığınızda: var myFileReference = new FileReference();
  • FileReference nesnelerinin bir dizisini oluşturan FileReferenceList.browse() yöntemini çağırdığınızda.

Bir yükleme işlemi sırasında, bir FileReference nesnesinin tüm özellikleri FileReference.browse() veya FileReferenceList.browse() yöntemlerine yapılan çağrılarla doldurulur. Bir indirme işlemi sırasında, select olayı gönderildiğinde name özelliği doldurulur; tüm diğer özellikler complete olayı gönderildiğinde doldurulur.

browse() yöntemi, kullanıcıdan yükleme için bir dosya seçmesini isteyen bir işletim sistemi iletişim kutusunu açar. FileReference.browse() yöntemi kullanıcının tek bir dosya seçmesini sağlar; FileReferenceList.browse() yöntemi kullanıcının birden fazla dosya seçmesini sağlar. browse() yöntemine yapılan başarılı bir çağrıdan sonra, bir seferde bir dosya yüklemek için FileReference.upload() yöntemini kullanın. FileReference.download() yöntemi, kullanıcıdan dosyayı kaydedecek bir konum belirlemesini ister ve uzak URL'den indirmeye başlar.

FileReference ve FileReferenceList sınıfları, browse() veya download() yöntemlerinin oluşturduğu iletişim kutusu için varsayılan dosya konumu ayarlamanıza izin vermez. İletişim kutusunda gösterilen varsayılan konum, belirlenebilmesi durumunda en son gözatılan klasördür veya masaüstüdür. Sınıflar, aktarılan dosyayı okumanıza veya dosyaya yazmanıza izin vermez. Yükleme veya indirme işlemini başlatan SWF dosyasının, yüklenen veya indirilen dosyaya veya dosyanın kullanıcının diski üzerindeki konumuna erişmesine izin vermez.

FileReference ve FileReferenceList sınıfları ayrıca kimlik doğrulamaya yönelik yöntemler sağlamaz. Kimlik doğrulama gerektiren sunucularda Flash® Player tarayıcı eklentisini kullanarak dosyaları indirebilirsiniz, ancak yükleme (tüm oynatıcılarda) ve indirme (tek başına çalışabilen veya harici oynatıcıda) başarısız olur. İşlemlerin başarılı bir şekilde gerçekleştirilip gerçekleştirilmediğini belirlemek ve hataları işlemek için FileReference olaylarını dinleyin.

Flash Player'da çalışan içerik için veya uygulama güvenlik sanal alanı dışında Adobe AIR'de çalışan içerik için yükleme ve indirme işlemleri yalnızca kendi etki alanındaki ve bir URL ilke dosyasının belirttiği etki alanlarındaki dosyalara erişebilir. Yükleme veya indirme işlemini başlatan içerik, dosya sunucusuyla aynı etki alanından gelmiyorsa dosya sunucusu üzerine bir ilke dosyası yerleştirin.

Flash Player'a eklenen yeni işlevler nedeniyle, Flash Player 10'a yayın yapılırken aynı anda şu işlemlerden yalnızca birinin etkin olacağını unutmayın: FileReference.browse(), FileReference.upload(), FileReference.download(), FileReference.load(), FileReference.save(). Aksi takdirde, Flash Player bir çalışma zamanı hatası (kod 2174) atar. Devam eden bir işlemi durdurmak için FileReference.cancel() öğesini kullanın. Bu kısıtlama yalnızca Flash Player 10 için geçerlidir. Önceki Flash Player sürümleri, eşzamanlı birden çok işlem üzerindeki bu kısıtlamadan etkilenmez.

FileReference.browse(), FileReferenceList.browse() veya FileReference.download() yöntemlerine yapılan çağrılar yürütülürken, Linux ve Mac OS X 10.1 ve daha öncesi için tek başına çalışabilen ve harici Flash Player ve AIR sürümlerinde SWF dosya yürütmesi duraklar.

Herhangi bir parametre belirtilmezse, şu örnek HTTP POST isteği Flash Player'dan sunucu tarafındaki bir komut dosyasına gönderilir:

  POST /handler.cfm HTTP/1.1 
  Accept: text/*
  Content-Type: multipart/form-data; 
  boundary=----------Ij5ae0ae0KM7GI3KM7 
  User-Agent: Shockwave Flash 
  Host: www.example.com 
  Content-Length: 421 
  Connection: Keep-Alive 
  Cache-Control: no-cache
  
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="Filename"
  
  MyFile.jpg
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="Filedata"; filename="MyFile.jpg"
  Content-Type: application/octet-stream
  
  FileDataHere
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="Upload"
  
  Submit Query
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7--
  

Kullanıcı "api_sig", "api_key" ve "auth_token" parametrelerini belirtirse, Flash Player şu HTTP POST isteğini gönderir:

  POST /handler.cfm HTTP/1.1 
  Accept: text/*
  Content-Type: multipart/form-data; 
  boundary=----------Ij5ae0ae0KM7GI3KM7 
  User-Agent: Shockwave Flash 
  Host: www.example.com 
  Content-Length: 421 
  Connection: Keep-Alive 
  Cache-Control: no-cache
  
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="Filename"
  
  MyFile.jpg
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="api_sig"
  
  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="api_key"
  
  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="auth_token"
  
  XXXXXXXXXXXXXXXXXXXXXX
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="Filedata"; filename="MyFile.jpg"
  Content-Type: application/octet-stream
  
  FileDataHere
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="Upload"
  
  Submit Query
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7--
  

Örnekleri görüntüle

İlgili API Öğeleri



Genel Özellikler
 ÖzellikTanımlayan:
 Inheritedconstructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.
Object
  creationDate : Date
[salt okunur] Yerel diskteki dosyanın oluşturulma tarihi.
FileReference
  creator : String
[salt okunur] Yalnızca Mac OS X öncesindeki Mac OS sürümlerinde kullanılan dosyanın Macintosh oluşturan türü.
FileReference
  data : ByteArray
[salt okunur] load() yöntemine yapılan başarılı bir çağrıdan sonra yüklenen dosyada bulunan verileri temsil eden ByteArray nesnesi.
FileReference
      extension : String
[salt okunur] Dosya adı uzantısı.
FileReference
  modificationDate : Date
[salt okunur] Yerel diskteki dosyanın son değiştirilme tarihi.
FileReference
  name : String
[salt okunur] Yerel diskteki dosyanın adı.
FileReference
      permissionStatus : String
[statik] [salt okunur] Uygulamaya dosya sistemi erişiminin verilip verilmediğini belirler.
FileReference
  size : Number
[salt okunur] Yerel diskteki dosyanın bayt olarak boyutu.
FileReference
  type : String
[salt okunur] Dosya türü.
FileReference
Genel Yöntemler
 YöntemTanımlayan:
  
Yeni bir FileReference nesnesi oluşturur.
FileReference
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder.
EventDispatcher
  
browse(typeFilter:Array = null):Boolean
Kullanıcının yüklenecek bir dosya seçmesini sağlayan bir dosya gözatma iletişim kutusu görüntüler.
FileReference
  
Bu FileReference nesnesi üzerinde devam eden yükleme veya indirme işlemlerini iptal eder.
FileReference
 Inherited
Olay akışına bir olay gönderir.
EventDispatcher
  
download(request:URLRequest, defaultFileName:String = null):void
Kullanıcının uzak bir sunucudan dosya indirmesini sağlayan bir iletişim kutusu açar.
FileReference
 Inherited
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder.
EventDispatcher
 Inherited
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.
Object
 Inherited
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.
Object
  
Kullanıcı tarafından seçilen yerel dosyanın yüklenmesini başlatır.
FileReference
 Inherited
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher nesnesinden bir dinleyiciyi kaldırır.
EventDispatcher
  
Dosya sistemine erişim ister.
FileReference
  
save(data:*, defaultFileName:String = null):void
Kullanıcının dosyayı yerel dosya sistemine kaydetmesini sağlayan bir iletişim kutusu açar.
FileReference
 Inherited
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.
Object
 Inherited
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.
Object
 Inherited
Belirtilen nesnenin dize olarak temsil edilen halini döndürür.
Object
  
upload(request:URLRequest, uploadDataFieldName:String = "Filedata", testUpload:Boolean = false):void
Dosyanın uzak bir sunucuya yüklenme işlemini başlatır.
FileReference
  
Kodlama olmadan bir URL'ye dosya yüklemesini başlatır.
FileReference
 Inherited
Belirtilen nesnenin temel değerini döndürür.
Object
 Inherited
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder.
EventDispatcher
Olaylar
 Olay Özet Tanımlayan:
 Inherited[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir.EventDispatcher
  Dosya yükleme veya indirme işlemi, kullanıcı tarafından dosya gözatma iletişim kutusu üzerinden iptal edildiğinde gönderilir.FileReference
  İndirme tamamlandığında veya sunucuya yükleme işlemi HTTP durum kodu 200 verdiğinde gönderilir.FileReference
 Inherited[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.EventDispatcher
  upload() veya uploadUnencoded() yöntemine yapılan bir çağrı HTTP üzerinden verilere erişmeye çalışıyorsa ve Adobe AIR, istek için durum kodunu algılayıp döndürebiliyorsa gönderilir.FileReference
  Sunucuya yükleme işlemi başarısız olduğunda ve hatayı tanımlayan bir HTTP durum kodu bulunduğunda gönderilir.FileReference
  Sunucuya yükleme veya sunucudan indirme işlemi başarısız olduğunda gönderilir.FileReference
  Sunucuya yükleme veya sunucudan indirme işlemi başladığında gönderilir.FileReference
  Uygulama, dosya sistemine erişim izni istediğinde gönderilir.FileReference
  Sunucuya dosya yükleme veya sunucudan dosya indirme işlemi sırasında düzenli aralıklarla gönderilir.FileReference
  FileReference.upload() veya FileReference.download() yöntemine yapılan bir çağrı sunucuya bir dosya yüklemeye çalıştığında veya çağıranın güvenlik sanal alanının dışındaki bir dosyayı sunucudan almaya çalıştığında gönderilir.FileReference
  Kullanıcı, sunucuya yüklemek veya sunucudan indirmek için, dosyaya gözatma iletişim kutusundan dosya seçtiğinde gönderilir.FileReference
  Sunucuya yapılan başarılı bir yükleme işleminin ardından veri alındığında gönderilir.FileReference
Özellik Ayrıntısı

creationDate

özellik
creationDate:Date  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Yerel diskteki dosyanın oluşturulma tarihi. Nesne doldurulmadıysa, bu özelliğin değerini almak için yapılan bir çağrı null değerini döndürür.

Not: Bir işletim sisteminde özellik olarak creationDate yoksa, böyle durumlarda CreationDate ile lastModifiedDate değeri eşittir.



Uygulama
    public function get creationDate():Date

Atar
IllegalOperationError FileReference.browse(), FileReferenceList.browse() veya FileReference.download() yöntemi başarılı olarak çağrılmamışsa, işlevlerin yanlış sırada çağrıldığını veya önceki bir çağrının başarısız olduğunu gösteren bir mesajla birlikte bir istisna atılır. Bu durumda, creationDate özelliğinin değeri null olur.
 
IOError — Bilgilere erişilemezse, dosya G/Ç hatasını gösteren bir mesajla birlikte bir istisna atılır.

İlgili API Öğeleri

creator

özellik 
creator:String  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Yalnızca Mac OS X öncesindeki Mac OS sürümlerinde kullanılan dosyanın Macintosh oluşturan türü. Windows ve Linux'ta bu null değerindedir. FileReference nesnesi doldurulmadıysa, bu özelliğin değerini almak için yapılan bir çağrı null değerini döndürür.



Uygulama
    public function get creator():String

Atar
IllegalOperationError — Macintosh'ta FileReference.browse(), FileReferenceList.browse() veya FileReference.download() yöntemi başarılı olarak çağrılmamışsa, işlevlerin yanlış sırada çağrıldığını veya önceki bir çağrının başarısız olduğunu gösteren bir mesajla birlikte bir istisna atılır. Bu durumda creator özelliğinin değeri null olur.

İlgili API Öğeleri

data

özellik 
data:ByteArray  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: Flash Player 10, AIR 1.5

load() yöntemine yapılan başarılı bir çağrıdan sonra yüklenen dosyada bulunan verileri temsil eden ByreArray nesnesi.



Uygulama
    public function get data():ByteArray

Atar
IllegalOperationError load() yöntemi başarılı olarak çağrılmamışsa, işlevlerin yanlış sırada çağrıldığını veya önceki bir çağrının başarısız olduğunu gösteren bir mesajla birlikte bir istisna atılır. Bu durumda, data özelliğinin değeri null olur.
 
IOError — Dosya açılamazsa veya okunamazsa veya dosyaya erişim sırasında benzer bir hatayla karşılaşılırsa dosya G/Ç hatasını gösteren bir mesajla birlikte bir istisna atılır. Bu durumda, data özelliğinin değeri null olur.

İlgili API Öğeleri

    

extension

özellik 
extension:String  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0

Dosya adı uzantısı.

Dosyanın uzantısı, ismin en sondaki noktadan (".") sonra gelen (son nokta hariç) bölümüdür. Dosya adında nokta yoksa, uzantı null değerindedir.

Not: Dosyanın türünü belirlemek için extension özelliğini kullanmanız gerekir; creator veya type özelliklerini kullanmayın. creator ve type özelliklerinin onaylanmadığını unutmamalısınız. Bunlar eski Mac OS sürümleri için geçerlidir.



Uygulama
    public function get extension():String

Atar
IllegalOperationError — Başvuru başlatılmazsa.

modificationDate

özellik 
modificationDate:Date  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9, Flash Player 9

Yerel diskteki dosyanın son değiştirilme tarihi. FileReference nesnesi doldurulmadıysa, bu özelliğin değerini almak için yapılan bir çağrı null değerini döndürür.



Uygulama
    public function get modificationDate():Date

Atar
IllegalOperationError FileReference.browse(), FileReferenceList.browse() veya FileReference.download() yöntemi başarılı olarak çağrılmamışsa, işlevlerin yanlış sırada çağrıldığını veya önceki bir çağrının başarısız olduğunu gösteren bir mesajla birlikte bir istisna atılır. Bu durumda modificationDate özelliğinin değeri null olur.
 
IOError — Bilgilere erişilemezse, dosya G/Ç hatasını gösteren bir mesajla birlikte bir istisna atılır.

İlgili API Öğeleri

name

özellik 
name:String  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Yerel diskteki dosyanın adı. FileReference nesnesi doldurulmamışsa (FileReference.download() veya FileReference.browse() öğesine yapılan geçerli bir çağrıyla), bu özelliğin değerini almaya çalıştığınızda Flash Player bir hata atar.

Bir FileReference nesnesinin tüm özellikleri browse() yöntemi çağrılarak doldurulur. Diğer FileReference özelliklerinin aksine download() yöntemini çağırırsanız, select olayı gönderildiğinde name özelliği doldurulur.



Uygulama
    public function get name():String

Atar
IllegalOperationError FileReference.browse(), FileReferenceList.browse() veya FileReference.download() yöntemi başarılı olarak çağrılmamışsa, işlevlerin yanlış sırada çağrıldığını veya önceki bir çağrının başarısız olduğunu gösteren bir mesajla birlikte bir istisna atılır.

İlgili API Öğeleri

    

permissionStatus

özellik 
permissionStatus:String  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 24.0

Uygulamaya dosya sistemi erişiminin verilip verilmediğini belirler.



Uygulama
    public static function get permissionStatus():String

İlgili API Öğeleri

size

özellik 
size:Number  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Yerel diskteki dosyanın bayt olarak boyutu.

Not: İlk ActionScript 3.0 sürümünde size özelliği, 4 GB'a kadar boyuta sahip dosyaları destekleyen bir uint nesnesi olarak tanımlanmıştı. Şimdi ise daha büyük dosyaları desteklemek için bir Number nesnesi olarak uygulanır.



Uygulama
    public function get size():Number

Atar
IllegalOperationError FileReference.browse(), FileReferenceList.browse() veya FileReference.download() yöntemi başarılı olarak çağrılmamışsa, işlevlerin yanlış sırada çağrıldığını veya önceki bir çağrının başarısız olduğunu gösteren bir mesajla birlikte bir istisna atılır.
 
IOError — Dosya açılamazsa veya okunamazsa veya dosyaya erişim sırasında benzer bir hatayla karşılaşılırsa dosya G/Ç hatasını gösteren bir mesajla birlikte bir istisna atılır.

İlgili API Öğeleri

type

özellik 
type:String  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Dosya türü.

Windows veya Linux'ta, bu özellik dosya uzantısıdır. Macintosh'ta bu özellik yalnızca Mac OS X öncesindeki Mac OS sürümlerinde kullanılan dört karakterli dosya türüdür. FileReference nesnesi doldurulmazsa, bu özelliğin değerini almak için yapılan bir çağrı null değerini döndürür.

Windows, Linux ve Mac OS X için dosya uzantısı — noktanın (.) en son bulunduğu yerden sonra gelen name özelliği karakter — dosya türünü tanımlar.



Uygulama
    public function get type():String

Atar
IllegalOperationError FileReference.browse(), FileReferenceList.browse() veya FileReference.download() yöntemi başarılı olarak çağrılmamışsa, işlevlerin yanlış sırada çağrıldığını veya önceki bir çağrının başarısız olduğunu gösteren bir mesajla birlikte bir istisna atılır. Bu durumda, type özelliğinin değeri null olur.

İlgili API Öğeleri

Yapıcı Ayrıntı

FileReference

()Yapıcı
public function FileReference()

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Yeni bir FileReference nesnesi oluşturur. Bir FileReference nesnesi doldurulduğunda, kullanıcının yerel diski üzerindeki bir dosyayı temsil eder.

İlgili API Öğeleri

Yöntem Ayrıntısı

browse

()yöntem
public function browse(typeFilter:Array = null):Boolean

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Kullanıcının yüklenecek bir dosya seçmesini sağlayan bir dosya gözatma iletişim kutusu görüntüler. İletişim kutusu, kullanıcının işletim sistemi için yereldir. Kullanıcı yerel bilgisayar üzerinden veya Windows'daki bir UNC yaması gibi başka sistemler üzerinden bir dosya seçebilir.

Not: Adobe AIR'de kullanılabilen File sınıfı, daha belirli sistem dosyası seçim iletişim kutularına erişme yöntemleri içerir. Bu yöntemler şunlardır: File.browseForDirectory(), File.browseForOpen(), File.browseForOpenMultiple() ve File.browseForSave().

Bu yöntemi çağırdığınızda ve kullanıcı başarılı bir şekilde dosya seçtiğinde, bu FileReference nesnesinin özellikleri o dosyanın özellikleriyle doldurulur. FileReference.browse() yöntemi daha sonra her çağrıldığında, FileReference nesnesinin özellikleri, kullanıcının iletişim kutusunda seçtiği dosyanın özelliklerine sıfırlanır. Aynı anda yalnızca bir browse() veya download() oturumu gerçekleştirilebilir (aynı anda yalnızca bir iletişim kutusu çağrılabildiğinden).

typeFilter parametresini kullanarak iletişim kutusunda hangi dosyaların görüntüleneceğini belirleyebilirsiniz.

Flash Player 10 ve Flash Player 9 Güncelleme 5'te, bir kullanıcı olayına (örneğin, fare tıklatması veya tuş basışı olayı için bir olay işleyicisinde) yanıt olarak bu yöntemi başarıyla çağırabilirsiniz. Aksi halde, bu yöntemin çağrılması Flash Player'ın bir Error istisnası atmasına neden olur.

Flash Player'a eklenen yeni işlevler nedeniyle, Flash Player 10'a yayın yapılırken aynı anda şu işlemlerden yalnızca birinin etkin olacağını unutmayın: FileReference.browse(), FileReference.upload(), FileReference.download(), FileReference.load(), FileReference.save(). Aksi takdirde, Flash Player bir çalışma zamanı hatası (kod 2174) atar. Devam eden bir işlemi durdurmak için FileReference.cancel() öğesini kullanın. Bu kısıtlama yalnızca Flash Player 10 için geçerlidir. Önceki Flash Player sürümleri, eşzamanlı birden çok işlem üzerindeki bu kısıtlamadan etkilenmez.

Adobe AIR uygulamasında dosyaya göz atma iletişim kutusu her zaman başka bir pencerenin "sahip olduğu" pencerelerin (null değerinde olmayan bir owner özelliğine sahip pencerelerin) önünde görüntülenmez. Pencere sıralama sorunlarını önlemek için, bu yöntemi çağırmadan önce sahip olunan pencereleri gizleyin.

Parametreler

typeFilter:Array (default = null) — İletişim kutusunda görüntülenen dosyaları filtrelemek için kullanılan bir FileFilter örnekleri dizisi. Bu parametreyi atlarsanız, tüm dosyalar görüntülenir. Daha fazla bilgi için FileFilter sınıfına bakın.

Döndürür
Boolean — Parametreler geçerliyse ve dosya gözatma iletişim kutusu açılırsa true değerini döndürür.

Olaylar
select:Event — Kullanıcı Gözat dosya seçme kutusundan başarılı bir şekilde bir öğe seçtiğinde gönderilir.
 
cancel:Event — Kullanıcı, dosya yükleme Gözat penceresini iptal ettiğinde gönderilir.

Atar
IllegalOperationError — Şu durumlarda atılır: 1) Başka bir FileReference veya FileReferenceList gözatma oturumu devam ederken; bir seferde yalnızca bir dosya gözatma oturumu gerçekleştirilebilirken. 2) Kullanıcının mms.cfg dosyasındaki bir ayar bu işlemi yasakladığında.
 
ArgumentError typeFilter dizisi, düzgün biçimde biçimlendirilmemiş FileFilter nesneleri içeriyorsa bir istisna atılır. Doğru FileFilter nesnesi biçimleri hakkında bilgi için FileFilter sınıfına bakın.
 
Error — Fare olayı veya tuş basışı olayı gibi bir kullanıcı eylemine yanıt olarak yöntem çağrılmazsa.

İlgili API Öğeleri

select olayı
cancel olayı
FileReference.download()
FileReferenceList.browse()
File.browseForDirectory()
File.browseForOpen()
File.browseForOpenMultiple()
File.browseForSave()

cancel

()yöntem 
public function cancel():void

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Bu FileReference nesnesi üzerinde devam eden yükleme veya indirme işlemlerini iptal eder. Bu yöntemi çağırırsanız cancel olayı gönderilmez; bu olay yalnızca kullanıcı, dosya yükleme veya indirme iletişim kutusunu kapatarak işlemi iptal ederse gönderilir.

download

()yöntem 
public function download(request:URLRequest, defaultFileName:String = null):void

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Kullanıcının uzak bir sunucudan bir dosya indirmesini sağlayan bir iletişim kutusu açar. Flash Player, yükleyebileceğiniz veya indirebileceğiniz dosyaların boyutuna yönelik bir kısıtlama getirmese de, resmi olarak 100 MB'a kadar olan yükleme ya da indirmeleri destekler.

download() yöntemi ilk olarak, kullanıcıdan bir dosya adı girmesini ve dosyayı kaydetmek için yerel bilgisayar üzerinde bir konum seçmesini isteyen bir işletim sistemi iletişim kutusu açar. Kullanıcı bir konum seçtiğinde ve indirme işlemini onayladığında (örneğin Kaydet'i tıklatarak), uzak sunucundan indirme işlemi başlar. Dinleyiciler, indirme işleminin ilerlemesini, başarılı veya başarısız olduğunu gösteren olaylar alır. download() öğesini çağırdıktan sonra iletişim kutusunun ve indirme işleminin durumunu kesinleştirmek için, kodunuz cancel, open, progress ve complete gibi olayları dinlemelidir.

FileReference.upload() ve FileReference.download() işlevleri tıkanmasızdır. Bu işlevler çağrıldıktan sonra, dosya iletimi tamamlanmadan önce döndürülür. Ayrıca, FileReference nesnesi kapsam dışına çıkarsa, bu nesne üzerindeki henüz tamamlanmamış olan herhangi bir yükleme veya indirme işlemi, kapsam dışına çıkıldığında iptal edilir. Yükleme ve indirme işleminin devam etmesi beklenen süre boyunca FileReference nesnesinin kapsam içinde kaldığından emin olun.

Dosya başarıyla indirildiğinde, FileReference nesnesinin özellikleri, yerel dosyanın özellikleriyle doldurulur. İndirme başarılı olursa complete olayı gönderilir.

Aynı anda yalnızca bir browse() veya download() oturumu gerçekleştirilebilir (aynı anda yalnızca bir iletişim kutusu çağrılabildiğinden).

Bu dosya HTTP veya HTTPS ile olmak üzere herhangi bir dosya türünün indirilmesini destekler.

Ortak olarak ayrılmış bağlantı noktalarına bağlanamazsınız. Engellenen bağlantı noktalarının tam listesi için, bkz. "Ağ İletişimi API'lerini Kısıtlama", ActionScript 3.0 Geliştirici Kılavuzu.

Not: Sunucunuz kimlik doğrulama gerektiriyorsa, yalnızca bir tarayıcıda çalışan SWF dosyaları, yani, tarayıcı eklentisini veya ActiveX denetimini kullanan dosyalar, kimlik doğrulama ve yalnızca indirmeler için kullanıcıdan bir kullanıcı adı ve şifre isteyen bir iletişim kutusu sağlar. Eklenti veya ActiveX denetimini kullanan yüklemelerde veya tek başına çalışabilen ya da harici oynatıcıyı kullanan yüklemelerde ve indirmelerde, dosya aktarımı başarısız olur.

Bu yöntemi kullanırken Flash Player güvenlik modelini göz önünde bulundurun:

  • Çağıran SWF dosyası güvenilmeyen bir yerel sanal alandaysa yükleme işlemlerine izin verilmez.
  • Varsayılan davranış, sanal alanlar arasında erişimi reddetmektir. Bir web sitesi, URL ilke dosyası eklenerek bir kaynağa erişilmesini sağlayabilir.
  • SWF içeriğini barındıran HTML sayfasındaki object veembed etiketlerinin allowNetworking parametresini ayarlayarak bir SWF dosyasının bu yöntemi kullanmasını önleyebilirsiniz.
  • Flash Player 10 ve Flash Player 9 Güncelleme 5'te, bir kullanıcı olayına (örneğin, fare tıklatması veya tuş basışı olayı için bir olay işleyicisinde) yanıt olarak bu yöntemi başarıyla çağırabilirsiniz. Aksi halde, bu yöntemin çağrılması Flash Player'ın bir Error istisnası atmasına neden olur.

Ancak Adobe AIR'de, uygulama güvenlik sanal alanındaki içerik (AIR uygulamasıyla yüklenen içerik) bu güvenlik sınırlamalarıyla kısıtlanmaz.

Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.

Bu yöntemi kullanarak bir dosyayı indirmenizin ardından, indirilen dosyaları bayrakla işaretleyen işletim sistemlerinde dosya, indirildiğinin belirtilmesi için bayrakla işaretlenir:

  • Windows XP servis paketi 2 ve sonrasında ve Windows Vista'da
  • Mac OS 10.5 ve sonrasında

Linux gibi bazı işletim sistemleri, indirilen dosyaları bayrakla işaretlemez.

Flash Player'a eklenen yeni işlevler nedeniyle, Flash Player 10'a yayın yapılırken aynı anda şu işlemlerden yalnızca birinin etkin olacağını unutmayın: FileReference.browse(), FileReference.upload(), FileReference.download(), FileReference.load(), FileReference.save(). Aksi takdirde, Flash Player bir çalışma zamanı hatası (kod 2174) atar. Devam eden bir işlemi durdurmak için FileReference.cancel() öğesini kullanın. Bu kısıtlama yalnızca Flash Player 10 için geçerlidir. Önceki Flash Player sürümleri, eşzamanlı birden çok işlem üzerindeki bu kısıtlamadan etkilenmez.

Adobe AIR uygulamasında, indirme iletişim kutusu her zaman başka bir pencerenin "sahip olduğu" pencerelerin (null değerinde olmayan bir owner özelliğine sahip pencerelerin) önünde görüntülenmez. Pencere sıralama sorunlarını önlemek için, bu yöntemi çağırmadan önce sahip olunan pencereleri gizleyin.

Parametreler

request:URLRequest — URLRequest nesnesi. URLRequest nesnesinin url özelliği, yerel bilgisayara indirilecek dosyanın URL'sini içermelidir. Bu parametre null değerindeyse bir istisna atılır. URLRequest nesnesinin requestHeaders özelliği yok sayılır; yükleme veya indirme işlemlerinde özel HTTP isteği üstbilgileri desteklenmez. POST veya GET parametrelerini sunucuya göndermek için, URLRequest.data değerini parametrelerinize ayarlayın ve URLRequest.method öğesini URLRequestMethod.POST ya da URLRequestMethod.GET öğesine ayarlayın.

Bazı tarayıcılarda URL dizelerinin uzunluğu sınırlıdır. 256 karakterden daha fazla uzunluklar bazı tarayıcılar veya sunucular üzerinde başarısız olabilir.

 
defaultFileName:String (default = null) — İletişim kutusunda indirilecek dosya için görüntülenen varsayılan dosya adı. Bu dize şu karakterleri içermemelidir: / \ : * ? " < > | %

Bu parametreyi atlarsanız, uzak URL'nin dosya adı ayrıştırılır ve varsayılan olarak kullanılır.


Olaylar
open:Event — Bir indirme işlemi başladığında gönderilir.
 
progress:ProgressEvent — Dosya indirme işlemi sırasında düzenli aralıklarla gönderilir.
 
complete:Event — Dosya indirme işlemi başarılı bir şekilde tamamlandığında gönderilir.
 
cancel:Event — Kullanıcı, dosyaya gözatma iletişim kutusundan çıktığında gönderilir.
 
select:Event — Kullanıcı, indirmek için iletişim kutusundan bir dosya seçtiğinde gönderilir.
 
securityError:SecurityErrorEvent — Güvenlik hatası nedeniyle indirme işlemi başarısız olduğunda gönderilir.
 
ioError:IOErrorEvent — Aşağıdaki nedenlerden birinden ötürü gönderilir:
  • Dosya okunurken veya iletilirken bir girdi/çıktı hatası meydana gelmiştir.
  • Flash Player'ın tek başına çalışabilen veya harici sürümlerinde çalışan SWF içeriği, kimlik doğrulama gerektiren bir sunucudan dosya indirmeyi dener. Bağımsız ve harici oynatıcılar, indirme sırasında kullanıcıların şifre girmesi için herhangi bir ortam sağlamaz. Bu oynatıcılardaki bir SWF dosyası, kimlik doğrulama gerektiren bir sunucudan bir dosya indirmeye çalışırsa indirme başarısız olur. Dosya indirmesi yalnızca ActiveX denetimli ve tarayıcı eklentili oynatıcılarda başarılı olabilir.

Atar
IllegalOperationError — Şu durumlarda atılır: 1) Başka bir gözatma oturumu devam ederken; bir seferde yalnızca bir dosya gözatma oturumu gerçekleştirilebilirken. 2) request öğesine iletilen değer geçerli bir yol veya protokol içermediğinde. 3) İndirilecek dosya adı yasaklı karakterler içerdiğinde. 4) Kullanıcının mms.cfg dosyasındaki bir ayar bu işlemi yasakladığında.
 
SecurityError — Güvenilmeyen yerel içerik, İnternet ile iletişim kuramayabilir. Bu durumu önlemek için bu SWF dosyasını ağa sahip yerel veya güvenilir olarak yeniden sınıflandırın. Bu istisna, yerel dosya güvenliği kısıtlamaları nedeniyle erişilemeyen dosya adını ve URL'yi gösteren bir mesajla birlikte atılır.
 
SecurityError — Ortak olarak ayrılmış bağlantı noktalarına bağlanamazsınız. Engellenen bağlantı noktalarının tam listesi için, bkz. "Ağ İletişimi API'lerini Kısıtlama", ActionScript 3.0 Geliştirici Kılavuzu.
 
ArgumentError url.data ByteArray türündeyse bir istisna atılır. FileReference.upload() ve FileReference.download() yöntemleriyle kullanım için, url.data yalnızca URLVariables veya String türünde olabilir.
 
MemoryError — Bu hata şu nedenlerin birinden ötürü meydana gelebilir: 1) Flash Player, URLRequest.data parametresini UTF8'den MBCS'ye dönüştüremiyor. Bu hata, FileReference.download() yöntemine iletilen URLRequest nesnesinin bir GET işlemi gerçekleştirecek şekilde ayarlanması ve System.useCodePage öğesinin true olarak ayarlanması durumunda meydana gelebilir. 2) Flash Player, POST verileri için bellek ayıramaz. Bu hata, FileReference.download() öğesine iletilen URLRequest nesnesinin bir POST işlemi gerçekleştirecek şekilde ayarlanması durumunda meydana gelebilir.
 
Error — Fare olayı veya tuş basışı olayı gibi bir kullanıcı eylemine yanıt olarak yöntem çağrılmazsa.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek download olay nesnesinin kullanımını gösterir. Bu örneği çalıştırmak için, downloadURL.urlözelliğini, kurgusal http://www yerine gerçek bir etki alanına ve dosyaya işaret edecek şekilde değiştirin.[yourDomain].com/SomeFile.pdf. Ayrıca, SWF dosyasını Yerel oynatma güvenliği, Yalnızca ağa erişim şeklinde ayarlanmış biçimde derlemeniz veya Flash Player güvenlik ayarlarını bu dosyanın ağa erişmesine izin verecek şekilde güncellemeniz gerekebilir.
package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;
    import flash.net.FileFilter;

    public class FileReference_download extends Sprite {
        private var downloadURL:URLRequest;
        private var fileName:String = "SomeFile.pdf";
        private var file:FileReference;

        public function FileReference_download() {
            downloadURL = new URLRequest();
            downloadURL.url = "http://www.[yourDomain].com/SomeFile.pdf";
            file = new FileReference();
            configureListeners(file);
            file.download(downloadURL, fileName);
        }

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

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

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

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

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

        private function progressHandler(event:ProgressEvent):void {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

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

        private function selectHandler(event:Event):void {
            var file:FileReference = FileReference(event.target);
            trace("selectHandler: name=" + file.name + " URL=" + downloadURL.url);
        }
    }
}

load

()yöntem 
public function load():void

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: Flash Player 10, AIR 1.5

Kullanıcı tarafından seçilen yerel dosyanın yüklenmesini başlatır. Flash Player, karşıya yükleyebileceğiniz, indirebileceğiniz, yükleyebileceğiniz veya kaydedebileceğiniz dosyaların boyutu konusunda bir kısıtlama getirmese de, resmi olarak 100 MB'a kadar olan boyutları destekler. Flash Player'da çalışan içerik için, load() yöntemini çağırmadan önce FileReference.browse() veya FileReferenceList.browse() yöntemini çağırmalısınız. Ancak, AIR'da uygulama sanal alanında çalışan içerik, önce browse() yöntemini çağırmadan da bir File nesnesinin load() yöntemini çağırabilir. (AIR File sınıfı, FileReference sınıfını genişletir.)

Dinleyiciler, yükleme işleminin ilerlemesini, başarılı veya başarısız olduğunu gösteren olaylar alır. Kullanıcıların yükleme için birden çok dosya seçmesine izin vermek için FileReferenceList nesnesini kullanabiliyor olsanız da, bu dosyaları birer birer yüklemelisiniz. Dosyaları birer birer yüklemek için, FileReference nesnesinin FileReferenceList.fileList dizisini yineleyin.

Adobe AIR, ayrıca daha fazla dosya okuma seçeneği sağlayan FileStream sınıfını da içerir.

FileReference.upload(), FileReference.download(), FileReference.load() ve FileReference.save() işlevleri tıkanmasızdır. Bu işlevler çağrıldıktan sonra, dosya iletimi tamamlanmadan önce döndürülür. Ayrıca, FileReference nesnesi kapsam dışına çıkarsa, bu nesne üzerindeki henüz tamamlanmamış olan herhangi bir işlem, kapsam dışına çıkıldığında iptal edilir. Karşıya yükleme, indirme, yükleme veya kaydetme işleminin devam etmesi beklenen süre boyunca FileReference nesnesinin kapsam içinde kaldığından emin olun.

Dosyanın yüklenmesi başarıyla tamamlanırsa, içeriği FileReference nesnesinin data özelliğinde bir bayt dizisi olarak saklanır.

Şu güvenlik önlemleri uygulanır:

  • Çağıran SWF dosyası güvenilmeyen bir yerel sanal alandaysa yükleme işlemlerine izin verilmez.
  • Varsayılan davranış, sanal alanlar arasında erişimi reddetmektir. Bir web sitesi, etki alanları arası ilke dosyası ekleyerek bir kaynağa erişim sağlayabilir.
  • SWF içeriğini kapsayan HTML sayfasındaki object ve embed etiketlerinin allowNetworking parametresini ayarlayarak bir SWF dosyasının bu yöntemi kullanmasını önleyebilirsiniz.

Ancak, bu önlemler uygulama sanal alanındaki AIR içeriğine uygulanmaz.

Flash Player 10 veya AIR 1.5'te yayınlarken, bir defada bu işlemlerden yalnızca birinin etkin olabileceğini göz önünde bulundurun: FileReference.browse(), FileReference.upload(), FileReference.download(), FileReference.load(), FileReference.save(). Aksi halde, uygulama bir çalışma zamanı hatası (kod 2174) atar. Devam eden bir işlemi durdurmak için FileReference.cancel() öğesini kullanın. Bu sınırlamalar yalnızca Flash Player 10 ve AIR 1.5 için uygulanır. Önceki Flash Player veya AIR sürümleri eşzamanlı çoklu işlemlere ilişkin bu sınırlamalardan etkilenmez.

Adobe AIR uygulamasında dosyaya göz atma iletişim kutusu her zaman başka bir pencerenin "sahip olduğu" pencerelerin (null değerinde olmayan bir owner özelliğine sahip pencerelerin) önünde görüntülenmez. Pencere sıralama sorunlarını önlemek için, bu yöntemi çağırmadan önce sahip olunan pencereleri gizleyin.


Olaylar
open:Event — Bir yükleme işlemi başladığında gönderilir.
 
progress:ProgressEvent — Dosya yükleme işlemi sırasında düzenli aralıklarla gönderilir.
 
complete:Event — Dosya yükleme işlemi başarılı bir şekilde tamamlandığında gönderilir.
 
ioError:IOErrorEvent — Uygulama dosyayı okurken veya yazarken ortaya çıkan bir girdi/çıktı hatası nedeniyle yükleme başarısız olduğunda çağrılır.

Atar
IllegalOperationError — Şu durumlarda atılır: 1) Başka bir FileReference veya FileReferenceList gözatma oturumu devam ederken; bir seferde yalnızca bir dosya gözatma oturumu gerçekleştirilebilirken. 2) Kullanıcının mms.cfg dosyasındaki bir ayar bu işlemi yasakladığında.
 
MemoryError — Bu hata, uygulama dosya için bellek ayıramazsa ortaya çıkabilir. Dosya çok büyük olabilir veya kullanılabilir bellek çok düşük olabilir.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Aşağıdaki örnek, kök görüntüleme nesnesine (bu durumda, sahne alanına) yerel dosya sisteminizden bir görüntü yükler. Örnek Andre Venancio tarafından verilmiştir.
var buttonShape:Shape = new Shape();
buttonShape.graphics.beginFill(0x336699);
buttonShape.graphics.drawCircle(50, 50, 25);
var button = new SimpleButton(buttonShape, buttonShape, buttonShape, buttonShape);
addChild(button);

var fileRef:FileReference= new FileReference();
button.addEventListener(MouseEvent.CLICK, onButtonClick);

function onButtonClick(e:MouseEvent):void {
fileRef.browse([new FileFilter("Images", "*.jpg;*.gif;*.png")]);
fileRef.addEventListener(Event.SELECT, onFileSelected);
}

function onFileSelected(e:Event):void {
fileRef.addEventListener(Event.COMPLETE, onFileLoaded);
fileRef.load();
}

function onFileLoaded(e:Event):void {
var loader:Loader = new Loader();
loader.loadBytes(e.target.data);
addChild(loader);
}

    requestPermission

()yöntem 
public function requestPermission():void

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 24.0

Dosya sistemine erişim ister.


Olaylar
PermissionStatus:PermissionEvent — İstenilen izin kullanıcı tarafından verildiğinde/reddedildiğinde gönderilir.

save

()yöntem 
public function save(data:*, defaultFileName:String = null):void

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: Flash Player 10, AIR 1.5

Kullanıcının dosyayı yerel dosya sistemine kaydetmesini sağlayan bir iletişim kutusu açar. Flash Player, karşıya yükleyebileceğiniz, indirebileceğiniz, yükleyebileceğiniz veya kaydedebileceğiniz dosyaların boyutu konusunda bir kısıtlama getirmese de, resmi olarak 100 MB'a kadar olan boyutları destekler.

save() yöntemi ilk olarak, kullanıcıdan bir dosya adı girmesini ve dosyayı kaydetmek için yerel bilgisayar üzerinde bir konum seçmesini isteyen bir işletim sistemi iletişim kutusu açar. Kullanıcı bir konum seçtiğinde ve kaydetme işlemini onayladığında (örneğin Kaydet'i tıklatarak), kaydetme işlemi başlar. Dinleyiciler, kaydetme işleminin ilerlemesini, başarılı veya başarısız olduğunu gösteren olaylar alır. save() öğesini çağırdıktan sonra iletişim kutusunun ve kaydetme işleminin durumunu kesinleştirmek için, kodunuz cancel, open, progress ve complete gibi olayları dinlemelidir.

Adobe AIR, ayrıca daha fazla dosyaları yerel olarak kaydetme seçeneği sağlayan FileStream sınıfını da içerir.

FileReference.upload(), FileReference.download(), FileReference.load() ve FileReference.save() işlevleri tıkanmasızdır. Bu işlevler çağrıldıktan sonra, dosya iletimi tamamlanmadan önce döndürülür. Ayrıca, FileReference nesnesi kapsam dışına çıkarsa, bu nesne üzerindeki henüz tamamlanmamış olan herhangi bir işlem, kapsam dışına çıkıldığında iptal edilir. Karşıya yükleme, indirme, yükleme veya kaydetme işleminin devam etmesi beklenen süre boyunca FileReference nesnesinin kapsam içinde kaldığından emin olun.

Dosya başarıyla kaydedildiğinde, FileReference nesnesinin özellikleri, yerel dosyanın özellikleriyle doldurulur. Kaydetme başarılı olursa complete olayı gönderilir.

Aynı anda yalnızca bir browse() veya save() oturumu gerçekleştirilebilir (aynı anda yalnızca bir iletişim kutusu çağrılabildiğinden).

Flash Player'da, bu yöntemi yalnızca bir kullanıcı olayına yanıt olarak başarıyla çağırabilirsiniz (örneğin, fare tıklatması veya keypress olayı için bir olay işleyicisinde). Aksi halde, bu yöntemin çağrılması Flash Player'ın bir Error istisnası atmasına neden olur. Bu sınırlama, uygulama sanal alanındaki AIR içeriğine uygulanmaz.

Adobe AIR uygulamasında, kaydetme iletişim kutusu her zaman başka bir pencerenin "sahip olduğu" pencerelerin (null değerinde olmayan bir owner özelliğine sahip pencerelerin) önünde görüntülenmez. Pencere sıralama sorunlarını önlemek için, bu yöntemi çağırmadan önce sahip olunan pencereleri gizleyin.

Parametreler

data:* — Kaydedilecek veri. Veri çeşitli biçimlerden birinde olabilir ve buna uygun olarak ele alınır.
  • Değer null olduğunda, uygulama bir ArgumentError istisnası atar.
  • Değer bir String olduğunda, UTF-8 metin dosyası olarak kaydedilir.
  • Değer XML ise, XML biçiminde bir metin dosyasına yazılır ve tüm biçimlendirmesi korunur.
  • Değer bir ByteArray nesnesiyse, bir veri dosyasına harfi harfine yazılır.
  • Değer yukarıdakilerden hiçbiri değilse, save() yöntemi, nesnenin toString() yöntemini verileri bir dizeye dönüştürmesi için çağırır ve daha sonra verileri bir metin dosyası olarak saklar. Bu başarısız olduğunda, uygulama bir ArgumentError istisnası atar.
 
defaultFileName:String (default = null) — İletişim kutusunda kaydedilecek dosya için görüntülenen varsayılan dosya adı. Bu dize şu karakterleri içermemelidir: / \ : * ? " < > | %

Bir File nesnesi bu yöntemi çağırdığında, dosya adı, File nesnesinin başvurduğu dosyanın adı olur. (AIR File sınıfı, FileReference sınıfını genişletir.)


Olaylar
open:Event — Bir indirme işlemi başladığında gönderilir.
 
progress:ProgressEvent — Dosya indirme işlemi sırasında düzenli aralıklarla gönderilir.
 
complete:Event — Dosya indirme işlemi başarılı bir şekilde tamamlandığında gönderilir.
 
cancel:Event — Kullanıcı, dosyaya gözatma iletişim kutusundan çıktığında gönderilir.
 
select:Event — Kullanıcı, indirmek için iletişim kutusundan bir dosya seçtiğinde gönderilir.
 
ioError:IOErrorEvent — Dosya okunurken veya iletilirken bir girdi/çıktı hatası meydana geldiğinde gönderilir.

Atar
IllegalOperationError — Şu durumlarda atılır: 1) Başka bir gözatma oturumu devam ederken; bir seferde yalnızca bir dosya gözatma oturumu gerçekleştirilebilirken. 2) İndirilecek dosya adı yasaklı karakterler içerdiğinde. 3) Kullanıcının mms.cfg dosyasındaki bir ayar bu işlemi yasakladığında.
 
ArgumentError data öğesi ByteArray türünde değilse ve bir toString() yöntemine sahip değilse bir istisna atılır. data öğesi XML türünde değilse ve bir toXMLString() yöntemine sahip değilse bir istisna atılır.
 
Error — Fare olayı veya tuş basışı olayı gibi bir kullanıcı eylemine yanıt olarak yöntem çağrılmazsa.
 
MemoryError — Bu hata, Flash Player dosya için bellek ayıramazsa meydana gelebilir. Dosya çok büyük olabilir veya kullanılabilir bellek çok düşük olabilir.

İlgili API Öğeleri


Örnek  ( Bu örnek nasıl kullanılır? )

Aşağıdaki örnek, metin alanına yazılmış içeriği bir dosyaya kaydeder. Bu örnek, fare tıklatmasına yanıt vermek üzere bir "düğme" görevi görmesi için, düzenlenebilir bir metin alanı (MyTextField) ve düzenlenebilir olmayan başka bir metin alanı (MyButtonField) oluşturur. Kullanıcı birinci metin alanını düzenleyebilir ve metin alanı içeriklerini yerel bir dosyaya kaydetmek için düğmeyi tıklatabilir. Fare tıklatma olay işleyicisi clickhandler, kullanıcının sağladığı ada sahip bir yerel dosyaya içerikleri kaydedebilmesi için geçerli işletim sisteminde bir iletişim kutusu açmak üzere FileReference.save() yöntemini (MyFileReference adında bir FileReference nesnesi için) kullanır.
var MyTextField:TextField = new TextField();
var MyButtonField:TextField = new TextField();
var MyFile:FileReference = new FileReference();

MyTextField.border = true;
MyTextField.type = TextFieldType.INPUT;

MyButtonField.background = true;
MyButtonField.backgroundColor = 0x339933;
MyButtonField.x = 150;
MyButtonField.height = 20;
MyButtonField.text = "Click here to save";

addChild(MyTextField);
addChild(MyButtonField);
MyButtonField.addEventListener(MouseEvent.CLICK, clickhandler);

function clickhandler(e:MouseEvent): void {
    MyFile.save(MyTextField.text);
}

upload

()yöntem 
public function upload(request:URLRequest, uploadDataFieldName:String = "Filedata", testUpload:Boolean = false):void

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Dosyanın uzak bir sunucuya yüklenme işlemini başlatır. Flash Player, yükleyebileceğiniz veya indirebileceğiniz dosyaların boyutuna yönelik bir kısıtlama getirmese de, resmi olarak 100 MB'a kadar olan yükleme ya da indirmeleri destekler. Bu yöntemi çağırmadan önce FileReference.browse() veya FileReferenceList.browse() yöntemini çağırmalısınız.

FileReference sınıfını genişleten Adobe AIR File sınıfı için, herhangi bir dosyayı yüklemek için upload() yöntemini kullanabilirsiniz. FileReference sınıfı için (Flash Player'da kullanılan), kullanıcı ilk olarak bir dosya seçmelidir.

Dinleyiciler, yükleme işleminin ilerlemesini, başarılı veya başarısız olduğunu gösteren olaylar alır. Kullanıcıların yükleme için birden çok dosya seçmesini sağlamak için FileReferenceList nesnesini kullanabilseniz de dosyaları teker teker yüklemelisiniz; bunun için, FileReference nesnelerinin FileReferenceList.fileList dizisini yineleyin.

FileReference.upload() ve FileReference.download() işlevleri tıkanmasızdır. Bu işlevler çağrıldıktan sonra, dosya iletimi tamamlanmadan önce döndürülür. Ayrıca, FileReference nesnesi kapsam dışına çıkarsa, bu nesne üzerindeki henüz tamamlanmamış olan herhangi bir yükleme veya indirme işlemi, kapsam dışına çıkıldığında iptal edilir. Yükleme ve indirme işleminin devam etmesi beklenen süre boyunca FileReference nesnesinin kapsam içinde kaldığından emin olun.

Dosya, url parametresine iletilen URL'ye yüklenir. URL, yüklemeleri kabul edecek şekilde konfigüre edilmiş bir sunucu komut dosyası olmalıdır. Flash Player, HTTP POST yöntemini kullanarak dosyaları yükler. Yüklemeyi işleyen sunucu komut dosyası aşağıdaki öğelere sahip bir POST isteği beklemelidir:

  • multipart/form-data öğesinin Content-Type öğesi
  • Bir name niteliği varsayılan olarak "Filedata" şeklinde ayarlanmış ve bir filename niteliği orijinal dosyanın adı şeklinde ayarlanmış Content-Disposition öğesi.
  • Dosyanın ikili içeriği

Ortak olarak ayrılmış bağlantı noktalarına bağlanamazsınız. Engellenen bağlantı noktalarının tam listesi için, bkz. "Ağ İletişimi API'lerini Kısıtlama", ActionScript 3.0 Geliştirici Kılavuzu.

Örnek bir POST isteği için, uploadDataFieldName parametresinin açıklamasına bakın. upload() yöntemini kullanarak POST veya GET parametrelerini sunucuya gönderebilirsiniz; request parametresinin açıklamasına bakın.

testUpload parametresi true değerindeyse ve yüklenecek dosya yaklaşık 10 KB'tan büyükse, Windows'daki Flash Player ilk olarak, iletimin başarılı olabileceğini doğrulamak için gerçek dosyayı yüklemeden önce sıfır içerikli bir test yüklemesi POST işlemi gönderir. Ardından Flash Player, gerçek dosya içeriğine sahip ikinci bir POST işlemi gönderir. 10 KB'tan küçük dosyalar için, Flash Player yüklenecek olan gerçek dosya içeriğiyle birlikte tek bir yükleme POST işlemi gerçekleştirir. Macintosh'taki Flash Player test yüklemesi POST işlemleri gerçekleştirmez.

Not: Sunucunuz kimlik doğrulama gerektiriyorsa, yalnızca bir tarayıcıda çalışan SWF dosyaları, yani, tarayıcı eklentisini veya ActiveX denetimini kullanan dosyalar, kimlik doğrulama ve yalnızca indirmeler için kullanıcıdan bir kullanıcı adı ve şifre isteyen bir iletişim kutusu sağlar. Eklenti veya ActiveX denetimini kullanan yüklemelerde veya tek başına çalışabilen ya da harici oynatıcıyı kullanan yüklemelerde ve indirmelerde, dosya aktarımı başarısız olur.

Bu yöntemi kullanırken Flash Player güvenlik modelini göz önünde bulundurun:

  • Çağıran SWF dosyası güvenilmeyen bir yerel sanal alandaysa yükleme işlemlerine izin verilmez.
  • Varsayılan davranış, sanal alanlar arasında erişimi reddetmektir. Bir web sitesi, URL ilke dosyası eklenerek bir kaynağa erişilmesini sağlayabilir.
  • SWF içeriğini barındıran HTML sayfasındaki object veembed etiketlerinin allowNetworking parametresini ayarlayarak bir SWF dosyasının bu yöntemi kullanmasını önleyebilirsiniz.

Ancak Adobe AIR'de, application güvenlik sanal alanındaki içerik (AIR uygulamasıyla yüklenen içerik) bu güvenlik sınırlamalarıyla kısıtlanmaz.

Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.

Flash Player'a eklenen yeni işlevler nedeniyle, Flash Player 10'a yayın yapılırken aynı anda şu işlemlerden yalnızca birinin etkin olacağını unutmayın: FileReference.browse(), FileReference.upload(), FileReference.download(), FileReference.load(), FileReference.save(). Aksi takdirde, Flash Player bir çalışma zamanı hatası (kod 2174) atar. Devam eden bir işlemi durdurmak için FileReference.cancel() öğesini kullanın. Bu kısıtlama yalnızca Flash Player 10 için geçerlidir. Önceki Flash Player sürümleri, eşzamanlı birden çok işlem üzerindeki bu kısıtlamadan etkilenmez.

Parametreler

request:URLRequest — URLRequest nesnesi; URLRequest nesnesinin url özelliği, yükleme işlemini HTTP POST çağrıları üzerinden işleyecek şekilde konfigüre edilmiş sunucu komut dosyasının URL'sini içermelidir. Bazı tarayıcılarda URL dizelerinin uzunluğu sınırlıdır. 256 karakterden daha fazla uzunluklar bazı tarayıcılar veya sunucular üzerinde başarısız olabilir. Bu parametre null değerindeyse bir istisna atılır. URLRequest nesnesinin requestHeaders özelliği yok sayılır; yükleme veya indirme işlemlerinde özel HTTP isteği üstbilgileri desteklenmez.

URL bir HTTP veya güvenli yüklemeler için HTTPS olabilir. HTTPS'leri kullanmak için, url parametresinde bir HTTPS url'si kullanın. url parametresinde bir bağlantı noktası numarası belirtmezseniz, varsayılan olarak HTTP için bağlantı noktası 80, HTTPS için bağlantı noktası 443 kullanılır.

POST veya GETparametrelerini sunucuya göndermek için, URLRequest nesnesinin data özelliğini parametrelerinize ayarlayın ve URLRequest.method özelliğini URLRequestMethod.POST veya URLRequestMethod.GET öğesine ayarlayın.

 
uploadDataFieldName:String (default = "Filedata")POST yükleme işleminde dosya verilerinden önce gelen alan adı. uploadDataFieldName değeri boşta olmayan ve boş olmayan String öğesi olmalıdır. Varsayılan olarak uploadDataFieldName değeri, şu örnek POST isteğinde gösterildiği gibi "Filedata" şeklindedir:
    Content-Type: multipart/form-data; boundary=AaB03x
    --AaB03x 
    Content-Disposition: form-data; name="Filedata"; filename="example.jpg" 
    Content-Type: application/octet-stream
    ... contents of example.jpg ... 
    --AaB03x-- 
    
 
testUpload:Boolean (default = false) — Test dosyası yükleme isteğinde bulunacak bir ayar. testUpload 10 KB'tan büyük dosyalar için true değerindeyse, Flash Player, test dosyasının, Content-Length öğesi 0 olan bir POST öğesi yüklemesini dener. Test yükleme işlemi, gerçek dosya yüklemesinin ve gerekirse bir sunucu kimlik doğrulamasının başarılı olup olmayacağını kontrol eder. Test yüklemesi yalnızca Windows oynatıcıları için kullanılabilir.


Olaylar
open:Event — Yükleme veya indirme işlemi başladığında gönderilir.
 
progress:ProgressEvent — Dosya yükleme işlemi sırasında düzenli aralıklarla gönderilir.
 
complete:Event — Dosya yükleme işlemi başarılı bir şekilde tamamlandığında gönderilir.
 
uploadCompleteData:DataEvent — Başarılı bir dosya yükleme işleminden sonra sunucudan veri alındığında gönderilir.
 
securityError:SecurityErrorEvent — Bir güvenlik ihlali nedeniyle yükleme işlemi başarısız olduğunda gönderilir.
 
httpStatus:HTTPStatusEvent — HTTP hatası nedeniyle yükleme yapılamadığında gönderilir.
 
httpResponseStatus:HTTPStatusEvent — Yükleme işlemi başarıyla tamamlanır ve sunucu bir yanıt URL'si ve yanıt üstbilgileri döndürür.
 
ioError:IOErrorEvent — Aşağıdaki durumların herhangi birinde çağrılır:
  • Flash Player veya Adobe AIR dosyayı okurken, yazarken ya da iletirken bir girdi/çıktı hatası nedeniyle yükleme başarısız olduğunda.
  • Kimlik doğrulama (bir kullanıcı adı ve şifre gibi) gerektiren bir sunucuya dosya yüklenmeye çalışıldığından yükleme başarısız olduğunda. Yükleme sırasında kullanıcıların şifre girmesi için herhangi bir araç sağlanmaz.
  • url parametresi geçersiz bir protokol içerdiğinden yükleme başarısız olduğunda. FileReference.upload(), HTTP veya HTTPS'yi kullanmalıdır.

Atar
SecurityError — Güvenilmeyen yerel SWF dosyaları İnternet ile iletişim kuramayabilir. Bu durumu önlemek için bu SWF dosyasını ağa sahip yerel veya güvenilir olarak yeniden sınıflandırın. Bu istisna, erişilemeyen yerel dosyanın adını ve erişilemeyen URL'yi gösteren bir mesajla birlikte atılır.
 
SecurityError — Ortak olarak ayrılmış bağlantı noktalarına bağlanamazsınız. Engellenen bağlantı noktalarının tam listesi için, bkz. "Ağ İletişimi API'lerini Kısıtlama", ActionScript 3.0 Geliştirici Kılavuzu.
 
IllegalOperationError — Şu durumlarda atılır: 1) Başka bir FileReference veya FileReferenceList gözatma oturumu devam ederken; bir seferde yalnızca bir dosya gözatma oturumu gerçekleştirilebilirken. 2) URL parametresi geçerli bir yol veya protokol değil. Dosya yükleme işlemi HTTP, dosya indirme işlemi de FTP veya HTTP kullanmalıdır. 3) uploadDataFieldName parametresi null olarak ayarlanmış. 4) Kullanıcının mms.cfg dosyasındaki bir ayar bu işlemi yasakladığında.
 
ArgumentError — Aşağıdaki durumlarda atılır: 1) uploadDataFieldName parametresi boş bir dize. 2) url.data, ByteArray türünde. FileReference.upload() ve FileReference.download() yöntemleriyle kullanım için, url.data yalnızca URLVariables veya String türünde olabilir. 3) AIR çalışma zamanında (uygulama güvenlik sanal alanında), URLRequest öğesinin yöntemi GET veya POST değildir. (Bunun yerine uploadEncoded() kullanın.)
 
MemoryError — Bu hata şu nedenlerin birinden ötürü meydana gelebilir: 1) Flash Player, URLRequest.data parametresini UTF8'den MBCS'ye dönüştüremiyor. Bu hata, FileReference.upload() öğesine iletilen URLRequest nesnesinin bir GET işlemi gerçekleştirecek şekilde ayarlanması ve System.useCodePage öğesinin true olarak ayarlanması durumunda meydana gelebilir. 2) Flash Player, POST verileri için bellek ayıramaz. Bu hata, FileReference.upload() öğesine iletilen URLRequest nesnesinin bir POSTişlemi gerçekleştirecek şekilde ayarlanması durumunda meydana gelebilir.

İlgili API Öğeleri

    uploadUnencoded

()yöntem 
public function uploadUnencoded(request:URLRequest):void

Çalışma Zamanı Sürümleri: AIR 1.0

Kodlama olmadan bir URL'ye dosya yüklemesini başlatır. upload() yöntemi dosyayı biçim-veri zarfında kodlarken, uploadUnencoded() yöntemi dosya içeriklerini HTTP istek gövdesinde olduğu gibi iletir. Göndermek istediğiniz veriler zaten alıcı sunucunun anlayabileceği bir biçimde kodlanmışsa uploadUnencoded() yöntemini kullanın.Genellikle HTTP/WebDAV PUT yöntemiyle uploadeUnencoded() yöntemi kullanılır.

Parametreler

request:URLRequest — URLRequest nesnesi; URLRequest nesnesinin url özelliği, yükleme işlemini HTTP POST çağrıları üzerinden işleyecek şekilde konfigüre edilmiş sunucu komut dosyasının URL'sini içermelidir. Bazı tarayıcılarda URL dizelerinin uzunluğu sınırlıdır. 256 karakterden daha fazla uzunluklar bazı tarayıcılar veya sunucular üzerinde başarısız olabilir. Bu parametre null değerindeyse bir istisna atılır.

URL bir HTTP veya güvenli yüklemeler için HTTPS olabilir. HTTPS'leri kullanmak için, url parametresinde bir HTTPS url'si kullanın. url parametresinde bir bağlantı noktası numarası belirtmezseniz, varsayılan olarak HTTP için bağlantı noktası 80, HTTPS için bağlantı noktası 443 kullanılır.

POST veya GETparametrelerini sunucuya göndermek için, URLRequest nesnesinin data özelliğini parametrelerinize ayarlayın ve URLRequest.method özelliğini URLRequestMethod.POST veya URLRequestMethod.GET öğesine ayarlayın.


Olaylar
open:Event — Yükleme veya indirme işlemi başladığında gönderilir.
 
progress:ProgressEvent — Dosya yükleme işlemi sırasında düzenli aralıklarla gönderilir.
 
complete:Event — Dosya yükleme işlemi başarılı bir şekilde tamamlandığında gönderilir.
 
uploadCompleteData:DataEvent — Başarılı bir dosya yükleme işleminden sonra sunucudan veri alındığında gönderilir.
 
securityError:SecurityErrorEvent — Bir güvenlik ihlali nedeniyle yükleme işlemi başarısız olduğunda gönderilir.
 
httpStatus:HTTPStatusEvent — HTTP hatası nedeniyle yükleme yapılamadığında gönderilir.
 
httpResponseStatus:HTTPStatusEvent — Yükleme işlemi başarıyla tamamlanır ve sunucu bir yanıt URL'si ve yanıt üstbilgileri döndürür.
 
ioError:IOErrorEvent — Aşağıdaki durumların herhangi birinde çağrılır:
  • Adobe AIR dosyayı okurken, yazarken veya iletirken bir girdi/çıktı hatası nedeniyle yükleme başarısız olduğunda.
  • Kimlik doğrulama (bir kullanıcı adı ve şifre gibi) gerektiren bir sunucuya dosya yüklenmeye çalışıldığından yükleme başarısız olduğunda. Yükleme sırasında kullanıcıların şifre girmesi için herhangi bir araç sağlanmaz.
  • url parametresi geçersiz bir protokol içerdiğinden yükleme başarısız olduğunda. FileReference.upload(), HTTP veya HTTPS'yi kullanmalıdır.

Atar
SecurityError — Güvenilmeyen yerel SWF dosyaları İnternet ile iletişim kuramayabilir. Bu durumu önlemek için bu SWF dosyasını ağa sahip yerel veya güvenilir olarak yeniden sınıflandırın. Bu istisna, erişilemeyen yerel dosyanın adını ve erişilemeyen URL'yi gösteren bir mesajla birlikte atılır.
 
IllegalOperationError — Şu durumlarda atılır: 1) Başka bir FileReference veya FileReferenceList gözatma oturumu devam ederken; bir seferde yalnızca bir dosya gözatma oturumu gerçekleştirilebilirken. 2) URL parametresi geçerli bir yol veya protokol değil. Dosya yüklemesinin HTTP'yi kullanması gerekir.

İlgili API Öğeleri

Olay Ayrıntısı

cancel

Olay
Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.CANCEL

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Dosya yükleme veya indirme işlemi, kullanıcı tarafından dosya gözatma iletişim kutusu üzerinden iptal edildiğinde gönderilir. Kullanıcı yükleme veya indirme işlemini başka yollarla iptal ederse (tarayıcıyı kapatarak veya geçerli uygulamayı durdurarak), Flash Player bu olayı göndermez.

Event.CANCEL sabiti, cancel olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
targetÜzerindeki işlem iptal edilen nesnenin başvurusu.

Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek cancel olay nesnesinin kullanımını gösterir. Bu örneği çalıştırmak için, downloadURL.urlözelliğini, kurgusal http://www yerine gerçek bir etki alanına ve dosyaya işaret edecek şekilde değiştirin.[yourDomain].com/SomeFile.pdf. Ayrıca, SWF dosyasını Yerel oynatma güvenliği, Yalnızca ağa erişim şeklinde ayarlanmış biçimde derlemeniz veya Flash Player güvenlik ayarlarını bu dosyanın ağa erişmesine izin verecek şekilde güncellemeniz gerekebilir.
package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;

    public class FileReference_event_cancel extends Sprite {
        private var downloadURL:URLRequest;
        private var fileName:String = "SomeFile.pdf";
        private var file:FileReference;

        public function FileReference_event_cancel() {
            downloadURL = new URLRequest();
            downloadURL.url = "http://www.[yourDomain].com/SomeFile.pdf";
            file = new FileReference();
            file.addEventListener(Event.CANCEL, cancelHandler);
            file.download(downloadURL, fileName);
        }
        private function cancelHandler(event:Event):void {
            trace("cancelHandler: " + event);
        }
    }
}

complete

Olay  
Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.COMPLETE

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

İndirme tamamlandığında veya sunucuya yükleme işlemi HTTP durum kodu 200 verdiğinde gönderilir. Dosya indirme işleminde, Flash Player veya Adobe AIR dosyanın tamamını diske indirmeyi bitirdiğinde bu olay gönderilir. Dosya yükleme işleminde, Flash Player veya Adobe AIR, iletimi alan sunucudan bir HTTP durum kodu 200 aldıktan sonra bu olay gönderilir.

Event.COMPLETE sabiti, complete olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
targetYüklemesi tamamlanan network nesnesi.

Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek complete olay nesnesinin kullanımını gösterir. Bu örneği çalıştırmak için, downloadURL.urlözelliğini, kurgusal http://www yerine gerçek bir etki alanına ve dosyaya işaret edecek şekilde değiştirin.[yourDomain].com/SomeFile.pdf. Ayrıca, SWF dosyasını Yerel oynatma güvenliği, Yalnızca ağa erişim şeklinde ayarlanmış biçimde derlemeniz veya Flash Player güvenlik ayarlarını bu dosyanın ağa erişmesine izin verecek şekilde güncellemeniz gerekebilir.
package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;

    public class FileReference_event_complete extends Sprite {
        private var downloadURL:URLRequest;
        private var fileName:String = "SomeFile.pdf";
        private var file:FileReference;

        public function FileReference_event_complete() {
            downloadURL = new URLRequest();
            downloadURL.url = "http://www.[yourDomain].com/SomeFile.pdf";
            file = new FileReference();
            configureListeners(file);
            file.download(downloadURL, fileName);
        }

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

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

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

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

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

        private function progressHandler(event:ProgressEvent):void {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

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

        private function selectHandler(event:Event):void {
            var file:FileReference = FileReference(event.target);
            trace("selectHandler: name=" + file.name + " URL=" + downloadURL.url);
        }
    }
}

İlgili API Öğeleri

    

httpResponseStatus

Olay  
Olay Nesne Türü: flash.events.HTTPStatusEvent
özellik HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, AIR 1.0

upload() veya uploadUnencoded() yöntemine yapılan bir çağrı HTTP üzerinden verilere erişmeye çalışıyorsa ve Adobe AIR, istek için durum kodunu algılayıp döndürebiliyorsa gönderilir.

httpStatus olayından farklı olarak, httpResponseStatus olayı herhangi bir yanıt verisinden önce teslim edilir. Ayrıca, httpResponseStatus olayı, responseHeaders ve responseURL özelliklerine yönelik değerleri (httpStatus olayı için tanımsızdır) içerir. httpResponseStatus olayının (varsa) herhangi bir complete veya error olayından önce (ve buna ek olarak) gönderileceğini unutmayın.

HTTPStatusEvent.HTTP_RESPONSE_STATUS sabiti, httpResponseStatus olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
responseURLYanıtın döndürüldüğü URL.
responseHeadersURLRequestHeader nesneleri dizisi olarak yanıtın döndürüldüğü yanıt üstbilgileri.
statusSunucudan gelen HTTP durum kodu.
redirectedYanıtın yeniden yönlendirme sonucu olup olmadığıyla ilgilidir.
targetHTTP durum kodunu alan network nesnesi.

İlgili API Öğeleri

httpStatus

Olay  
Olay Nesne Türü: flash.events.HTTPStatusEvent
özellik HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Sunucuya yükleme işlemi başarısız olduğunda ve hatayı tanımlayan bir HTTP durum kodu bulunduğunda gönderilir. Bir ioError olayı tarafından izlenen httpStatus olayı gönderilir.

httpStatus yalnızca yüklemelerin başarısız olma durumunda gönderilir. Flash Player'da çalışan içeriklerde bu olay, indirme hatası için geçerli değildir. İndirme bir HTTP hatası nedeniyle başarısız olursa, hata bir G/Ç hatası olarak bildirilir.

HTTPStatusEvent.HTTP_STATUS sabiti, httpStatus olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
statusSunucudan gelen HTTP durum kodu.
targetHTTP durum kodunu alan network nesnesi.

İlgili API Öğeleri

ioError

Olay  
Olay Nesne Türü: flash.events.IOErrorEvent
özellik IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Sunucuya yükleme veya sunucudan indirme işlemi başarısız olduğunda gönderilir. Dosya aktarımı şu nedenlerin birinden ötürü başarısız olabilir:

  • Oynatıcı dosyayı okurken, yazarken veya iletirken bir girdi/çıktı hatası oluşur.
  • SWF dosyası, kimlik doğrulama (örn. kullanıcı adı ve şifre) gerektiren bir sunucuya dosya yüklemeyi dener. Flash Player veya Adobe AIR, yükleme sırasında kullanıcıların şifre girmesi için herhangi bir araç sağlamaz. Bir SWF dosyası kimlik doğrulama gerektiren bir sunucuya dosya yüklemeyi denerse, yükleme başarısız olur.
  • SWF dosyası, kimlik doğrulama gerektiren bir sunucudan, tek başına çalışabilen veya harici oynatıcı içerisine dosya indirmeyi dener. Bağımsız ve harici oynatıcılar, indirme sırasında kullanıcıların şifre girmesi için herhangi bir araç sağlamaz. Bu oynatıcılardaki bir SWF dosyası, kimlik doğrulama gerektiren bir sunucudan dosya indirmeyi denerse, indirme başarısız olur. Dosya indirme işlemi yalnızca ActiveX denetiminde, tarayıcı eklentisi Player'larında ve Adobe AIR çalışma zamanında başarılı olabilir.
  • upload() yöntemindeki url parametresine iletilen değer geçersiz bir protokol içeriyor. Geçerli protokoller HTTP ve HTTPS'dir.

Önemli: Yalnızca bir tarayıcıda çalışan — yani, tarayıcı eklentisi veya ActiveX denetimi kullanan — uygulamalar ve Adobe AIR'de çalışan içerik, kullanıcılara kimlik doğrulama için ve sonra da yalnızca indirme işlemleri için bir kullanıcı adı ve şifre girmelerini isteyen bir iletişim kutusu sağlayabilir. Flash Player'ın eklenti veya ActiveX denetimi sürümünü kullanılarak yapılan yüklemeler için veya tek başına çalışabilen ya da harici Player kullanarak yapılan yüklemeler için dosya aktarımı başarısız olur.

ioError olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
errorIDBelirli bir hata mesajıyla ilişkili başvuru numarası (yalnızca AIR).
targetGirdi/çıktı hatası yaşayan network nesnesi.
textHata mesajı olarak gösterilecek metin.

İlgili API Öğeleri

open

Olay  
Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.OPEN

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Sunucuya yükleme veya sunucudan indirme işlemi başladığında gönderilir.

Event.OPEN sabiti, open olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
targetBağlantıyı açan network nesnesi.

Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek download olay nesnesinin kullanımını gösterir. Bu örneği çalıştırmak için, downloadURL.urlözelliğini, kurgusal http://www yerine gerçek bir etki alanına ve dosyaya işaret edecek şekilde değiştirin.[yourDomain].com/SomeFile.pdf. Ayrıca, SWF dosyasını Yerel oynatma güvenliği, Yalnızca ağa erişim şeklinde ayarlanmış biçimde derlemeniz veya Flash Player güvenlik ayarlarını bu dosyanın ağa erişmesine izin verecek şekilde güncellemeniz gerekebilir.
package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;
    import flash.net.FileFilter;

    public class FileReference_download extends Sprite {
        private var downloadURL:URLRequest;
        private var fileName:String = "SomeFile.pdf";
        private var file:FileReference;

        public function FileReference_download() {
            downloadURL = new URLRequest();
            downloadURL.url = "http://www.[yourDomain].com/SomeFile.pdf";
            file = new FileReference();
            configureListeners(file);
            file.download(downloadURL, fileName);
        }

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

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

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

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

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

        private function progressHandler(event:ProgressEvent):void {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

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

        private function selectHandler(event:Event):void {
            var file:FileReference = FileReference(event.target);
            trace("selectHandler: name=" + file.name + " URL=" + downloadURL.url);
        }
    }
}

İlgili API Öğeleri

    

permissionStatus

Olay  
Olay Nesne Türü: flash.events.PermissionEvent
özellik PermissionEvent.type = flash.events.PermissionEvent.PERMISSION_STATUS

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 24.0

Uygulama, dosya sistemine erişim izni istediğinde gönderilir. İznin verildiğini veya reddedildiğini belirlemek için status özelliğinin değerini kontrol edin

İlgili API Öğeleri

progress

Olay  
Olay Nesne Türü: flash.events.ProgressEvent
özellik ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Sunucuya dosya yükleme veya sunucudan dosya indirme işlemi sırasında düzenli aralıklarla gönderilir. progress olayı Flash Player sunucuya bayt iletirken iletilir ve en sonunda iletim başarısız olsa da iletim sırasında belirli aralıklarla gönderilir. Dosya iletiminin başarılı bir şekilde tamamlanıp tamamlanmadığını ve ne zaman tamamlandığını belirlemek için complete olayını dinleyin.

Bazı durumlarda, progress olayları alınmaz. Örneğin, iletilmekte olan dosya çok küçükse ve yükleme ve indirme işlemi çok hızlı gerçekleşiyorsa bir progress olayı gönderilmeyebilir.

Dosya yükleme ilerlemesi, OS X 10.3'ten daha önceki Macintosh platformlarında belirlenemez. Yükleme işlemi sırasında progress olayı çağrılır ancak ilerleme olayının bytesLoaded özelliğinin değeri -1'dir ve ilerlemenin belirlenemeyeceğini gösterir.

Bir progress olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
bytesLoadedDinleyici olayı işlerken yüklenen öğe veya bayt sayısı.
bytesTotalYükleme işlemi başarılı olursa yüklenecek toplam öğe veya bayt sayısı.
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
targetİlerlemeyi bildiren nesne.

Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek progress olayının kullanımını gösterir. Bu örneği çalıştırmak için, downloadURL.urlözelliğini, kurgusal http://www yerine gerçek bir etki alanına ve dosyaya işaret edecek şekilde değiştirin.[yourDomain].com/SomeFile.pdf. Ayrıca, SWF dosyasını Yerel oynatma güvenliği, Yalnızca ağa erişim şeklinde ayarlanmış biçimde derlemeniz veya Flash Player güvenlik ayarlarını bu dosyanın ağa erişmesine izin verecek şekilde güncellemeniz gerekebilir.
package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;

    public class FileReference_event_progress extends Sprite {
        private var downloadURL:URLRequest;
        private var fileName:String = "SomeFile.pdf";
        private var file:FileReference;

        public function FileReference_event_progress() {
            downloadURL = new URLRequest();
            downloadURL.url = "http://www.[yourDomain].com/SomeFile.pdf";
            file = new FileReference();
            file.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            file.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            file.addEventListener(Event.COMPLETE, completeHandler);
            file.download(downloadURL, fileName);
        }

        private function progressHandler(event:ProgressEvent):void {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler: name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }
        
        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
        
        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
        }
    }
}

İlgili API Öğeleri

securityError

Olay  
Olay Nesne Türü: flash.events.SecurityErrorEvent
özellik SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

FileReference.upload() veya FileReference.download() yöntemine yapılan bir çağrı sunucuya bir dosya yüklemeye çalıştığında veya çağıranın güvenlik sanal alanının dışındaki bir dosyayı sunucudan almaya çalıştığında gönderilir. Meydana gelen belirli hatayı açıklayan metin özelliğinin değeri normalde "securitySandboxError" şeklindedir. Çağıran SWF dosyası, kendi etki alanının dışındaki bir SWF dosyasına erişmeye çalışmış olabilir ve bunun için izne sahip olmayabilir. Bir URL like dosyası kullanarak bu hatayı gidermeyi deneyebilirsiniz.

Adobe AIR'de bu güvenlik kısıtlamaları, uygulama güvenlik sanal alanındaki içerik için geçerli değildir.

Adobe AIR'de bu güvenlik kısıtlamaları, uygulama güvenlik sanal alanındaki içerik için geçerli değildir.

SecurityErrorEvent.SECURITY_ERROR sabiti, securityError olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
targetGüvenlik hatasını bildiren network nesnesi.
textHata mesajı olarak gösterilecek metin.

İlgili API Öğeleri

select

Olay  
Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.SELECT

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

Kullanıcı, sunucuya yüklemek veya sunucudan indirmek için, dosyaya gözatma iletişim kutusundan dosya seçtiğinde gönderilir. (Bu iletişim kutusu, FileReference.browse(), FileReferenceList.browse() veya FileReference.download() yöntemini çağırdığınızda açılır.) Kullanıcı bir dosya seçtiğinde ve işlemi onayladığında (örneğin Tamam'ı tıklatarak), FileReference nesnesinin özellikleri doldurulur.

Flash Player'da veya Adobe AIR çalışma zamanındaki uygulama güvenlik sanal alanı dışında çalışan içerik için, select olayı kendisini çağıran yönteme bağlı olarak biraz farklı davranır. browse() çağrısından sonra select olayı gönderildiğinde, kullanıcı tarafından seçilen dosya yerel dosya sistemi üzerinde olduğundan Flash Player veya AIR uygulaması, FileReference nesnesinin tüm özelliklerini okuyabilir. download() çağrısından sonra select olayı oluştuğunda, select olayı gönderildiği zaman dosya henüz yerel dosya sistemine indirilmemiş olduğundan Flash Player veya AIR uygulaması yalnızca name özelliğini okuyabilir. Dosya indirildiğinde ve complete olayı gönderildiğinde, Flash Player veya AIR uygulaması, FileReference nesnesinin diğer tüm özelliklerini okuyabilir.

Event.SELECT sabiti, select olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
targetÜzerinde bir öğenin seçildiği nesne.

Örnek  ( Bu örnek nasıl kullanılır? )

Şu örnek select olay nesnesinin kullanımını gösterir. Bu örneği çalıştırmak için, uploadURL.urlözelliğini, kurgusal http://www yerine gerçek bir etki alanına ve dosyaya işaret edecek şekilde değiştirin.[yourDomain].com/SomeFile.pdf. Ayrıca, SWF dosyasını Yerel oynatma güvenliği, Yalnızca ağa erişim şeklinde ayarlanmış biçimde derlemeniz veya Flash Player güvenlik ayarlarını bu dosyanın ağa erişmesine izin verecek şekilde güncellemeniz gerekebilir. Bu örneğin masaüstünüzden çalışması için, sunucunuzun ayrıca gönderilmiş bir crossdomain.xml dosyasına sahip olması gerekir. ioErrorHandler() işlevi tetiklenirse büyük olasılıkla, yüklemeleri almak için konfigüre edilmiş geçerli bir URL'ye sahip uploadURL öğesini güncellemeniz gerekebilir.
 
package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;

    public class FileReference_event_select extends Sprite {
        private var uploadURL:URLRequest;
        private var file:FileReference;

        public function FileReference_event_select() {
            uploadURL = new URLRequest();
            uploadURL.url = "http://www.[yourDomain].com/yourUploadHandlerScript.cfm";
            file = new FileReference();
            file.addEventListener(Event.SELECT, selectHandler);
            file.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            file.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            file.addEventListener(Event.COMPLETE, completeHandler);
            file.browse();
        }

        private function selectHandler(event:Event):void {
            var file:FileReference = FileReference(event.target);
            trace("selectHandler: name=" + file.name + " URL=" + uploadURL.url);
            file.upload(uploadURL);
        }

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

        private function progressHandler(event:ProgressEvent):void {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler: name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

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

uploadCompleteData

Olay  
Olay Nesne Türü: flash.events.DataEvent
özellik DataEvent.type = flash.events.DataEvent.UPLOAD_COMPLETE_DATA

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9.0.28.0

Sunucuya yapılan başarılı bir yükleme işleminin ardından veri alındığında gönderilir. Veriler sunucudan döndürülmezse bu olay gönderilmez.

uploadCompleteData olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
dataBaşarılı dosya yükleme işleminden sonra sunucudan döndürülen ham veriler.
targetBaşarılı bir yükleme işleminden sonra verileri alan FileReference nesnesi.
FileReferenceExample.as

Aşağıdaki örnek, çalışma zamanında yüklenen dosyaya yönelik veri biçimini ve durum bilgisini görüntüler.

Not: Bu örneği çalıştırmak için, uploadURL.url özelliğini, örnekteki kurgusal bir URL yerine gerçek bir URL'ye işaret edecek şekilde değiştirin. URL, belirtilen URL'nin kök web dizinindeki yourUploadHandlerScript.cfm adlı bir dosyaya işaret etmelidir. Konfigürasyonunuza bağlı olarak, SWF dosyasını Yerel Oynatma Güvenliği, Yalnızca Ağa Erişim şeklinde ayarlanmış biçimde derlemeniz veya Flash Player güvenlik ayarlarını bu dosyanın ağa erişmesine izin verecek şekilde güncellemeniz gerekebilir.

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileFilter;
    import flash.net.FileReference;
    import flash.net.URLRequest;

    public class FileReferenceExample extends Sprite {
        private var uploadURL:URLRequest;
        private var file:FileReference;

        public function FileReferenceExample() {
            uploadURL = new URLRequest();
            uploadURL.url = "http://www.[yourDomain].com/yourUploadHandlerScript.cfm";
            file = new FileReference();
            configureListeners(file);
            file.browse(getTypes());
        }

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

        private function getTypes():Array {
            var allTypes:Array = new Array(getImageTypeFilter(), getTextTypeFilter());
            return allTypes;
        }

        private function getImageTypeFilter():FileFilter {
            return new FileFilter("Images (*.jpg, *.jpeg, *.gif, *.png)", "*.jpg;*.jpeg;*.gif;*.png");
        }

        private function getTextTypeFilter():FileFilter {
            return new FileFilter("Text Files (*.txt, *.rtf)", "*.txt;*.rtf");
        }

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

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

        private function uploadCompleteDataHandler(event:DataEvent):void {
            trace("uploadCompleteData: " + event);
        }

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

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

        private function progressHandler(event:ProgressEvent):void {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

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

        private function selectHandler(event:Event):void {
            var file:FileReference = FileReference(event.target);
            trace("selectHandler: name=" + file.name + " URL=" + uploadURL.url);
            file.upload(uploadURL);
        }
    }
}




[ X ]Niçin İngilizce?
ActionScript 3.0 Başvurusu'ndaki içerik İngilizce görünür

ActionScript 3.0 Başvurusu'nun tüm bölümleri tüm dillere çevrilmemiştir. Bir dil öğesi çevrilmediğinde İngilizce görünür. Örneğin, ga.controls.HelpBox sınıfı hiçbir dile çevrilmez. Bu nedenle, başvurunun Türkçe versiyonunda ga.controls.HelpBox sınıfı İngilizce görünür.