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 

SharedObject  - 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 SharedObject
Miras AlmaSharedObject Inheritance EventDispatcher Inheritance Object

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

SharedObject sınıfı bilgisayarında veya bir sunucuda sınırlı miktarda veri okumak veya saklamak için kullanılır. Paylaşılan nesneler, yerel bilgisayar veya uzak sunucu üzerinde kalıcı olan çoklu istemci SWF dosyaları ve nesneler arasında gerçek zamanlı veri paylaşımı sunar. Yerel paylaşılan nesneler, tarayıcı tanımlama bilgilerine benzer uzak yerel paylaşılan nesneler ise gerçek zamanlı veri aktarımı araçlarına benzer. Paylaşılan uzak nesneleri kullanmak için Adobe Flash Media Server'a ihtiyacınız vardır.

Şunları gerçekleştirmek için paylaşılan nesneleri kullanın:

  • Yerel olarak kalıcılığı sağlama. Bu paylaşılan bir nesneyi kullanmanın en kolay yoludur ve Flash Media Server gerektirmez. Örneğin, uygulamada belleğe sahip hesap makinesi gibi bir paylaşılan nesne oluşturmak için SharedObject.getLocal() öğesini çağırabilirsiniz. Kullanıcı hesap makinesini kapattığında, Flash Player kullanıcını bilgisayarında bulunan paylaşılan nesnedeki son değeri kaydeder. Hesap makinesi bir sonraki çalıştırılışında daha önce sahip olduğu değerleri içerir. Alternatif olarak, hesap makinesi uygulaması kapatılmadan önce paylaşılan nesnenin özelliklerini null olarak ayarlarsanız, uygulama bir sonraki çalıştırılışında herhangi bir değer olmadan açılır. Yerel olarak kalıcılığı sağlamanın bir başka örneği, kullanıcının bir haber sitesinde hangi makaleleri okuduğunun kaydı gibi, karmaşık bir siteye yönelik kullanıcı tercihleri ve diğer verileri izlemektir. Bu bilgileri izlerseniz, yeni ve okunmamış makalelerden farklı olarak daha önceden okunan makaleleri de görüntüleyebilirsiniz. Bu bilgileri kullanıcının bilgisayarı üzerinde saklarsanız sunucudaki yük azalır.
  • Flash Media Server üzerinde veri saklama ve paylaşma. Paylaşılan bir nesne, diğer istemcilerin alabilmesi için sunucu üzerinde veri saklayabilir. Örneğin, bir telefon listesi gibi sunucu üzerinde kalıcı olan uzak bir paylaşılan nesne oluşturmak için SharedObject.getRemote() öğesini çağırın. İstemci paylaşılan nesneye her değişiklik yaptığında gözden geçirilmiş veriler, o anda nesneye bağlı olan veya daha sonra bağlanan tüm istemciler tarafından kullanılabilir. Nesne de yerel olarak kalıcıysa istemci, sunucuya bağlı değilken verileri değiştirir. İstemci nesneye sonraki bağlanışında veriler, paylaşılan uzak nesneye kopyalanır.
  • Gerçek zamanlı veri paylaşma. Paylaşılan bir nesne, gerçek zamanda birden çok istemci arasındaki verileri paylaşabilir. Örneğin, nesneye bağlı tüm istemciler tarafından görülebilen bir sohbet odasına bağlı kullanıcıların bir listesini saklayan uzak bir paylaşılan nesne açabilirsiniz. Bir kullanıcı sohbet odasına girdiğinde veya odadan ayrıldığında nesne güncellenir ve nesneye bağlı tüm istemciler, sohbet odası kullanıcılarının gözden geçirilmiş listesini görür.

Yerel bir paylaşılan nesne oluşturmak için SharedObject.getLocal() öğesini çağırın. Uzak bir paylaşılan nesne oluşturmak için SharedObject.getRemote() öğesini çağırın.

Bir uygulama kapatıldığında paylaşılan nesneler boşaltılır veya bir diske yazdırılır. Ayrıca bir diske açıkça veri yazmak için flush() yöntemini çağırabilirsiniz.

Yerel disk alanı önemli noktaları. Yerel paylaşılan nesneler, uygulamanızı tasarlarken üzerinde durmanızın önemli olduğu bası sınırlamalara sahiptir. Bazen SWF dosyalarının yerel paylaşılan nesneleri yazmasına izin verilmez ve bazen de yerel paylaşılan nesnelerde saklanan veriler haberiniz olmadan silinebilir. Flash Player kullanıcıları, ayrı ayrı etki alanları veya tüm etki alanları tarafından kullanılabilen disk alanı miktarını yönetebilir. Kullanıcılar kullanılabilir disk alanını azalttığında bazı yerel paylaşılan nesneler silinebilir. Flash Player kullanıcıları, üçüncü taraf etki alanlarının (geçerli tarayıcının adres çubuğundaki etki alanından başka etki alanları) yerel paylaşılan nesneleri okumasını veya yazmasını önleyebilen gizlilik kontrollerine sahiptir. Ayrıca AIR 3.3'ten itibaren Mac OS'de yerel paylaşılan nesnelerin konumunun değiştiğini, bu nedenle 3.3 ad alanına yükseltme yaparsanız nesneler kaybolmuş gibi görünebileceğini unutmayın.

Not: Yerel bir bilgisayarda saklanan ve çalıştırılan ve uzak bir bilgisayardan olmayan SWF dosyaları her zaman üçüncü taraf paylaşılan nesneleri diske yazabilir. Üçüncü taraf paylaşılan nesneler hakkında daha fazla bilgi için, Flash Player Yardımı'ndaki Global Storage Settings panel (Global Saklama Ayarları paneli) başlığına bakın.

Disk alanı miktarıyla veya kullanıcı gizlilik seçenekleriyle ilgili hataların olup olmadığını kontrol edebilirsiniz. Kontrolleri getLocal() ve flush() öğelerini çağırdığınızda gerçekleştirin:

  • SharedObject.getLocal() — Bu yönteme yapılan bir çağrı başarısız olduğunda, yani kullanıcı üçüncü taraf paylaşılan nesneleri devre dışı bıraktığında ve SWF dosyanızın etki alanı, tarayıcı adres çubuğundaki etki alanıyla eşleşmediğinde Flash Player bir istisna atar.
  • SharedObject.flush() — Bu yönteme yapılan bir çağrı başarısız olduğunda Flash Player bir istisna atar. Başarılı olduğunda SharedObjectFlushStatus.FLUSHED öğesini döndürür. Ek saklama alanı gerektiğinde SharedObjectFlushStatus.PENDING öğesini döndürür. Flash Player, kullanıcının yerel olarak saklanmış bilgilere yönelik saklama alanını artırmasını sağlar. Daha sonra, boşaltma işleminin başarılı veya başarısız olduğunu gösteren bir bilgi nesnesiyle birlikte netStatus olayı gönderilir.

SWF dosyanız yerel paylaşılan nesneleri oluşturmayı veya değiştirmeyi denerse, SWF dosyanızın en az 215 piksel genişliğinde ve en az 138 piksel yüksekliğinde (kullanıcıdan yerel paylaşılan nesne saklama sınırını artırmasını isteyen iletişim kutusunu göstermeye yönelik minimum boyutlar) olduğundan emin olun. SWF dosyanız bu boyutlardan küçükse ve saklama sınırının artırılması gerekiyorsa, SharedObject.flush(), SharedObjectFlushedStatus.PENDING öğesini döndürerek ve netStatus olayını göndererek başarısız olur.

Uzak paylaşılan nesneler. Flash Media Server ile, uygulamanıza bağlı olan tüm istemcilerle gerçek zamanlı olarak paylaşılan uzak paylaşılan nesneleri oluşturabilir ve kullanabilirsiniz. Bir istemci uzak bir paylaşılan nesnenin özelliğini değiştirdiğinde bu özellik bağlı tüm istemciler için değiştirilir. İstemcileri, örneğin çoklu oyunculu oyundaki kullanıcıları senkronize etmek için uzak paylaşılan nesneleri kullanabilirsiniz.

Her uzak paylaşılan nesne, verileri saklayan özelliklere sahip bir Object olan data özelliğine sahiptir. Veri nesnesinin biz özelliğini değiştirmek için setProperty() öğesini çağırın. Bu sunucu özellikleri günceller, bir sync olayı gönderir ve özellikleri bağlı olan istemcilere geri gönderir.

Uzak paylaşılan nesnelerin istemcide, sunucuda veya her ikisinde de kalmasını seçebilirsiniz. Flash Player varsayılan olarak, boyutu 100K'ya kadar olan ve yerel olarak kalıcı uzak paylaşılan nesneleri kaydeder. Daha büyük bir nesneyi kaydetmeye çalıştığınızda Flash Player, kullanıcının paylaşılan nesnenin yerel olarak saklanmasını kabul etmesine veya reddetmesine izin veren Yerel Saklama iletişim kutusunu görüntüler. Sahne Alanı'nızın boyutunun en az 215'e 138 piksel olduğundan emin olun. Bu değer, iletişim kutusunu görüntülemek için Flash tarafından gereken minimum boyuttur.

Kullanıcı İzin Ver'i seçerse, sunucu paylaşılan nesneyi kaydeder ve SharedObject.Flush.Success öğesinin code özelliğiyle birlikte bir netStatus olayı gönderir. Kullanıcı Reddet'i seçerse, sunucu paylaşılan nesneyi kaydetmez ve SharedObject.Flush.Failed öğesinin code özelliğiyle birlikte bir netStatus olayı gönderir.

Örnekleri görüntüle

İlgili API Öğeleri



Genel Özellikler
 ÖzellikTanımlayan:
  client : Object
Üzerinde geri çağırma yöntemlerinin çağrıldığı nesneyi gösterir.
SharedObject
 Inheritedconstructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.
Object
  data : Object
[salt okunur] Nesnenin data özelliğine atanan nitelikler koleksiyonu; bu nitelikler paylaşılabilir ve saklanabilir.
SharedObject
  defaultObjectEncoding : uint
[statik] SWF dosyasında oluşturulan tüm yerel paylaşılan nesneler için varsayılan nesne kodlaması (AMF sürümü).
SharedObject
  fps : Number
[salt yazılır] İstemcinin paylaşılan nesneye yaptığı değişikliklerin sunucuya saniyede kaç defa gönderildiğini belirtir.
SharedObject
  objectEncoding : uint
Bu paylaşılan nesne için nesne kodlaması (AMF sürümü).
SharedObject
      preventBackup : Boolean
[statik] Yerel olarak paylaşılan nesnelerin iOS bulut yedekleme hizmetinde yedeklenip yedeklenmeyeceğini belirtir.
SharedObject
  size : uint
[salt okunur] Paylaşılan nesnenin bayt olarak geçerli boyutu.
SharedObject
Genel Yöntemler
 YöntemTanımlayan:
 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
  
Paylaşılan yerel nesneler için, tüm verileri temizler ve paylaşılan nesneyi diskten siler.
SharedObject
  
Paylaşılan bir uzak nesne ile sunucu arasındaki bağlantıyı kapatır.
SharedObject
  
connect(myConnection:NetConnection, params:String = null):void
Belirtilen bir NetConnection nesnesi üzerinden bir sunucu üzerindeki paylaşılan uzak bir nesneye bağlanır.
SharedObject
 Inherited
Olay akışına bir olay gönderir.
EventDispatcher
  
flush(minDiskSpace:int = 0):String
Yerel bir dosyaya hemen yerel olarak kalıcı, paylaşılan bir nesne yazar.
SharedObject
  
getLocal(name:String, localPath:String = null, secure:Boolean = false):SharedObject
[statik] Sadece geçerli istemcinin kullanabildiği yerel olarak kalıcı paylaşılan bir nesneye başvuru döndürür.
SharedObject
  
getRemote(name:String, remotePath:String = null, persistence:Object = false, secure:Boolean = false):SharedObject
[statik] Flash Media Server üzerinde bulunan ve birden fazla istemcinin erişebildiği paylaşılan bir nesneye bir başvuru döndürür.
SharedObject
 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
 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
  
send(... arguments):void
Belirtilmiş paylaşılan uzak nesneye bağlı tüm istemcilere, mesajı gönderen istemci de dahil olmak üzere bir mesaj yayımlar.
SharedObject
  
setDirty(propertyName:String):void
Sunucuya, paylaşılan nesnedeki (data özelliği ile tanımlanan) bir özelliğinin değerinin değiştiğini gösterir.
SharedObject
  
setProperty(propertyName:String, value:Object = null):void
Paylaşılan bir nesnedeki özelliğin değerini günceller ve sunucuya özelliğin değerinin değiştiğini gösterir.
SharedObject
 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
 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
  Eşzamansız olarak, başka bir deyişle, yerel eşzamansız koddan bir istisna atıldığında gönderilir.SharedObject
 Inherited[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.EventDispatcher
  Bir SharedObject örneği durumunu veya hata koşulunu bildirdiğinde gönderilir.SharedObject
  Uzaktan paylaşılan bir nesne sunucu tarafından güncellendiğinde gönderilir.SharedObject
Özellik Ayrıntısı

client

özellik
client:Object

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

Üzerinde geri çağırma yöntemlerinin çağrıldığı nesneyi gösterir. Varsayılan nesne this şeklindedir. client özelliğini başka bir nesneye ayarlayabilirsiniz. Bu durumda geri çağırma yöntemleri o nesne üzerinde çağrılır.



Uygulama
    public function get client():Object
    public function set client(value:Object):void

Atar
TypeError client özelliği, null olmayan değere sahip bir nesneye ayarlanmalıdır.

data

özellik 
data:Object  [salt okunur]

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

Nesnenin data özelliğine atanan nitelikler koleksiyonu; bu nitelikler paylaşılabilir ve saklanabilir. Her nitelik herhangi bir ActionScript veya JavaScript türünün Array, Number, Boolean, ByteArray, XML, vb. nesnesi olabilir. Örneğin, şu satırlar bir paylaşılan nesnenin çeşitli özelliklerine değerler atar:

     var items_array:Array = new Array(101, 346, 483);
     var currentUserIsAdmin:Boolean = true;
     var currentUserName:String = "Ramona";
     
     var my_so:SharedObject = SharedObject.getLocal("superfoo");
     my_so.data.itemNumbers = items_array;
     my_so.data.adminPrivileges = currentUserIsAdmin;
     my_so.data.userName = currentUserName;
     
     for (var prop in my_so.data) {
       trace(prop+": "+my_so.data[prop]);
     }
     

Nesne kalıcıysa paylaşılan nesnenin data özelliğinin tüm özellikleri kaydedilir ve paylaşılan nesne şu bilgileri içerir:

     userName: Ramona
     adminPrivileges: true
     itemNumbers: 101,346,483
     

Not:so.data = someValue örneğinde olduğu gibi paylaşılan bir nesnenin data özelliğine doğrudan değerler atamayın; Flash Player bu atamaları yok sayar.

Paylaşılan yerel nesnelere yönelik nitelikleri silmek için delete so.data.attributeName şeklinde bir kod kullanın; bir niteliğin paylaşılan yerel bir nesne için null veya undefined olarak ayarlanması niteliği silmez.

Paylaşılan bir nesneye yönelik private değerler oluşturmak amacıyla (nesne kullanımdayken yalnızca istemci örneği tarafından kullanılabilen ve nesne kapalıyken nesneyle birlikte saklanmayan değerler) saklamak için şu örnekteki gibi adı data olmayan özellikler oluşturun:

     var my_so:SharedObject = SharedObject.getLocal("superfoo");
     my_so.favoriteColor = "blue";
     my_so.favoriteNightClub = "The Bluenote Tavern";
     my_so.favoriteSong = "My World is Blue";
     
     for (var prop in my_so) {
       trace(prop+": "+my_so[prop]);
     }
     

Paylaşılan nesne şu verileri içerir:

     favoriteSong: My World is Blue
     favoriteNightClub: The Bluenote Tavern
     favoriteColor: blue
     data: [object Object]
     

Bir sunucuyla kullanılan paylaşılan uzak nesneler için, data özelliğinin tüm nitelikleri paylaşılan nesneye bağlı olan tüm istemciler tarafından kullanılabilir ve nesne kalıcıysa tüm nitelikler kaydedilir. Bir istemci bir niteliğin değerini değiştirirse tüm istemciler artık yeni değeri görebilir.



Uygulama
    public function get data():Object

İlgili API Öğeleri

defaultObjectEncoding

özellik 
defaultObjectEncoding:uint

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

SWF dosyasında oluşturulan tüm yerel paylaşılan nesneler için varsayılan nesne kodlaması (AMF sürümü). Paylaşılan yerel nesneler bir diske yazıldığında, SharedObject.defaultObjectEncoding özelliği hangi Action Message Format sürümünün kullanılması gerektiğini gösterir: ActionScript 3.0 biçimi (AMF3) veya ActionScript 1.0 veya 2.0 biçimi (AMF0).

Nesne kodlama hakkında, paylaşılan yerel ve uzak nesnelerde kodlama arasındaki farkı da dahil olmak üzere daha fazla bilgi için objectEncoding özelliğine bakın.

SharedObject.defaultObjectEncoding öğesinin varsayılan değeri, ActionScript 3.0 biçimini (AMF3) kullanacak şekilde ayarlanmıştır. ActionScript 2.0 veya 1.0 SWF dosyalarının okuyabildiği paylaşılan yerel nesneleri yazmanız gerekiyorsa, herhangi bir paylaşılan yerel nesne oluşturmadan önce komut dosyanızın başında SharedObject.defaultObjectEncoding öğesini ActionScript 1.0 veya ActionScript 2.0 biçimini (flash.net.ObjectEncoding.AMF0) kullanacak şekilde ayarlayın. Buradan sonra oluşturulan tüm paylaşılan yerel nesneler, AMF0 kodlamasını kullanır ve daha eski içerikle etkileşime geçebilir. Varolan yerel nesnelerin objectEncoding değerini, yerel nesneler oluşturulduktan sonra SharedObject.defaultObjectEncoding öğesini ayarlayarak değiştiremezsiniz.

Nesne kodlamasını, SWF dosyası tarafından oluşturulan tüm paylaşılan nesneler için aynı anda değil de her nesne için ayrı ayrı ayarlamak için yerel paylaşılan nesnenin objectEncoding özelliğini ayarlayın.



Uygulama
    public static function get defaultObjectEncoding():uint
    public static function set defaultObjectEncoding(value:uint):void

İlgili API Öğeleri

fps

özellik 
fps:Number  [salt yazılır]

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

İstemcinin paylaşılan nesneye yaptığı değişikliklerin sunucuya saniyede kaç defa gönderildiğini belirtir.

İstemci ve sunucu arasındaki trafik miktarını kontrol etmek istediğinizde bu yöntemi kullanın. Örneğin, istemci ve sunucu arasındaki bağlantı nispeten yavaşsa, fps öğesini nispeten düşük bir değere ayarlamak isteyebilirsiniz. Diğer taraftan istemci, zamanlamanın önemli olduğu çok kullanıcılı bir uygulamaya bağlıysa fps öğesini nispeten yüksek bir değere ayarlamak istemeyebilirsiniz.

fps öğesinin ayarlanması bir sync olayını tetikler ve sunucuda yapılan tüm değişiklikleri günceller. Yalnızca sunucuyu elle konfigüre etmek istiyorsanız fps öğesini 0 olarak ayarlayın.

sync olayı gönderilene kadar değişiklikler sunucuya gönderilmez. Yani, sunucudan gelen yanıtlama zamanı yavaşsa güncellemeler sunucuya bu özellikte belirtilen değerden daha az sıklıkla gönderilebilir.



Uygulama
    public function set fps(value:Number):void

objectEncoding

özellik 
objectEncoding:uint

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

Bu paylaşılan nesne için nesne kodlaması (AMF sürümü). Paylaşılan bir yerel nesne bir diske yazıldığında, objectEncoding özelliği hangi Action Message Format sürümünün kullanılması gerektiğini gösterir: ActionScript 3.0 biçimi (AMF3) veya ActionScript 1.0 veya 2.0 biçimi (AMF0).

Nesne kodlaması, paylaşılan nesnenin yerel veya uzak olmasına bağlı olarak farklı şekillerde işlenir.

  • Paylaşılan yerel nesneler. Paylaşılan yerel nesnelere yönelik objectEncoding özelliğini alabilir veya ayarlayabilirsiniz. objectEncoding değeri bu paylaşılan yerel nesneyi yazmak için hangi biçimlendirmenin kullanıldığını etkiler. Bu paylaşılan yerel nesnenin ActionScript 2.0 veya 1.0 SWF dosyaları tarafından okunabilir olması gerekiyorsa, objectEncoding öğesini ObjectEncoding.AMF0 olarak ayarlayın. Nesne kodlaması AMF3'ü yazacak şekilde ayarlanmış olsa da, Flash Player hala AMF0 paylaşılan yerel nesnelerini okuyabilir. Yani, bu özelliğin varsayılan değerini (ObjectEncoding.AMF3) kullanırsanız, SWF dosyanız hala ActionScript 2.0 veya 1.0 SWF dosyaları tarafından oluşturulmuş paylaşılan nesneleri okuyabilir.
  • Paylaşılan uzak nesneler. Sunucuya bağlandığında, paylaşılan uzak bir nesne objectEncoding ayarını ilgili NetConnection örneğinden (paylaşılan uzak nesneye bağlanmak için kullanılan örnek) miras alır. Sunucuya bağlı değilken, paylaşılan uzak bir nesne defaultObjectEncoding ayarını ilgili NetConnection örneğinden miras alır. Paylaşılan uzak nesnenin objectEncoding özelliğinin değeri NetConnection örneği tarafından belirlendiğinden, bu özellik paylaşılan uzak nesneler için salt okunurdur.



Uygulama
    public function get objectEncoding():uint
    public function set objectEncoding(value:uint):void

Atar
ReferenceError — Paylaşılan bir uzak nesne üzerinde objectEncoding özelliğinin değerini ayarlamayı denediniz. Değer ilgili NetConnection örneği tarafından belirlendiğinden, bu özellik paylaşılan uzak nesneler için salt okunurdur.

İlgili API Öğeleri

    

preventBackup

özellik 
preventBackup:Boolean

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

Yerel olarak paylaşılan nesnelerin iOS bulut yedekleme hizmetinde yedeklenip yedeklenmeyeceğini belirtir.

true veya false şeklinde belirtin:

  • true - Yerel olarak paylaşılan tüm nesnelerin iOS yedekleme bulut hizmetinde yedeklenmesini önler.
  • false (varsayılan) - Yerel olarak paylaşılan nesneler, iOS yedekleme bulut hizmetinde yedeklenir.

Bu özellik, yalnızca yerel olarak paylaşılan nesneler için geçerlidir ve yalnızca iOS içindir.



Uygulama
    public static function get preventBackup():Boolean
    public static function set preventBackup(value:Boolean):void

size

özellik 
size:uint  [salt okunur]

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

Paylaşılan nesnenin bayt olarak geçerli boyutu.

Flash, tüm data özelliklerine gözatarak paylaşılan nesnenin boyutunu hesaplar; nesnenin data özellikleri ne kadar fazlaysa boyutunu hesaplamak da o kadar zaman alır. Nesne boyutunun tahmin edilmesi önemli miktarda işleme süresi gerektirebilir. Bu nedenle, belirli bir ihtiyacınız olmadığı sürece bu yöntemi kullanmamak isteyebilirsiniz.



Uygulama
    public function get size():uint

Örnek  ( Bu örnek nasıl kullanılır? )
Şu kod "thehobbit" adlı bir kimlik kullanan SharedObject oluşturur. username adlı bir özellik SharedObject nesnesinin data özelliğine eklenir. Ardından size özelliği izlenir ve gösterilen değeri döndürür.
import flash.net.SharedObject;

// if these get copied or not
var mySo:SharedObject = SharedObject.getLocal("thehobbit");
mySo.data.username = "bilbobaggins";
trace(mySo.size); // 55
Yöntem Ayrıntısı

clear

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

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

Paylaşılan yerel nesneler için, tüm verileri temizler ve paylaşılan nesneyi diskten siler. Paylaşılan nesneye yapılan başvuru hala etkindir ancak data özellikleri silinir.

Flash Media Server ile kullanılan paylaşılan uzak nesnelerde, clear() öğesi nesnenin bağlantısını keser ve tüm verileri temizler. Paylaşılan nesne yerel olarak kalıcıysa, bu yöntem ayrıca paylaşılan nesneyi diskten siler. Paylaşılan nesneye yapılan başvuru hala etkindir ancak data özellikleri silinir.


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

Aşağıdaki kod, hostName değerine sahip bir kimlik kullanan bir SharedObject nesnesi oluşturur (ve sonraki çalışmalarda alır). username adlı bir özellik SharedObject nesnesinin data özelliğine eklenir. clear() öğesi sonunda çağrılır ve veri nesnesine eklenmiş olan tüm bilgileri siler (bu durumda username adlı tek bir özelliktir).
package {
    import flash.net.SharedObject;

    public class SharedObject_clear {
        private var hostName:String = "yourDomain";
        private var username:String = "yourUsername";

        public function SharedObject_clear() {
            var mySo:SharedObject = SharedObject.getLocal(hostName);
            if(mySo.data.username == null) {
                mySo.data.username = username;
                trace("set: " + mySo.data.username); // yourUsername
            }
            else {
                mySo.clear();
                trace("cleared: " + mySo.data.username); // undefined
            }
        }
    }
}

close

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

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

Paylaşılan bir uzak nesne ile sunucu arasındaki bağlantıyı kapatır. Paylaşılan bir uzak nesne yerel olarak kalıcıysa, bu yöntem çağrıldıktan sonra kullanıcı, nesnenin yerel kopyası üzerinde değişiklikler yapabilir. Yerel nesne üzerinde yapılan tüm değişikler, kullanıcının paylaşılan uzak nesneye bir sonraki bağlanışında sunucuya gönderilir.

connect

()yöntem 
public function connect(myConnection:NetConnection, params:String = null):void

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

Belirtilen bir NetConnection nesnesi üzerinden bir sunucu üzerindeki paylaşılan uzak bir nesneye bağlanır. getRemote() öğesini çağırdıktan sonra bu yöntemi kullanın. Bağlantı başarılı olduğunda syncolayı gönderilir.

Uzak bir paylaşılan nesneyle birlikte çalışmayı denemeden önce ilk olarak try..catch..finally ifadesini kullanarak herhangi bir hata olup olmadığını kontrol edin. Ardından, paylaşılan nesne üzerinde herhangi bir değişiklik yapmadan önce sync olayını dinleyin ve işleyin. sync olayı gönderilmeden yapılan tüm değişiklikler kaybedilebilir.

Örneğin paylaşılan uzak bir nesneye bağlanmak için connect() yöntemini çağırın.

     var myRemoteSO:SharedObject = SharedObject.getRemote("mo", myNC.uri, false);
     myRemoteSO.connect(myNC);
     

Parametreler

myConnection:NetConnection — Flash Media Server ile iletişim kurmak için kullanılan bir NetConnection gibi Gerçek Zamanlı Mesajlaşma Protokolü (RTMP) kullanan bir NetConnection nesnesi.
 
params:String (default = null) — Sunucu üzerindeki paylaşılan uzak nesneye iletilecek bir mesajı tanımlayan bir dize. Flash Media Server ile kullanılamaz.


Atar
Error — Flash Player belirtilmiş paylaşılan uzak nesneye bağlanamadı. NetConnection örneğinin geçerli ve bağlı olduğunu ve paylaşılan uzak nesnenin sunucu üzerinde başarılı bir şekilde oluşturulduğunu doğrulayın.

İlgili API Öğeleri

flush

()yöntem 
public function flush(minDiskSpace:int = 0):String

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

Yerel bir dosyaya hemen yerel olarak kalıcı, paylaşılan bir nesne yazar. Bu yöntemi kullanmıyorsanız, paylaşılan nesne oturumu sona erdiğinde yani, SWF dosyası kapatıldığında, kendisine bir başvuru olmadığı için paylaşılan nesne çöpe toplama işlemine tabi tutulduğunda veya SharedObject.clear() veya SharedObject.close() yöntemini çağırdığınızda Flash Player, paylaşılan nesneyi bir dosyaya yazar.

Bu yöntem SharedObjectFlushStatus.PENDING öğesini döndürürse, Flash Player, kullanıcıdan bu etki alanından gelen nesnelere yönelik disk alanı miktarını artırmasını isteyen bir iletişim kutusu görüntüler. Daha sonra kaydedildiğinde paylaşılan nesneye yönelik alanın artmasını sağlamak için (PENDING dönüş değerlerini önler) minDiskSpace için bir değer iletin. Flash Player dosyayı yazmaya çalıştığında, paylaşılan nesneyi geçerli boyutunda kaydetmek için yeterli alan aramak yerine minDiskSpace öğesine iletilen bayt sayısını arar.

Örneğin, paylaşılan bir nesnenin maksimum boyutunun 500 bayt olmasını bekliyorsanız, başlangıç boyutu daha küçük olsa da minDiskSpace için 500 değerini iletin. Flash kullanıcıdan paylaşılan nesne için disk alanı ayırmasını isterse bu miktar 500 bayt olur. Kullanıcı istenen alan miktarını ayırdıktan sonra, daha sonra yapılacak olan nesne boşaltma denemelerinde Flash'ın daha fazla disk alanı istemesine gerek kalmaz (boyutu 500 baytı aşmadığı sürece).

Kullanıcı, iletişim kutusuna yanıt verdikten sonra bu yöntem yeniden çağrılır. SharedObject.Flush.Success veya SharedObject.Flush.Failed code özelliğiyle birlikte bir netStatus olayı gönderilir.

Parametreler

minDiskSpace:int (default = 0) — Bu nesne için ayrılması gereken bayt olarak minimum disk alanı.

Döndürür
String — Şu değerlerden biri:
  • SharedObjectFlushStatus.PENDING: Kullanıcı bu etki alanından gelen nesneler için yerel bilgi saklamasına izin vermiştir ancak ayrılan alan miktarı, nesnenin saklanması için yeterli değildir. Flash Player kullanıcıdan daha fazla alan ayırmasını ister. Kaydedildiğinde paylaşılan nesneye yönelik alana izin vermek ve böylece SharedObjectFlushStatus.PENDING dönüş değerini önlemek için minDiskSpace öğesine yönelik bir değer iletin.
  • SharedObjectFlushStatus.FLUSHED: Paylaşılan nesne, yerel disk üzerindeki bir dosyaya başarılı bir şekilde yazılmıştır.

Atar
Error — Flash Player, paylaşılan nesneyi diske yazamıyor. Bu hata, kullanıcı bu etki alanından gelen nesnelere yönelik yerel bilgi saklamayı kalıcı olarak yasakladıysa meydana gelebilir.

Not: Üçüncü taraf paylaşılan nesnelerin diske yazılmasına izin verilmese de yerel içerik her zaman üçüncü taraf etki alanlarından (geçerli tarayıcı adres çubuğundaki etki alanının dışındaki etki alanları) gelen paylaşılan nesneleri yazabilir.

İlgili API Öğeleri


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

Aşağıdaki kod, hostName değerine sahip bir kimlik kullanan bir SharedObject nesnesi oluşturur (ve sonraki çalışmalarda alır). username adlı bir özellik SharedObject nesnesinin data özelliğine eklenir. Ardından flush() yöntemi çağrılır ve bunu pending dizesinin veya true ya da false boolean değerinin döndürülüp döndürülmediğini görmek için yapılan bir kontrol izler. Flash Player'ın geçerli örneği her kapatıldığında açık tüm SharedObject örneklerinin otomatik olarak boşaltılacağını unutmayın.
package {
    import flash.net.SharedObject;

    public class SharedObject_flush {
        private var hostName:String = "yourDomain";
        private var username:String = "yourUsername";

        public function SharedObject_flush() {
            var mySo:SharedObject = SharedObject.getLocal(hostName);
            mySo.data.username = username;
            var flushResult:Object = mySo.flush();
            trace("flushResult: " + flushResult);
            trace(mySo.data.username); // yourUsername
        }
    }
}

getLocal

()yöntem 
public static function getLocal(name:String, localPath:String = null, secure:Boolean = false):SharedObject

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

Sadece geçerli istemcinin kullanabildiği yerel olarak kalıcı paylaşılan bir nesneye başvuru döndürür. Paylaşılan nesne önceden mevcut değilse bu yöntem bir tane oluşturur. getLocal() öğesine iletilen herhangi bir değer geçersizse veya çağrı başarısız olursa, Flash Player bir istisna atar.

Şu kod, döndürülmüş paylaşılan nesne başvurusunu bir değişkene nasıl atayacağınızı gösterir:

var so:SharedObject = SharedObject.getLocal("savedData");

Not: Kullanıcı bu etki alanının hiçbir zaman yerel olarak saklanmasına izin verilmemesini seçtiyse, localPath için bir değer belirtilse de nesne yerel olarak kaydedilmez. Bu kurala yönelik istisna yerel içeriktir. Üçüncü taraf paylaşılan nesnelerin diske yazılmasına izin verilmese de yerel içerik her zaman üçüncü taraf etki alanlarından (geçerli tarayıcı adres çubuğundaki etki alanının dışındaki etki alanları) gelen paylaşılan nesneleri yazabilir.

Ad çakışmalarını önlemek için Flash, paylaşılan nesneyi oluşturan SWF dosyasının konumuna bakar. Örneğin www.myCompany.com/apps/stockwatcher.swf konumundaki bir SWF dosyası portfolio adlı bir paylaşılan nesne oluşturursa, SWF dosyaları farklı dizinlerden geldiği için bu paylaşılan nesne, www.yourCompany.com/photoshoot.swf konumundaki portfolio adlı başka bir nesneyle çakışmaz.

localPath parametresi isteğe bağlı olsa da, özellikle başka SWF dosyalarının paylaşılan nesneye erişmesi gerekiyorsa kullanımı konusunda dikkatli olmalısınız. Paylaşılan nesnenin içindeki veriler, başka bir konuma taşınmayacak bir SWF dosyasına özgüyse, varsayılan değerin kullanılması mantıklıdır. Diğer SWF dosyalarının paylaşılan nesneye erişmesi gerekiyorsa veya paylaşılan nesneyi oluşturan SWF dosyası daha sonra taşınacaksa, bu parametrenin değeri, paylaşılan nesneye nasıl erişileceğini etkiler. Örneğin, localPath öğesi, SWF dosyasına giden tam yolun varsayılan değerine ayarlanmış durumdayken bir paylaşılan nesne oluşturursanız, başka bir SWF dosyası bu paylaşılan nesneye erişemez. Orijinal SWF dosyasını daha sonra başka bir konuma taşırsanız, SWF dosyası bile paylaşılan nesnede saklanan verilere erişemez.

Farkında olmadan paylaşılan bir nesneye olan erişimin kısıtlanmasını önlemek için localpath parametresini kullanın. En iyi şekilde izin veren yaklaşım localPath öğesini / (eğik çizgi) olarak ayarlamaktır. Böylece paylaşılan nesne, etki alanındaki tüm SWF dosyaları tarafından kullanılabilir ancak, etki alanındaki diğer paylaşılan nesnelerle ad çakışması ihtimali artar. Daha kısıtlayıcı bir yaklaşım localPath öğesini, SWF dosyasına giden tam yolun içinde bulunan klasör adlarına eklemektir. Örneğin www.myCompany.com/apps/stockwatcher.swf, konumunda SWF dosyası tarafından oluşturulmuş bir portfolio paylaşılan nesnesi için localPath parametresini /, /apps veya /apps/stockwatcher.swf olarak ayarlayabilirsiniz. Hangi yaklaşımın uygulamanız için en iyi düzeyde esneklik sağladığını belirlemelisiniz.

Bu yöntemi kullanırken, aşağıdaki güvenlik modelini göz önünde bulundurun:

  • Sanal alan sınırları arasındaki paylaşılan nesnelere erişemezsiniz.
  • Kullanıcılar Flash Player Settings (Flash Player Ayarları) iletişim kutusunu veya Settings Manager'ı (Ayarlar Yöneticisi) kullanarak paylaşılan nesne erişimini kısıtlayabilir. Varsayılan olarak, etki alanı başına 100 KB'a kadar veriden oluşan paylaşılan nesneler oluşturabilir. Yöneticiler ve kullanıcılar ayrıca dosya sistemine yazma konusunda kısıtlamalar getirebilir.

Yerel dosyalar olarak oynatılacak (yerel olarak yüklenmiş SWF dosyaları veya EXE dosyaları) SWF dosyası içeriği yayınlayacağınızı düşünün. Bunun için birden fazla yerel SWF dosyasından belirli bir paylaşılan nesneye erişmeniz gerekir. Bu durumda, yerel dosyalarda, paylaşılan nesneleri saklamak için iki farklı konumun kullanılabileceğini unutmayın. Kullanılan etki alanı, paylaşılan nesneyi oluşturan yerel dosyaya verilen güvenlik izinlerine bağlıdır. Yerel dosyalarda üç farklı düzeyde izin vardır:

  1. Yalnızca yerel dosya sistemine erişim.
  2. Yalnızca ağa erişim.
  3. Ağa ve yerel dosya sistemine erişim.

Yerel dosya sistemine erişime sahip (düzey 1 veya 3) yerel dosyalar, paylaşılan nesnelerini bir konumda saklar. Yerel dosya sistemine erişime sahip olmayan (düzey 2) yerel dosyalar, paylaşılan nesnelerini başka bir konumda saklar.

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.

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

Parametreler

name:String — Nesnenin adı. Ad sağa doğru eğik çizgiler (/) içerebilir; Örneğin, work/addresses geçerli bir addır. Paylaşılan nesne adında boşluklara ve şu karakterlere izin verilmez:
  ~ % & \ ; : " ' , < > ? # 
  
 
localPath:String (default = null) — Paylaşılan nesneyi oluşturan SWF dosyasına giden ve paylaşılan nesnenin yerel olarak nerede saklanacağını belirleyen tam veya kısmi yol. Bu parametreyi belirtmezseniz tam yol kullanılır.
 
secure:Boolean (default = false) — Bu paylaşılan nesneye erişimin, bir HTTPS bağlantısı üzerinden teslim edilen SWF dosyalarıyla kısıtlı olup olmadığını belirler. SWF dosyanız HTTPS üzerinden teslim edilirse bu parametrenin değeri şu etkilere sahip olur:
  • Bu parametre true olarak ayarlanırsa, Flash Player yeni bir güvenli paylaşılan dosya oluşturur ve varolan bir güvenli paylaşılan nesneye yapılan bir başvuruyu alır. Bu güvenli paylaşılan nesne, yalnızca secure parametresi true olarak ayarlanmış SharedObject.getLocal() öğesini çağıran HTTPS üzerinden teslim edilen SWF dosyaları tarafından okunabilir veya yazılabilir.
  • Bu parametre false olarak ayarlanmışsa, Flash Player yeni bir paylaşılan nesne oluşturur veya HTTPS olmayan bağlantılar üzerinden teslim edilen SWF dosyaları tarafından okunabilen veya yazılabilen mevcut paylaşılan nesne için bir başvuru alır.

SWF dosyanız HTTPS olmayan bir bağlantı üzerinden teslim edilirse ve bu parametreyi true olarak ayarlamaya çalışırsanız, yeni bir paylaşılan nesnenin oluşturulması (veya daha önceden oluşturulmuş paylaşılan güvenli nesne) başarısız olur ve null değeri döndürülür. Bu parametrenin değerine bakılmaksızın, oluşturulmuş paylaşılan nesnelerin sayısı, bir etki alanı için izin verilen toplam disk alanı miktarı kadar olabilir.

Şu şema secure parametresinin kullanımını göstermektedir:

Paylaşılan güvenli nesne şeması

Döndürür
SharedObject — Yerel olarak kalıcı olan bir paylaşılan nesneye yapılan ve yalnızca geçerli istemci tarafından kullanılabilen bir başvuru. Flash Player paylaşılan nesneyi oluşturamazsa veya bulamazsa (örneğin, localPath belirtilmişse ancak böyle bir dizin mevcut değilse), bu yöntem bir istisna atar.

Atar
Error — Flash Player herhangi bir nedenden ötürü paylaşılan nesneyi oluşturamıyor. Bu hata, kalıcı paylaşılan nesne oluşturma ve üçüncü taraf Flash içeriği tarafından saklama yasaklanmışsa meydana gelebilir (yerel içerik için geçerli değildir). Kullanıcılar, http://www.adobe.com/support/documentation/en/flashplayer/help/settings_manager03.html konumunda bulunan Settings Manager'ın (Ayar Yöneticisi) Global Storage Settings (Global Saklama Ayarları) panelindeki üçüncü taraf kalıcı paylaşılan nesneleri yasaklayabilir.

getRemote

()yöntem 
public static function getRemote(name:String, remotePath:String = null, persistence:Object = false, secure:Boolean = false):SharedObject

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

Flash Media Server üzerinde bulunan ve birden fazla istemcinin erişebildiği paylaşılan bir nesneye bir başvuru döndürür. Paylaşılan uzak nesne önceden mevcut değilse bu yöntem bir tane oluşturur.

Paylaşılan bir uzak nesne oluşturmak için, getRemote() öğesini ve ardından paylaşılan uzak nesneyi şu şekilde sunucuya yüklemek için connect() öğesini çağırın:

     var nc:NetConnection = new NetConnection();
     nc.connect("rtmp://somedomain.com/applicationName");
     var myRemoteSO:SharedObject = SharedObject.getRemote("mo", nc.uri, false);
     myRemoteSO.connect(nc);
     

Paylaşılan nesnenin yerel ve uzak kopyalarının senkronize olduğunu doğrulamak için sync olayını dinleyin ve işleyin. Bu nesneyi paylaşmak isteyen tüm istemciler name ve remotePath parametreleri için aynı değerleri iletmelidir.

Yalnızca geçerli istemci tarafından kullanılabilen bir paylaşılan nesne oluşturmak için SharedObject.getLocal() öğesini kullanın.

Parametreler

name:String — Paylaşılan uzak nesnenin adı. Ad sağa doğru eğik çizgiler (/) içerebilir; örneğin, work/addresses geçerli bir addır. Paylaşılan nesne adında boşluklara ve şu karakterlere izin verilmez:
    ~ % & \ ; :  " ' , > ? ? #
 
remotePath:String (default = null) — Paylaşılan nesnenin saklanacağı sunucunun URI'si. Bu URI, connect() yöntemine iletilen NetConnection nesnesinin URI'si ile aynı olmalıdır.
 
persistence:Object (default = false) — Paylaşılan nesnenin data özelliğinin niteliklerinin yerel olarak, uzak olarak veya her iki şekilde de kalıcı olduğunu belirtir. Bu parametre ayrıca, paylaşılan nesnenin yerel olarak nerede saklanacağını belirtebilir. Kabul edilebilir değerler şu şekildedir:
  • Bir false değeri, paylaşılan nesnenin istemci veya sunucu üzerinde kalıcı olmadığını belirtir.
  • Bir true değeri, paylaşılan nesnenin yalnızca sunucu üzerinde kalıcı olduğunu belirtir.
  • Paylaşılan nesneye giden tam veya kısmi bir yol, paylaşılan nesnenin istemci ve sunucu üzerinde kalıcı olduğunu gösterir. İstemci üzerinde, belirtilen yolda saklanır; sunucu üzerinde ise uygulama dizini içerisindeki alt dizinde saklanır.

Not: Kullanıcı bu etki alanının hiçbir zaman yerel olarak saklanmasına izin verilmemesini seçtiyse, kalıcılık için yerel bir yol belirtilse de nesne yerel olarak kaydedilmez. Daha fazla bilgi için sınıf açıklamasına bakın.

 
secure:Boolean (default = false) — Bu paylaşılan nesneye erişimin, bir HTTPS bağlantısı üzerinden teslim edilen SWF dosyalarıyla kısıtlı olup olmadığını belirler. Daha fazla bilgi için, getLocal yöntemi girişindeki secure parametresinin açıklamasına bakın.

Döndürür
SharedObject — Birden çok istemci arasında paylaşılabilen nesneye yapılan bir başvuru.

Atar
Error — Flash Player, paylaşılan dosyayı oluşturamıyor veya bulamıyor. Bu durum, remotePath ve persistence parametreleri için mevcut olmayan yollar belirtilmişse meydana gelebilir.

İlgili API Öğeleri

send

()yöntem 
public function send(... arguments):void

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

Belirtilmiş paylaşılan uzak nesneye bağlı tüm istemcilere, mesajı gönderen istemci de dahil olmak üzere bir mesaj yayımlar. Mesajı işlemek veya yanıtlamak için paylaşılan nesneye ekli bir geri çağırma işlevi oluşturun.

Parametreler

... arguments — Bir veya daha fazla argüman: Mesajı, paylaşılan nesneye eklenecek bir veya daha fazla işleyici işlevini ve herhangi bir türdeki isteğe bağlı parametreleri tanımlayan bir dize. İşleyici adı yalnızca bir düzey derinliğinde olabilir (yani, üst öğe/alt öğe biçiminde olamaz) ve paylaşılan nesneyle ilgilidir. Argümanlar serileştirilir, bağlantı üzerinden gönderilir ve alıcı işleyicisi bu öğeleri aynı sırada alır. Parametre dairesel bir nesneyse (örneğin dairesel olan bağlı bir liste), sıralandırıcı başvuruları doğru bir şekilde işler.

Not: İşlev adları için ayrılmış bir terim kullanmayın. Örneğin, myRemoteSO.send("close") başarısız olacaktır.

setDirty

()yöntem 
public function setDirty(propertyName:String):void

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

Sunucuya, paylaşılan nesnedeki (data özelliği ile tanımlanan) bir özelliğinin değerinin değiştiğini gösterir. Bu yöntem, özellikleri değiştirilmiş anlamına gelen dirty şeklinde işaretler.

Paylaşılan bir nesneye yönelik özellikler oluşturmak için SharedObject.setProperty() öğesini çağırın.

SharedObject.setProperty() yöntemi setDirty() öğesini uygular. Bir özelliğin değerinin String veya Number gibi temel bir tür olması gibi birçok durumda, setDirty() öğesini çağırmak yerine setProperty() öğesini çağırabilirsiniz. Ancak bir nesnenin değeri, kendi özelliklerini içeren bir nesneyse nesne içerisindeki bir değerin değiştiğini göstermek için setDirty() öğesini çağırın.

Parametreler

propertyName:String — Değişen özelliğin adı.

İlgili API Öğeleri

setProperty

()yöntem 
public function setProperty(propertyName:String, value:Object = null):void

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

Paylaşılan bir nesnedeki özelliğin değerini günceller ve sunucuya özelliğin değerinin değiştiğini gösterir. setProperty() yöntemi özellikleri açık bir biçimde changed veya dirty olarak işaretler.

Paylaşılan uzak nesneler hakkında daha fazla bilgi için Flash Media Server belgelerine bakın.

Not: SharedObject.setProperty() yöntemi, setDirty() yöntemini uygular. Bir özelliğin değerinin String veya Number gibi temel bir tür olması gibi birçok durumda, setDirty öğesini çağırmak yerine setProperty() öğesini kullanın. Ancak, bir nesnenin değeri, kendi özelliklerini içeren bir nesneyse nesne içerisindeki bir değerin değiştiğini göstermek için setDirty() öğesini kullanın. setProperty() bir özellik değerini yalnızca değer değiştiğinde güncellerken setDirty() tüm abone istemciler üzerinde senkronizasyonu zorladığından, genellikle setDirty() yerine setProperty() öğesini çağırmanız işe yarayabilir.

Parametreler

propertyName:String — Paylaşılan nesnedeki özelliğin adı.
 
value:Object (default = null) — Özelliği silmek için kullanılan özellik değeri (bir ActionScript nesnesi) veya null.

İlgili API Öğeleri

Olay Ayrıntısı

asyncError

Olay
Olay Nesne Türü: flash.events.AsyncErrorEvent
özellik AsyncErrorEvent.type = flash.events.AsyncErrorEvent.ASYNC_ERROR

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

Eşzamansız olarak, yani yerel eşzamansız koddan bir istisna atıldığında gönderilir.

AsyncErrorEvent.ASYNC_ERROR sabiti, bir asyncError 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.
targetOlayı gönderen nesne.
errorOlayı tetikleyen hata.

netStatus

Olay  
Olay Nesne Türü: flash.events.NetStatusEvent
özellik NetStatusEvent.type = flash.events.NetStatusEvent.NET_STATUS

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

Bir SharedObject örneği durumunu veya hata koşulunu bildirdiğinde gönderilir. netStatus olayı bir info özelliği içerir. Bu özellik, bir bağlantı denemesinin başarılı olup olmadığı veya paylaşılan nesnenin yerel diske başarılı bir şekilde yazılıp yazılmadığı gibi olay hakkında belirli bilgiler içeren bir bilgi nesnesidir.

Bir netStatus 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.
infoNesnenin durumunu veya hata koşulunu açıklayan özellikleri olan bir nesne.
targetDurumunu bildiren NetConnection veya NetStream nesnesi.

İlgili API Öğeleri

sync

Olay  
Olay Nesne Türü: flash.events.SyncEvent
özellik SyncEvent.type = flash.events.SyncEvent.SYNC

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

Uzaktan paylaşılan bir nesne sunucu tarafından güncellendiğinde gönderilir.

Bir sync 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.
changeListDizenin durumunu açıklayan özellikleri içeren bir dizi.
targetSunucu tarafından güncellenen SharedObject örneği.

İlgili API Öğeleri

SharedObjectExample.as

Şu kod, Kimlik "application-name" öğesini kullanarak paylaşılan bir nesne oluşturur (ve sonraki çalıştırmalarda alır). Kaydet düğmesi tıklatıldığında, saveValue() yöntemi, savedValue adlı bir özelliği SharedObject nesnesinin data özelliğine kaydetmeye çalışır. Flash Player'ın verileri kaydetmek için izin istemesi gerekiyorsa, kullanıcı izin verdiğinde veya reddettiğinde onFlushStatus() yöntemi çağrılır. Temizle düğmesi tıklatıldığında, clearValue() yöntemi, savedValue öğesinde kaydedilen değeri siler; SWF dosyası bir sonraki kez yüklendiğinde alınan değer undefined olur.
package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.events.NetStatusEvent;
    import flash.net.SharedObject;
    import flash.net.SharedObjectFlushStatus;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.text.TextFieldType;
    
    public class SharedObjectExample extends Sprite {
        
        private var mySo:SharedObject;
        
        public function SharedObjectExample() {
            buildUI();
            saveBtn.addEventListener(MouseEvent.CLICK, saveValue);
            clearBtn.addEventListener(MouseEvent.CLICK, clearValue);
            
            mySo = SharedObject.getLocal("application-name");
            output.appendText("SharedObject loaded...\n");
            output.appendText("loaded value: " + mySo.data.savedValue + "\n\n");
        }

         private function saveValue(event:MouseEvent):void {
            output.appendText("saving value...\n");
            mySo.data.savedValue = input.text;
            
            var flushStatus:String = null;
            try {
                flushStatus = mySo.flush(10000);
            } catch (error:Error) {
                output.appendText("Error...Could not write SharedObject to disk\n");
            }
            if (flushStatus != null) {
                switch (flushStatus) {
                    case SharedObjectFlushStatus.PENDING:
                        output.appendText("Requesting permission to save object...\n");
                        mySo.addEventListener(NetStatusEvent.NET_STATUS, onFlushStatus);
                        break;
                    case SharedObjectFlushStatus.FLUSHED:
                        output.appendText("Value flushed to disk.\n");
                        break;
                }
            }
            output.appendText("\n");
        }
        
        private function clearValue(event:MouseEvent):void {
            output.appendText("Cleared saved value...Reload SWF and the value should be \"undefined\".\n\n");
            delete mySo.data.savedValue;
        }
        
        private function onFlushStatus(event:NetStatusEvent):void {
            output.appendText("User closed permission dialog...\n");
            switch (event.info.code) {
                case "SharedObject.Flush.Success":
                    output.appendText("User granted permission -- value saved.\n");
                    break;
                case "SharedObject.Flush.Failed":
                    output.appendText("User denied permission -- value not saved.\n");
                    break;
            }
            output.appendText("\n");

            mySo.removeEventListener(NetStatusEvent.NET_STATUS, onFlushStatus);
        }
        
        // UI elements
        private var inputLbl:TextField;
        private var input:TextField;
        private var output:TextField;
        private var saveBtn:Sprite;
        private var clearBtn:Sprite;
    
        private function buildUI():void {
            // input label
            inputLbl = new TextField();
            addChild(inputLbl);
            inputLbl.x = 10;
            inputLbl.y = 10;
            inputLbl.text = "Value to save:";
            
            // input TextField
            input = new TextField();
            addChild(input);
            input.x = 80;
            input.y = 10;
            input.width = 100;
            input.height = 20;
            input.border = true;
            input.background = true;
            input.type = TextFieldType.INPUT;
            
            // output TextField
            output = new TextField();
            addChild(output);
            output.x = 10;
            output.y = 35;
            output.width = 250;
            output.height = 250;
            output.multiline = true;
            output.wordWrap = true;
            output.border = true;
            output.background = true;
            
            // Save button
            saveBtn = new Sprite();
            addChild(saveBtn);
            saveBtn.x = 190;
            saveBtn.y = 10;
            saveBtn.useHandCursor = true;
            saveBtn.graphics.lineStyle(1);
            saveBtn.graphics.beginFill(0xcccccc);
            saveBtn.graphics.drawRoundRect(0, 0, 30, 20, 5, 5);
            var saveLbl:TextField = new TextField();
            saveBtn.addChild(saveLbl);
            saveLbl.text = "Save";
            saveLbl.selectable = false;
            
            // Clear button
            clearBtn = new Sprite();
            addChild(clearBtn);
            clearBtn.x = 230;
            clearBtn.y = 10;
            clearBtn.useHandCursor = true;
            clearBtn.graphics.lineStyle(1);
            clearBtn.graphics.beginFill(0xcccccc);
            clearBtn.graphics.drawRoundRect(0, 0, 30, 20, 5, 5);
            var clearLbl:TextField = new TextField();
            clearBtn.addChild(clearLbl);
            clearLbl.text = "Clear";
            clearLbl.selectable = false;
        }
    }
}




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