用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: AIR 30.0 和更早版本, Flash Player 30.0 和更早版本, Flash Lite 4
Flex 4.6 和更早版本, Flash Pro CS6 和更早版本
隐藏过滤条件
顶级 

XML  - AS3

x

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

语言元素

全局常量
全局函数
运算符
语句、关键字和指令
特殊类型

附录

新增内容
编译器错误
编译器警告
运行时错误
迁移到 ActionScript 3
支持的字符集
仅适用于 MXML 的标签
Motion XML 元素
Timed Text 标记
不推荐使用的元素的列表
AccessibilityImplementation 常量
如何使用 ActionScript 示例
法律声明

x

AAAARecord    
AbandonCommand
ABRUtils
AbstractConsumer
AbstractEntityMetadata
AbstractEvent
AbstractInvoker
AbstractMessage
AbstractOperation
AbstractOperation
AbstractParticipant
AbstractProducer
AbstractSearchFilterVO
AbstractService
AbstractServiceWrapper
AbstractStage
AbstractTarget
AbstractWebService
AccConst
Accelerometer
AccelerometerEvent
Accessibility
AccessibilityImplementation
AccessibilityProperties
AccessibleButton
AccessibleText
AccessPrivileges
AccImpl
AccImpl
Accordion
AccordionAutomationImpl
AccordionHeader
AccordionHeaderAccImpl
AccordionHeaderSkin
AccordionHeaderSkin
AccordionHeaderSkin
AccordionNav
AccordionSkin
AcknowledgeMessage
ACMRelationshipManager
ActionBar
ActionBar    
ActionBarButtonSkinBase
ActionBarDefaultButtonAppearance    
ActionBarSkin    
ActionEffectInstance
ActionRenderer
ActionScriptVersion
ActionSelectedEvent
ActivationBrowser
ActivatorSkin
ActiveContentEvent
ActiveDataEvent
ActivityEvent
ActualBitrateMetric
AddAction
AddActionInstance
AddApprovalStageParticipant
AddAssetPopUp
AddChild
AddChildAction
AddChildActionInstance
AddCreatorDialog
AddItemAction
AddItemActionInstance
AddItems
AddPanelButton
AddPanelEvent
AddRemoveEffectTargetFilter
AddReviewStageParticipant
AddServiceEvent
AddStageParticipant
AddTileEvent
AddViewEvent
AddViewManagerEvent
AdjustColor
AdvanceDataElementsPanel
AdvancedChannelSet
AdvancedDataGrid
AdvancedDataGridAccImpl
AdvancedDataGridAutomationImpl
AdvancedDataGridBase
AdvancedDataGridBaseEx
AdvancedDataGridBaseExAutomationImpl
AdvancedDataGridBaseSelectionData
AdvancedDataGridColumn
AdvancedDataGridColumnGroup
AdvancedDataGridDragProxy
AdvancedDataGridEvent
AdvancedDataGridEventReason
AdvancedDataGridGroupItemRenderer
AdvancedDataGridGroupItemRendererAutomationImpl
AdvancedDataGridHeaderHorizontalSeparator
AdvancedDataGridHeaderInfo
AdvancedDataGridHeaderRenderer
AdvancedDataGridHeaderShiftEvent
AdvancedDataGridItemRenderer
AdvancedDataGridItemRendererAutomationImpl
AdvancedDataGridItemSelectEvent
AdvancedDataGridListData
AdvancedDataGridRendererDescription
AdvancedDataGridRendererProvider
AdvancedDataGridSortItemRenderer
AdvancedListBase
AdvancedListBaseAutomationImpl
AdvancedListBaseContentHolderAutomationImpl
AdvancedSearchPod
AdvancedStyleClient
AfterUpSwitchBufferBandwidthRule
AggregatingToken
AggregatingTokenError
AirDragManagerAutomationHandler
AIREvent    
AirFunctionsHelper
Alert
AlertAccImpl
AlertAutomationImpl
AlertFormatter
AlertFormAutomationImpl
AlignmentArea
AllRuntimeSparkControls
AlternativeAudioEvent
AlternativeAudioTrait
AMFChannel
AndOperator
Animate
AnimateColor
AnimateColorInstance
AnimateFilter
AnimateFilterInstance
AnimateInstance
AnimateProperty
AnimatePropertyInstance
AnimateTransform
AnimateTransform3D
AnimateTransformInstance
AnimateTransitionShader
AnimateTransitionShaderInstance
Animation
Animator
Animator3D
AnimatorBase
AnimatorFactory
AnimatorFactory3D
AnimatorFactoryBase
AnimatorFactoryUniversal
AnimatorUniversal
AnnotationParseEvent
AntiAliasType
Application
Application
Application
ApplicationAutomationImpl
ApplicationBackground
ApplicationConstants
ApplicationControlBar
ApplicationDomain
ApplicationDomainTarget
ApplicationListItem
ApplicationSkin
ApplicationSkin
ApplicationSpecifier
ApplicationTitleBarBackgroundSkin    
ApplicationUpdater    
ApplicationUpdaterUI    
ApplyElementIDOperation
ApplyElementStyleNameOperation
ApplyElementTypeNameOperation
ApplyElementUserStyleOperation
ApplyFormatOperation
ApplyFormatToElementOperation
ApplyLinkOperation
ApplyTCYOperation
ApprovalStage
ApprovalStage
Approver
Approver
ApproverCollection
ApproverStatus
ApproverStatus
ApproverVO
AreaChart
AreaRenderer
AreaSeries
AreaSeriesAutomationImpl
AreaSeriesItem
AreaSeriesRenderData
AreaSet
ARecord    
ArgumentError
arguments
Array
ArrayCollection
ArrayList
ArrayUtil
ArrowDirection    
Asset
AssetAction
AssetAction
AssetActionCompleteEvent
AssetActionCompleteEvent
AssetActionEvent
AssetActionEvent
AssetActionsChangeEvent
AssetDetailsPod
AssetEvent
AssetExplorerServiceDelegate
AssetFocusEvent
AssetHandlerRegistry
AssetHandlerRegistry
AssetManager
AssetManager
AssetManagerView
AssetModel
AssetPod
AssetPropertiesEditor
AssetPropertyDescriptor
AssetPropertyDescriptor
AssetQueryServiceDelegate
AssetReviewPod
AssetTypeDescriptor
AssetTypeDescriptor
AssetValidationEvent
AssetValidationFaultType
AssetVersionPod
AssetVO
Assignment
AssignmentConstants
AsyncErrorEvent
AsyncListView
AsyncMessage
AsyncRequest
AsyncResponder
AsyncToken
AsyncTokenResponder
AsyncTokenWrapper
Attachment
AttachmentCommand
AttachmentEvent
AttachmentHeader
AttachmentHeaderBase
AttachmentHeaderModel
AttachmentIconRenderer
AttachmentIconRendererSkin
AttachmentInfo
AttachmentList
AttachmentList
AttachmentListComponent
AttachmentListModel
AttachmentListSkin
AttachmentLoader
AttachmentPermissions
Attachments
AttachmentsModel
Attribute
AudioDecoder
AudioDeviceManager
AudioElement
AudioEvent
AudioOutputChangeEvent
AudioOutputChangeReason
AudioPlaybackMode    
AudioTrait
AuditActionVO
AuditAttributeVO
AuditLevel
AuditLevel
AuditLevelVO
AuditManager
AuditMetaInfoVO
AuditModuleVO
Auditor
AugmentedError
AugmentedErrorEvent
AuthenticatingApplication
AuthenticationEvent
AuthenticationMethod
AuthFailureCode
AuthOptions
Author
AuthorStatus
AuthorVO
AuthResult
AuthStatus
AutoCapitalize    
AutoLayoutEvent
Automation
AutomationAirEvent
AutomationClass
AutomationDragEvent
AutomationDragEventWithPositionInfo
AutomationError
AutomationEvent
AutomationEventDescriptor
AutomationFlexNativeMenuEvent
AutomationHelper
AutomationID
AutomationIDPart
AutomationManager
AutomationMethodDescriptor
AutomationPropertyDescriptor
AutomationRecordEvent
AutomationReplayEvent
AvailablePropertyIterator
AvailableQualityLevelsMetric
AVDictionaryDataEvent
AverageAggregator
AVHTTPStatusEvent
AVLoader
AVM1Movie
AVNetworkingParams
AVPauseAtPeriodEndEvent
AVTagData
AVURLLoader
AVURLStream
AxisBase
AxisLabel
AxisLabelSet
AxisRenderer
AxisRendererAutomationImpl
AXMAccordion
AXMAccordionItemVO
AXMAccordionSegment
AXMBreadCrumb
AXMButton
AXMButtonBar
AXMButtonBarButton
AXMCheckBox
AXMComboBox
AXMDropDownList
AXMDropDownListBase
AXMEnterpriseAccordionSegmentSkin
AXMEnterpriseAccordionSkin
AXMEnterpriseAssetTabBar
AXMEnterpriseAssetTabBarButtonSkin
AXMEnterpriseAssetTabBarSkin
AXMEnterpriseAssetViewTabBar
AXMEnterpriseAssetViewTabBarButtonSkin
AXMEnterpriseAssetViewTabBarSkin
AXMEnterpriseBreadCrumbButtonSkin
AXMEnterpriseBreadCrumbFocusSkin
AXMEnterpriseBreadCrumbSkin
AXMEnterpriseButtonBarFirstButtonSkin
AXMEnterpriseButtonBarLastButtonSkin
AXMEnterpriseButtonBarMiddleButtonSkin
AXMEnterpriseButtonBarSkin
AXMEnterpriseButtonSkin
AXMEnterpriseCheckboxSkin
AXMEnterpriseCheckboxSmallSkin
AXMEnterpriseClosableTabBarButtonSkin
AXMEnterpriseClosableTabBarSkin
AXMEnterpriseCloseButtonSkin
AXMEnterpriseComboBoxButtonSkin
AXMEnterpriseComboBoxSkin
AXMEnterpriseComboBoxTextInputSkin
AXMEnterpriseDropDownListButtonSkin
AXMEnterpriseDropDownListItemRenderer
AXMEnterpriseDropDownListSkin
AXMEnterpriseFocusSkin
AXMEnterpriseFooterSkin
AXMEnterpriseGridHeaderRenderer
AXMEnterpriseGridSkin
AXMEnterpriseHeaderBarSkin
AXMEnterpriseHeaderButtonBar
AXMEnterpriseHScrollBarLargeSkin
AXMEnterpriseHScrollbarNoControlsSkin
AXMEnterpriseHScrollbarSkin
AXMEnterpriseHScrollbarThumbSkin
AXMEnterpriseHScrollbarTrackNoControlsSkin
AXMEnterpriseHScrollbarTrackSkin
AXMEnterpriseIconButtonSkin
AXMEnterpriseLargeButtonSkin
AXMEnterpriseLargeToggleButtonSkin
AXMEnterpriseNavigationButtonBarSkin
AXMEnterpriseNumericStepperDecrementButtonSkin
AXMEnterpriseNumericStepperIncrementButtonSkin
AXMEnterpriseNumericStepperSkin
AXMEnterpriseNumericStepperTextInputSkin
AXMEnterprisePanelSkin
AXMEnterpriseProgressSpinnerSkin
AXMEnterpriseQuietButtonSkin
AXMEnterpriseQuietHeaderBarButton
AXMEnterpriseQuietLargeButtonSkin
AXMEnterpriseQuietLargeDropDownListButtonSkin
AXMEnterpriseRadioButtonSkin
AXMEnterpriseResizeHandleSkin
AXMEnterpriseScrollDownArrowSkin
AXMEnterpriseScrollLeftArrowSkin
AXMEnterpriseScrollRightArrowSkin
AXMEnterpriseScrollUpArrowSkin
AXMEnterpriseSlideToggleButton
AXMEnterpriseSplitActionButtonSkin
AXMEnterpriseSplitActionPopUpButtonSkin
AXMEnterpriseSplitActionSkin
AXMEnterpriseTabBarButtonSkin
AXMEnterpriseTabBarSkin
AXMEnterpriseTextAreaSkin
AXMEnterpriseTextInputSkin
AXMEnterpriseTitleWindowSkin
AXMEnterpriseToggleButtonSkin
AXMEnterpriseToolBarBottomSkin
AXMEnterpriseToolBarButtonBarFirstButtonSkin
AXMEnterpriseToolBarButtonBarLastButtonSkin
AXMEnterpriseToolBarButtonBarMiddleButtonSkin
AXMEnterpriseToolbarButtonBarSkin
AXMEnterpriseToolBarTopSkin
AXMEnterpriseViewModeButtonBarButtonSkin
AXMEnterpriseViewModeButtonBarSkin
AXMEnterpriseVScrollbarNoControlsSkin
AXMEnterpriseVScrollbarSkin
AXMEnterpriseVScrollbarThumbSkin
AXMEnterpriseVScrollbarTrackNoControlsSkin
AXMEnterpriseVScrollbarTrackSkin
AXMHeaderBar
AXMHScrollBar
AXMLightItemRenderer
AXMList
AXMPopUp
AXMProgressBar
AXMProgressSpinner
AXMResizableContainer
AXMRichTextEditor
AXMRichTextEditorControlBar
AXMScroller
AXMSplitActionButton
AXMSwitch
AXMTabBar
AXMTabBarButton
AXMTitleWindow
AXMToggleButton
AXMToolPopUp
AXMToolPopUpDropDownController
AXMVerticalDivider
AXMVScrollBar
顶级
public final dynamic class XML
继承XML Inheritance Object

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9, Flash Lite 4

XML 类包含用于处理 XML 对象的方法和属性。XML 类(以及 XMLList、Namespace 和 QName 类)可实现 ECMAScript for XML (E4X) 规范(ECMA-357 第 2 版)中定义的强大的 XML 处理标准。

使用 toXMLString() 方法可返回 XML 对象的字符串表示形式,不管该 XML 对象具有简单内容还是复杂内容。

注意:ActionScript 2.0 中的 XML 类(以及相关类)已重命名为 XMLDocument 并移到 flash.xml 包中。它包含在 ActionScript 3.0 中,以实现向后兼容。

查看示例

了解详细信息

相关 API 元素



公共属性
 属性由以下参数定义
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  ignoreComments : Boolean
[静态] 确定当 XML 对象分析源 XML 数据时,是否忽略 XML 注释。
XML
  ignoreProcessingInstructions : Boolean
[静态] 确定当 XML 对象分析源 XML 数据时,是否忽略 XML 处理指令。
XML
  ignoreWhitespace : Boolean
[静态] 确定分析期间是否忽略文本节点开头和末尾处的空白字符。
XML
  prettyIndent : int
[静态] 确定当 XML.prettyPrinting 属性设置为 true 时,toString() 和 toXMLString() 方法所应用的缩进量。
XML
  prettyPrinting : Boolean
[静态] 确定 toString() 和 toXMLString() 方法是否对某些标签之间的空白字符进行规格化。
XML
公共方法
 方法由以下参数定义
  
XML(value:Object)
创建一个新的 XML 对象。
XML
  
可将命名空间添加到该 XML 对象所在范围的命名空间集中。
XML
  
将给定子项追加到该 XML 对象属性的末尾。
XML
  
attribute(attributeName:*):XMLList
返回其名称与 attributeName 参数相符的属性的 XML 值。
XML
  
返回给定 XML 对象的属性值列表。
XML
  
child(propertyName:Object):XMLList
列出 XML 对象的子项。
XML
  
确定该 XML 对象在其父项上下文中从 0 开始编制索引的位置。
XML
  
按 XML 对象的显示顺序列出其子项。
XML
  
列出包含 XML 注释的 XML 对象的属性。
XML
  
对比该 XML 对象与给定 value 参数。
XML
  
返回给定 XML 对象的副本。
XML
  
[静态] 返回一个下列属性设置为默认值的对象:ignoreComments、ignoreProcessingInstructions、ignoreWhitespace、prettyIndent 和 prettyPrinting。
XML
  
返回包含给定 name 参数的 XML 对象的所有后代(子级、孙级、曾孙级等)。
XML
  
列出某 XML 对象的元素。
XML
  
检查该 XML 对象是否包含复杂内容。
XML
  
检查该对象是否具有 p 参数所指定的属性。
XML
  
检查该 XML 对象是否包含简单内容。
XML
  
根据该 XML 对象的父项列出其命名空间。
XML
  
在该 XML 对象的 child1 参数后插入给定的 child2 参数并返回生成的对象。
XML
  
在该 XML 对象的 child1 参数前插入给定的 child2 参数并返回生成的对象。
XML
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
  
对于 XML 对象,该方法始终返回整数 1。
XML
  
提供该 XML 对象限定名称的本地名称部分。
XML
  
提供该 XML 对象的限定名称。
XML
  
namespace(prefix:String = null):*
如果没有提供参数,则提供与该 XML 对象的限定名关联的命名空间。
XML
  
在该 XML 对象的父项中列出与其关联的命名空间声明。
XML
  
指定节点的类型:文本、注释、处理指令、属性或元素。
XML
  
对于该 XML 对象以及所有子级 XML 对象,合并相邻文本节点并删除空文本节点。
XML
  
返回 XML 对象的父项。
XML
  
将提供的 child 对象的副本插入 XML 元素中,并放在该元素的任何现有 XML 属性前面。
XML
  
如果提供了 name 参数,则列出 XML 对象中包含带有该 name 的处理指令的所有子项。
XML
  
检查属性 p 所在的属性集是否可在应用于 XMLList 对象的 for..in 语句中遍历。
XML
  
删除该对象及其所有子级的给定命名空间。
XML
  
replace(propertyName:Object, value:XML):XML
用给定的 value 参数替换 propertyName 参数所指定的属性。
XML
  
用 value 参数中提供的指定 XML 属性集替换该 XML 对象的子属性。
XML
  
将该 XML 对象的本地名称更改为给定的 name 参数。
XML
  
将该 XML 对象的名称设置为给定限定名称或属性名。
XML
  
设置与该 XML 对象关联的命名空间。
XML
 Inherited
设置循环操作动态属性的可用性。
Object
  
[静态] 设置下列 XML 属性的值:ignoreComments、ignoreProcessingInstructions、ignoreWhitespace、prettyIndent 和 prettyPrinting。
XML
  
[静态] 检索下列属性:ignoreComments、ignoreProcessingInstructions、ignoreWhitespace、prettyIndent 和 prettyPrinting。
XML
  
返回 XML 对象用来表示 XML 文本节点的所有 XML 属性的 XMLList 对象。
XML
  
提供一种可覆盖的方法,用于在 XML 对象中自定义值的 JSON 编码。
XML
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
  
返回 XML 对象的字符串表示形式。
XML
  
返回 XML 对象的字符串表示形式。
XML
  
返回该 XML 对象。
XML
属性详细信息

ignoreComments

属性
ignoreComments:Boolean

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

确定当 XML 对象分析源 XML 数据时,是否忽略 XML 注释。默认情况下,将忽略注释 (true)。要包括 XML 注释,请将此属性设置为 falseignoreComments 属性仅在 XML 分析过程中使用,而不能在调用任何方法(例如,myXMLObject.child(*).toXMLString())时使用。如果源 XML 包含注释节点,可在 XML 分析过程中保留或丢弃这些节点。



实现
    public static function get ignoreComments():Boolean
    public static function set ignoreComments(value:Boolean):void

相关 API 元素


示例  ( 如何使用本示例 )
本示例演示将 XML.ignoreComments 设置为 false 以及设置为 true 的效果:
XML.ignoreComments = false;
var xml1:XML = 
        <foo>
            <!-- comment -->
        </foo>;
trace(xml1.toXMLString()); // <foo><!-- comment --></foo>

XML.ignoreComments = true;
var xml2:XML = 
        <foo>
            <!-- example -->
        </foo>;
trace(xml2.toXMLString()); // <foo/>

ignoreProcessingInstructions

属性 
ignoreProcessingInstructions:Boolean

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

确定当 XML 对象分析源 XML 数据时,是否忽略 XML 处理指令。默认情况下,将忽略处理指令 (true)。要包括 XML 处理指令,请将此属性设置为 falseignoreProcessingInstructions 属性仅在 XML 分析过程中使用,而不能在调用任何方法(例如,myXMLObject.child(*).toXMLString())时使用。如果源 XML 包含处理指令节点,可在 XML 分析过程中保留或丢弃这些节点。



实现
    public static function get ignoreProcessingInstructions():Boolean
    public static function set ignoreProcessingInstructions(value:Boolean):void

相关 API 元素


示例  ( 如何使用本示例 )
本示例演示将 XML.ignoreProcessingInstructions 设置为 false 以及设置为 true 的效果:
XML.ignoreProcessingInstructions = false;
var xml1:XML = 
        <foo>
            <?exampleInstruction ?>
        </foo>;
trace(xml1.toXMLString()); // <foo><?exampleInstruction ?></foo>

XML.ignoreProcessingInstructions = true;
var xml2:XML = 
        <foo>
            <?exampleInstruction ?>
        </foo>;
trace(xml2.toXMLString()); // <foo/>

ignoreWhitespace

属性 
ignoreWhitespace:Boolean

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

确定分析期间是否忽略文本节点开头和末尾处的空白字符。默认情况下,将忽略空白 (true)。如果文本节点 100% 是空白,且 ignoreWhitespace 属性设置为 true,则不会创建该节点。要显示文本节点中的空白,请将 ignoreWhitespace 属性设置为 false

创建 XML 对象时,它将缓存 ignoreWhitespace 属性的当前值。更改 ignoreWhitespace 不会更改现有 XML 对象的行为。



实现
    public static function get ignoreWhitespace():Boolean
    public static function set ignoreWhitespace(value:Boolean):void

示例  ( 如何使用本示例 )
本示例演示将 XML.ignoreWhitespace 设置为 false 以及设置为 true 的效果:
XML.ignoreWhitespace = false;
var xml1:XML = <foo>    </foo>;
trace(xml1.children().length()); // 1

XML.ignoreWhitespace = true;
var xml2:XML = <foo>    </foo>;
trace(xml2.children().length()); // 0

prettyIndent

属性 
prettyIndent:int

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

确定当 XML.prettyPrinting 属性设置为 true 时,toString()toXMLString() 方法所应用的缩进量。应用缩进时使用空格字符,而不是制表符。默认值为 2



实现
    public static function get prettyIndent():int
    public static function set prettyIndent(value:int):void

相关 API 元素


示例  ( 如何使用本示例 )
本示例演示设置 XML.prettyIndent 静态属性的效果:
var xml:XML = <foo><bar/></foo>;
XML.prettyIndent = 0;
trace(xml.toXMLString());

XML.prettyIndent = 1;
trace(xml.toXMLString());

XML.prettyIndent = 2;
trace(xml.toXMLString());

prettyPrinting

属性 
prettyPrinting:Boolean

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

确定 toString()toXMLString() 方法是否对某些标签之间的空白字符进行规格化。默认值为 true



实现
    public static function get prettyPrinting():Boolean
    public static function set prettyPrinting(value:Boolean):void

相关 API 元素


示例  ( 如何使用本示例 )
本示例演示设置 XML.prettyPrinting 静态属性的效果:
var xml:XML = <foo><bar/></foo>;
XML.prettyPrinting = false;
trace(xml.toXMLString());

XML.prettyPrinting = true;
trace(xml.toXMLString());
构造函数详细信息

XML

()构造函数
public function XML(value:Object)

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

创建一个新的 XML 对象。调用 XML 类的方法之前,必须使用该构造函数创建一个 XML 对象。

使用 toXMLString() 方法可返回 XML 对象的字符串表示形式,不管该 XML 对象具有简单内容还是复杂内容。

参数
value:Object — 可通过顶级 XML() 函数转换为 XML 的任意对象。

相关 API 元素


示例  ( 如何使用本示例 )

以下示例说明了如何使用 Flash Professional 中的 URLLoader 类在 ActionScript 3.0 中加载远程 XML 文档。ActionScriptExamples.com 提供的示例。
//
// Requires:
//   - TextArea control UI component in the Flash Professional Library.
//
import fl.controls.TextArea;
 
var xml:XML;
 
var urlRequest:URLRequest = new URLRequest("http://www.helpexamples.com/flash/xml/menu.xml");
 
var urlLoader:URLLoader = new URLLoader();
urlLoader.addEventListener(Event.COMPLETE, urlLoader_complete);
urlLoader.load(urlRequest);
 
var textArea:TextArea = new TextArea();
textArea.move(5, 5);
textArea.setSize(stage.stageWidth - 10, stage.stageHeight - 10);
addChild(textArea);
 
function urlLoader_complete(evt:Event):void {
    xml = new XML(evt.currentTarget.data);
    textArea.text = xml.toXMLString();
}

以下是另一种使用所有 ActionScript 的变化形式。ActionScriptExamples.com 提供的示例。
var xml:XML;
var textArea:TextField = new TextField();
textArea.width = 300;
 
var urlRequest:URLRequest = new URLRequest("http://www.helpexamples.com/flash/xml/menu.xml");
var urlLoader:URLLoader = new URLLoader();
urlLoader.dataFormat = URLLoaderDataFormat.TEXT;
urlLoader.addEventListener(Event.COMPLETE, urlLoader_complete);
urlLoader.load(urlRequest);
 
function urlLoader_complete(evt:Event):void {
    xml = new XML(evt.target.data);
    textArea.text = xml.toXMLString();
    addChild(textArea);
}
方法详细信息

addNamespace

()方法
AS3 function addNamespace(ns:Object):XML

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

可将命名空间添加到该 XML 对象所在范围的命名空间集中。如果 XML 对象(其前缀与给定参数的前缀匹配)所在范围的命名空间中已存在该命名空间,则现有命名空间的前缀将设置为 undefined。如果输入参数是一个 Namespace 对象,则直接使用该参数。如果它是一个 QName 对象,则使用输入参数的 URI 创建新的命名空间;否则,会将它转换为一个 String 值并根据该 String 值创建命名空间。

参数

ns:Object — 要添加到 XML 对象中的命名空间。

返回
XML — 添加了命名空间的新 XML 对象。

示例  ( 如何使用本示例 )

下面的示例使用在 XML 对象中定义的命名空间,并将其应用于另一个 XML 对象:
var xml1:XML = <ns:foo xmlns:ns="www.example.com/ns" />;
var nsNamespace:Namespace = xml1.namespace();

var xml2:XML = <bar />;
xml2.addNamespace(nsNamespace);
trace(xml2.toXMLString()); // <bar xmlns:ns="www.example.com/ns"/>

appendChild

()方法 
AS3 function appendChild(child:Object):XML

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

将给定子项追加到该 XML 对象属性的末尾。appendChild() 方法可采用 XML 对象、XMLList 对象或随后转换为 String 的任何其他数据类型。

使用 delete (XML) 运算符删除 XML 节点。

参数

child:Object — 要追加的 XML 对象。

返回
XML — 生成的 XML 对象。

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例向 XML 对象的子级列表的末尾追加一个新元素:
var xml:XML = 
        <body>
            <p>hello</p>
        </body>;
        
xml.appendChild(<p>world</p>);    
trace(xml.p[0].toXMLString()); // <p>hello</p>
trace(xml.p[1].toXMLString()); // <p>world</p>

attribute

()方法 
AS3 function attribute(attributeName:*):XMLList

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

返回其名称与 attributeName 参数相符的属性的 XML 值。可在 XML 元素内找到属性。在以下示例中,元素具有名为“gender”的属性,其值为“boy”:<first gender="boy">John</first>

attributeName 参数可以是任何数据类型;但 String 是最常用的数据类型。在传递 QName 对象之外的任何对象时,attributeName 参数会使用 toString() 方法将参数转换为字符串。

如果需要一个限定名称引用,可以传入 QName 对象。QName 对象可定义命名空间和本地名称,还可定义属性的限定名称。因此,调用 attribute(qname) 不同于调用 attribute(qname.toString())

参数

attributeName:* — 属性的名称。

返回
XMLList — 一个 XMLList 对象或空的 XMLList 对象。在未定义属性值时返回一个空的 XMLList 对象。

相关 API 元素


示例  ( 如何使用本示例 )

本示例演示如何将 QName 对象传递给 attribute() 方法。localName 属性为 attrnamespace 属性为 ns
 var xml:XML = <ns:node xmlns:ns = "http://uri" ns:attr = '7' />       
 var qn:QName = new QName("http://uri", "attr");
 trace (xml.attribute(qn)); // 7

要返回名称与 ActionScript 保留字匹配的属性,请使用 attribute() 方法替代 attribute identifier (@) 运算符,如下面的示例所示:
 var xml:XML = <example class="first" />
 trace(xml.attribute("class"));
 

attributes

()方法 
AS3 function attributes():XMLList

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

返回给定 XML 对象的属性值列表。结合使用 name() 方法和 attributes() 方法可返回属性的名称。使用 xml.attributes() 等效于 xml.@*

返回
XMLList — 属性值的列表。

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例返回属性的名称:
var xml:XML=<example id='123' color='blue'/>
trace(xml.attributes()[1].name()); //color

下面的示例返回所有属性的名称:
 
var xml:XML = <example id='123' color='blue'/>
var attNamesList:XMLList = xml.@*;

trace (attNamesList is XMLList); // true
trace (attNamesList.length()); // 2

for (var i:int = 0; i < attNamesList.length(); i++)
{ 
    trace (typeof (attNamesList[i])); // xml
    trace (attNamesList[i].nodeKind()); // attribute
    trace (attNamesList[i].name()); // id and color
} 

child

()方法 
AS3 function child(propertyName:Object):XMLList

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

列出 XML 对象的子项。一个 XML 子项就是一个 XML 元素、文本节点、注释或处理指令。

使用 propertyName 参数可列出特定 XML 子项的内容。例如,要返回名为 <first> 的子项的内容,请对 XML 对象调用 child("first")。使用子项的索引编号,可以生成相同的结果。索引编号标识该子项在其他 XML 子项列表中的位置。例如,child(0) 会返回列表中的第一个子项。

使用星号 (*) 可输出 XML 文档中的所有子项。例如,doc.child("*")

结合使用 length() 方法与 child() 方法的星号 (*) 参数可输出子项的总数。例如,numChildren = doc.child("*").length()

参数

propertyName:Object — XML 子对象的元素名称或整数。

返回
XMLList — 与输入参数匹配的子节点的 XMLList 对象。

相关 API 元素


示例  ( 如何使用本示例 )

本示例演示如何使用 child() 方法识别具有指定名称的子元素:
var xml:XML = 
        <foo>
            <bar>text1</bar>
            <bar>text2</bar>
        </foo>;
trace(xml.child("bar").length());  // 2
trace(xml.child("bar")[0].toXMLString()); // <bar>text1</bar>
trace(xml.child("bar")[1].toXMLString()); // <bar>text2</bar>

childIndex

()方法 
AS3 function childIndex():int

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

确定该 XML 对象在其父项上下文中从 0 开始编制索引的位置。

返回
int — 对象的位置。返回 -1 以及正整数。

示例  ( 如何使用本示例 )

本示例演示如何使用 childIndex() 方法:
var xml:XML = 
            <foo>
                <bar />
                text
                <bob />
            </foo>;
trace(xml.bar.childIndex()); // 0
trace(xml.bob.childIndex()); // 2

children

()方法 
AS3 function children():XMLList

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

按 XML 对象的显示顺序列出其子项。一个 XML 子项就是一个 XML 元素、文本节点、注释或处理指令。

返回
XMLList — XML 对象子项的 XMLList 对象。

示例  ( 如何使用本示例 )

本示例演示如何使用 children() 方法:
XML.ignoreComments = false;
XML.ignoreProcessingInstructions = false;
var xml:XML = 
        <foo id="22">
            <bar>44</bar>
            text
            <!-- comment -->
            <?instruction ?>
        </foo>;
trace(xml.children().length()); // 4
trace(xml.children()[0].toXMLString()); // <bar>44</bar>
trace(xml.children()[1].toXMLString()); // text
trace(xml.children()[2].toXMLString()); // <!-- comment -->
trace(xml.children()[3].toXMLString()); // <?instruction ?>

comments

()方法 
AS3 function comments():XMLList

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

列出包含 XML 注释的 XML 对象的属性。

返回
XMLList — 包含注释的属性的 XMLList 对象。

示例  ( 如何使用本示例 )

本示例演示如何使用 comments() 方法:
XML.ignoreComments = false;
var xml:XML = 
        <foo>
            <!-- example -->
            <!-- example2 -->
        </foo>;
trace(xml.comments().length()); // 2
trace(xml.comments()[1].toXMLString()); // <!-- example2 -->

contains

()方法 
AS3 function contains(value:XML):Boolean

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

对比该 XML 对象与给定 value 参数。

参数

value:XML — 要与当前 XML 对象进行对比的值。

返回
Boolean — 如果 XML 对象与 value 参数匹配,则为 true;否则为 false

示例  ( 如何使用本示例 )

本示例演示如何使用 contains() 方法:
var xml:XML = 
        <order>
            <item>Rice</item>
            <item>Kung Pao Shrimp</item>
        </order>;
trace(xml.item[0].contains(<item>Rice</item>)); // true
trace(xml.item[1].contains(<item>Kung Pao Shrimp</item>)); // true
trace(xml.item[1].contains(<item>MSG</item>)); // false

copy

()方法 
AS3 function copy():XML

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

返回给定 XML 对象的副本。该副本为整个节点树的副本。复制的 XML 对象没有父级,如果尝试调用 parent() 方法,将返回 null

返回
XML — 对象的副本。

示例  ( 如何使用本示例 )

本示例演示 copy() 方法如何创建 XML 对象的新实例。修改副本时,原始对象保持不变:
var xml1:XML = <foo />;
var xml2:XML = xml1.copy();
xml2.appendChild(<bar />);
trace(xml1.bar.length()); // 0
trace(xml2.bar.length()); // 1

defaultSettings

()方法 
AS3 static function defaultSettings():Object

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

返回一个下列属性设置为默认值的对象:ignoreCommentsignoreProcessingInstructionsignoreWhitespaceprettyIndentprettyPrinting。其默认值如下:

  • ignoreComments = true
  • ignoreProcessingInstructions = true
  • ignoreWhitespace = true
  • prettyIndent = 2
  • prettyPrinting = true

注意:不要将此方法应用于 XML 类的实例;应将其应用于 XML,如以下代码所示:var df:Object = XML.defaultSettings()

返回
Object — 属性设置为默认设置的对象。

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例演示如何在设置 XML 对象之前应用某些自定义设置(以便包含注释和处理指令),如何在设置另一个 XML 对象之前恢复为默认设置,以及如何再次设置自定义设置(以便设置更多 XML 对象):
XML.ignoreComments = false;
XML.ignoreProcessingInstructions = false;
var customSettings:Object = XML.settings();

var xml1:XML = 
        <foo>
            <!-- comment -->
            <?instruction ?>
        </foo>;
trace(xml1.toXMLString());
//    <foo>
//        <!-- comment -->
//         <?instruction ?>
//    </foo>

XML.setSettings(XML.defaultSettings());
var xml2:XML = 
        <foo>
            <!-- comment -->
            <?instruction ?>
        </foo>;
trace(xml2.toXMLString());

descendants

()方法 
AS3 function descendants(name:Object = *):XMLList

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

返回包含给定 name 参数的 XML 对象的所有后代(子级、孙级、曾孙级等)。name 参数是可选项。name 参数可以为 QName 对象、String 数据类型或随后转换为 String 数据类型的任何其他数据类型。

要返回所有后代,请使用“*”参数。如果未传递任何参数,则传递字符串“*”,并返回此 XML 对象的所有后代。

参数

name:Object (default = *) — 要匹配的元素的名称。

返回
XMLList — 匹配后代的 XMLList 对象。如果没有后代,则返回空的 XMLList 对象。

相关 API 元素


示例  ( 如何使用本示例 )

要返回名称与 ActionScript 保留字相匹配的后代,请使用 descendants() 方法,而不要使用 descendant (..) 运算符,如下面的示例所示:
var xml:XML = 
  <enrollees>
    <student id="239">
        <class name="Algebra" />
        <class name="Spanish 2"/>
    </student>
    <student id="206">
        <class name="Trigonometry" />
        <class name="Spanish 2" />
    </student>
  </enrollees>
trace(xml.descendants("class")); 

下面的示例演示 descendants() 方法如何返回包含所有后代对象(包括子级、孙级等)的 XMLList 对象:
XML.ignoreComments = false;
var xml:XML = 
        <body>
            <!-- comment -->
            text1
            <a>
                <b>text2</b>
            </a>
        </body>;
trace(xml.descendants("*").length()); // 5
trace(xml.descendants("*")[0]); // // <!-- comment -->
trace(xml.descendants("*")[1].toXMLString()); // text1
trace(xml.descendants("a").toXMLString()); // <a><b>text2</b></a>
trace(xml.descendants("b").toXMLString()); // <b>text2</b>

elements

()方法 
AS3 function elements(name:Object = *):XMLList

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

列出某 XML 对象的元素。一个由开始和结束标签组成的元素;例如 <first></first>name 参数是可选项。name 参数可以为 QName 对象、String 数据类型或随后转换为 String 数据类型的任何其他数据类型。使用 name 参数可列出特定元素。例如,以下示例中的元素“first”返回“John”:<first>John</first>

要列出所有元素,请使用星号 (*) 作为参数。该星号也是默认参数。

使用带星号参数的 length() 方法可输出元素的总数。例如,numElement = addressbook.elements("*").length()

参数

name:Object (default = *) — 元素的名称。元素的名称由尖括号括起。例如,以下示例中的“first”为 name<first></first>

返回
XMLList — 元素内容的 XMLList 对象。元素内容位于起始和结束标签之间。如果使用星号 (*) 调用所有元素,将返回元素的标签和内容。

相关 API 元素


示例  ( 如何使用本示例 )

下例说明 elements() 方法只返回元素列表,而不返回注释、文本属性或处理指令:
var xml:XML = 
        <foo>
            <!-- comment -->
            <?instruction ?>
            text
            <a>1</a>
            <b>2</b>
        </foo>;
trace(xml.elements("*").length()); // 2
trace(xml.elements("*")[0].toXMLString()); // <a>1</a>
trace(xml.elements("b").length()); // 1
trace(xml.elements("b")[0].toXMLString()); // <b>2</b>

要返回名称与 ActionScript 保留字相匹配的元素,请使用 elements() 方法替代 XML dot (.) 运算符,如下面的示例所示:
var xml:XML =
 <student id="206">
    <class name="Trigonometry" />
    <class name="Spanish 2" />
 </student>
trace(xml.elements("class")); 

hasComplexContent

()方法 
AS3 function hasComplexContent():Boolean

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

检查该 XML 对象是否包含复杂内容。如果 XML 对象具有子元素,则表明它包含复杂内容。表示属性、注释、处理指令和文本节点的 XML 对象不包含复杂内容。但是,仍可将包含上述内容的对象视为包含复杂内容(条件是该对象具有子元素)。

返回
Boolean — 如果 XML 对象包含复杂内容,则为 true,否则为 false

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例演示一个 XML 对象,该对象有一个包含简单内容的名为 a 的属性,以及一个包含复杂内容的名为 a 的属性:
var xml:XML = 
        <foo>
            <a>
                text
            </a>
            <a>
                <b/>
            </a>
        </foo>;
trace(xml.a[0].hasComplexContent()); // false
trace(xml.a[1].hasComplexContent()); // true

trace(xml.a[0].hasSimpleContent()); // true
trace(xml.a[1].hasSimpleContent()); // false

hasOwnProperty

()方法 
AS3 function hasOwnProperty(p:String):Boolean

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

检查该对象是否具有 p 参数所指定的属性。

参数

p:String — 要匹配的属性。

返回
Boolean — 如果此属性存在,则为 true;否则为 false

示例  ( 如何使用本示例 )

下例使用 hasOwnProperty() 方法,以确保属性 (b) 在计算使用该属性的表达式 (b == "11") 之前便已存在:
var xml:XML = 
        <foo>
            <a />
            <a>
                <b>10</b>
            </a>
            <a>
                <b>11</b>
            </a>
        </foo>;
trace(xml.a.(hasOwnProperty("b") && b == "11")); 
如果本示例的最后一行内容如下所示,则 Flash Player 将引发异常,因为第一个元素(名为 a)不具有名为 b 的属性:

trace(xml.a.(b == "11"));


下例使用 hasOwnProperty() 方法,以确保属性 (item) 在计算使用该属性的表达式 (item.contains("toothbrush")) 之前便已存在:
var xml:XML = 
        <orders>
            <order id='1'>
                <item>toothbrush</item>
                <item>toothpaste</item>
            </order>
            <order>
                <returnItem>shoe polish</returnItem>
            </order>
        </orders>;
trace(xml.order.(hasOwnProperty("item") && item.contains("toothbrush"))); 

hasSimpleContent

()方法 
AS3 function hasSimpleContent():Boolean

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

检查该 XML 对象是否包含简单内容。如果 XML 对象表示文本节点、属性节点或不包含子元素的 XML 元素,则表明它包含简单内容。表示注释和处理指令的 XML 对象包含简单内容。

返回
Boolean — 如果 XML 对象包含简单内容,则为 true,否则为 false

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例演示一个 XML 对象,该对象有一个包含简单内容的名为 a 的属性,以及一个包含复杂内容的名为 a 的属性:
var xml:XML = 
        <foo>
            <a>
                text
            </a>
            <a>
                <b/>
            </a>
        </foo>;
trace(xml.a[0].hasComplexContent()); // false
trace(xml.a[1].hasComplexContent()); // true

trace(xml.a[0].hasSimpleContent()); // true
trace(xml.a[1].hasSimpleContent()); // false

inScopeNamespaces

()方法 
AS3 function inScopeNamespaces():Array

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

根据该 XML 对象的父项列出其命名空间。

返回
Array — Namespace 对象的数组。

insertChildAfter

()方法 
AS3 function insertChildAfter(child1:Object, child2:Object):*

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

在该 XML 对象的 child1 参数后插入给定的 child2 参数并返回生成的对象。如果 child1 参数为 null,则该方法将在 XML 对象的所有子项之前 插入 child2 的内容(也就是说, 在任何子项之后)。如果提供 child1,但 XML 对象中不包含该参数,则不修改该 XML 对象并返回 undefined

如果对不是元素(文本、属性、注释、pi 等等)的 XML 子项调用该方法,则返回 undefined

使用 delete (XML) 运算符删除 XML 节点。

参数

child1:Object — 在 child2 之前插入的源对象中的对象。
 
child2:Object — 要插入的对象。

返回
* — 生成的 XML 对象或 undefined

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例将一个元素追加到 XML 对象的子元素的末尾:
var xml:XML = 
        <menu>
            <item>burger</item>
            <item>soda</item>
        </menu>;
xml.insertChildAfter(xml.item[0], <saleItem>fries</saleItem>);
trace(xml);
trace() 输出如下所示:
 <menu>
     <item>burger</item>
     <saleItem>fries</saleItem>
     <item>soda</item>
 </menu>

insertChildBefore

()方法 
AS3 function insertChildBefore(child1:Object, child2:Object):*

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

在该 XML 对象的 child1 参数前插入给定的 child2 参数并返回生成的对象。如果 child1 参数为 null,则该方法将在 XML 对象的所有子项之后 插入 child2 的内容(也就是说, 在任何子项之前)。如果提供 child1,但 XML 对象中不包含该参数,则不修改该 XML 对象并返回 undefined

如果对不是元素(文本、属性、注释、pi 等等)的 XML 子项调用该方法,则返回 undefined

使用 delete (XML) 运算符删除 XML 节点。

参数

child1:Object — 在 child2 之后插入的源对象中的对象。
 
child2:Object — 要插入的对象。

返回
* — 生成的 XML 对象或 undefined

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例将一个元素追加到 XML 对象的子元素的末尾:
var xml:XML = 
        <menu>
            <item>burger</item>
            <item>soda</item>
        </menu>;
xml.insertChildBefore(xml.item[0], <saleItem>fries</saleItem>);
trace(xml);
trace() 输出如下所示:
 <menu>
     <saleItem>fries</saleItem>
     <item>burger</item>
     <item>soda</item>
 </menu>

length

()方法 
AS3 function length():int

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

对于 XML 对象,该方法始终返回整数 1。XMLList 类的 length() 方法对仅包含一个值的 XMLList 对象返回值 1

返回
int — 对于任何 XML 对象,始终返回 1

localName

()方法 
AS3 function localName():Object

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

提供该 XML 对象限定名称的本地名称部分。

返回
Object — 作为 String 或 null 的本地名称。

示例  ( 如何使用本示例 )

下面的示例演示如何使用 localName() 方法:
var xml:XML = 
        <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
            soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">

                        <soap:Body xmlns:wx = "http://example.com/weather">
                <wx:forecast>
                    <wx:city>Quito</wx:city>
                </wx:forecast>
            </soap:Body>
        </soap:Envelope>;
        
trace(xml.localName()); // Envelope

name

()方法 
AS3 function name():Object

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

提供该 XML 对象的限定名称。

返回
Object — 限定名称为 QName 或 null

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例演示如何使用 name() 方法获取 XML 对象的限定名称:
var xml:XML = 
        <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
            soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">

                        <soap:Body xmlns:wx = "http://example.com/weather">
                <wx:forecast>
                    <wx:city>Quito</wx:city>
                </wx:forecast>
            </soap:Body>
        </soap:Envelope>;
        
trace(xml.name().localName); // Envelope
trace(xml.name().uri); // "http://www.w3.org/2001/12/soap-envelope"

下面的示例演示如何对 XML 属性 (property)、文本元素和属性 (attribute) 调用 name() 方法:
var xml:XML = 
        <foo x="15" y="22">
            text
        </foo>;
        
trace(xml.name().localName); // foo
trace(xml.name().uri == ""); // true
trace(xml.children()[0]); // text
trace(xml.children()[0].name()); // null
trace(xml.attributes()[0]); // 15
trace(xml.attributes()[0].name()); // x

namespace

()方法 
AS3 function namespace(prefix:String = null):*

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

如果没有提供参数,则提供与该 XML 对象的限定名关联的命名空间。如果指定了 prefix 参数,则该方法将返回与 prefix 参数匹配且位于 XML 对象所在范围内的命名空间。如果不存在此类命名空间,该方法将返回 undefined

参数

prefix:String (default = null) — 要匹配的前缀。

返回
* — 返回 nullundefined 或命名空间。

示例  ( 如何使用本示例 )

下例使用 namespace() 方法获取 XML 对象的命名空间,并将其分配给名为 soap 的 Namespace 对象,随后将使用该对象标识 xml 对象 (xml.soap::Body[0]):
var xml:XML = 
        <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
            soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">

                        <soap:Body xmlns:wx = "http://example.com/weather">
                <wx:forecast>
                    <wx:city>Quito</wx:city>
                </wx:forecast>
            </soap:Body>
        </soap:Envelope>;
        
var soap:Namespace = xml.namespace();
trace(soap.prefix); // soap
trace(soap.uri); // http://www.w3.org/2001/12/soap-envelope

var body:XML = xml.soap::Body[0];
trace(body.namespace().prefix); // soap
trace(xml.namespace().uri); // http://www.w3.org/2001/12/soap-envelope
trace(body.namespace("wx").uri); // "http://example.com/weather"

下例使用 namespace() 方法获取节点的默认命名空间,以及特定前缀 ("dc") 的命名空间:
var xml:XML = 
        <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" 
            xmlns:dc="http://purl.org/dc/elements/1.1/" 
            xmlns="http://purl.org/rss/1.0/">
                <!-- ... -->
        </rdf:RDF>;
                    
trace(xml.namespace()); // http://www.w3.org/1999/02/22-rdf-syntax-ns#
trace(xml.namespace("dc")); // http://purl.org/dc/elements/1.1/
trace(xml.namespace("foo")); // undefined

namespaceDeclarations

()方法 
AS3 function namespaceDeclarations():Array

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

在该 XML 对象的父项中列出与其关联的命名空间声明。

返回
Array — Namespace 对象的数组。

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例输出 XML 对象的命名空间声明:
var xml:XML = 
        <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" 
            xmlns:dc="http://purl.org/dc/elements/1.1/" 
            xmlns="http://purl.org/rss/1.0/">

            <!-- ... -->
            
        </rdf:RDF>;
                    
for (var i:uint = 0; i < xml.namespaceDeclarations().length; i++) {
    var ns:Namespace = xml.namespaceDeclarations()[i]; 
    var prefix:String = ns.prefix;
    if (prefix == "") {
        prefix = "(default)";
    }
    trace(prefix + ":" , ns.uri);
}
trace() 输出如下所示:
rdf: http://www.w3.org/1999/02/22-rdf-syntax-ns#
 dc: http://purl.org/dc/elements/1.1/
 (default): http://purl.org/rss/1.0/

nodeKind

()方法 
AS3 function nodeKind():String

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

指定节点的类型:文本、注释、处理指令、属性或元素。

返回
String — 所使用的节点类型。

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例跟踪所有这五种节点类型:
XML.ignoreComments = false;
XML.ignoreProcessingInstructions = false;

var xml:XML = 
    <example id="10">
        <!-- this is a comment -->
        <?test this is a pi ?>
        and some text
    </example>;

trace(xml.nodeKind()); // element
trace(xml.children()[0].nodeKind()); // comment
trace(xml.children()[1].nodeKind()); // processing-instruction
trace(xml.children()[2].nodeKind()); // text
trace(xml.@id[0].nodeKind()); // attribute

normalize

()方法 
AS3 function normalize():XML

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

对于该 XML 对象以及所有子级 XML 对象,合并相邻文本节点并删除空文本节点。

返回
XML — 生成的标准 XML 对象。

示例  ( 如何使用本示例 )

下面的示例演示调用 normalize() 方法的效果:
var xml:XML = <body></body>;
xml.appendChild("hello");
xml.appendChild(" world");
trace(xml.children().length()); // 2
xml.normalize();
trace(xml.children().length()); // 1

parent

()方法 
AS3 function parent():*

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

返回 XML 对象的父项。如果该 XML 对象没有父项,则该方法返回 undefined

返回
* — 父节点的 XML 引用或 undefined(如果 XML 对象没有父级)。

示例  ( 如何使用本示例 )

下例使用 parent() 方法标识 XML 结构中特定元素的父项:
var xml:XML = 
    <body>
        <p id="p1">Hello</p>
        <p id="p2">Test:
            <ul>
                <li>1</li>
                <li>2</li>
            </ul>
        </p>
    </body>;
var node:XML = xml.p.ul.(li.contains("1"))[0]; // == <ul> ... </ul>
trace(node.parent().@id); // p2

prependChild

()方法 
AS3 function prependChild(value:Object):XML

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

将提供的 child 对象的副本插入 XML 元素中,并放在该元素的任何现有 XML 属性前面。

使用 delete (XML) 运算符删除 XML 节点。

参数

value:Object — 要插入的对象。

返回
XML — 生成的 XML 对象。

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例使用 prependChild() 方法将元素添加到 XML 对象子级列表的开头:
var xml:XML = 
        <body>
            <p>hello</p>
        </body>;
        
xml.prependChild(<p>world</p>);    
trace(xml.p[0].toXMLString()); // <p>world</p>
trace(xml.p[1].toXMLString()); // <p>hello</p>

processingInstructions

()方法 
AS3 function processingInstructions(name:String = "*"):XMLList

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

如果提供 name 参数,则列出包含该 name 的处理指令的 XML 对象的所有子项。如果未提供参数,则该方法会列出包含任何处理指令的 XML 对象的所有子项。

参数

name:String (default = "*") — 要匹配的处理指令的名称。

返回
XMLList — 匹配的子对象的列表。

示例  ( 如何使用本示例 )

下面的示例使用 processingInstructions() 方法获取 XML 对象的处理指令数组:
XML.ignoreProcessingInstructions = false;
var xml:XML =
    <body>
            foo
            <?xml-stylesheet href="headlines.css" type="text/css" ?>
            <?instructionX ?>
            
    </body>;

trace(xml.processingInstructions().length()); // 2
trace(xml.processingInstructions()[0].name()); // xml-stylesheet

propertyIsEnumerable

()方法 
AS3 function propertyIsEnumerable(p:String):Boolean

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

检查属性 p 所在的属性集是否可在应用于 XMLList 对象的 for..in 语句中遍历。仅当 toString(p) == "0" 时返回 true

参数

p:String — 要检查的属性。

返回
Boolean — 如果该属性可以在 for..in 语句中,为 true;否则为 false

示例  ( 如何使用本示例 )

下例演示,对于 XML 对象,propertyNameIsEnumerable() 方法返回值 true(仅对于值 0),而对于 XMLList 对象,返回值为 true(对于 XMLList 对象的每个有效索引值):
var xml:XML = 
        <body>
             <p>Hello</p>
               <p>World</p>
        </body>;

trace(xml.propertyIsEnumerable(0)); // true
trace(xml.propertyIsEnumerable(1)); // false

for (var propertyName:String in xml) {
    trace(xml[propertyName]);
}

var list:XMLList = xml.p;
trace(list.propertyIsEnumerable(0)); // true
trace(list.propertyIsEnumerable(1)); // true
trace(list.propertyIsEnumerable(2)); // false

for (var propertyName:String in list) { 
    trace(list[propertyName]);
}

removeNamespace

()方法 
AS3 function removeNamespace(ns:Namespace):XML

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

删除该对象及其所有子级的给定命名空间。如果命名空间由该对象的限定名称或该对象属性的限定名称引用,则 removeNamespaces() 方法不会删除该命名空间。

参数

ns:Namespace — 要删除的命名空间。

返回
XML — 生成的 XML 对象的副本。

示例  ( 如何使用本示例 )

下面的示例演示如何删除 XML 对象的命名空间声明:
var xml:XML = 
    <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" 
        xmlns:dc="http://purl.org/dc/elements/1.1/" 
        xmlns="http://purl.org/rss/1.0/">
    
        <!-- ... -->
        
    </rdf:RDF>;

trace(xml.namespaceDeclarations().length); // 3
trace(xml.namespaceDeclarations()[0] is String); // 
var dc:Namespace = xml.namespace("dc");
xml.removeNamespace(dc);
trace(xml.namespaceDeclarations().length); // 2

replace

()方法 
AS3 function replace(propertyName:Object, value:XML):XML

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

用给定的 value 参数替换 propertyName 参数所指定的属性。如果没有属性与 propertyName 匹配,会将 XML 对象保持为未修改状态。

参数

propertyName:Object — 可以是数值、XML 元素集的非限定名称、XML 元素集的限定名称或星号通配符 (*)。使用非限定名称标识默认命名空间中的 XML 元素。
 
value:XML — 替换值。它可以是 XML 对象、XMLList 对象或可以使用 toString() 转换的任何值。

返回
XML — 生成的 XML 对象,其中替换了匹配属性。

示例  ( 如何使用本示例 )

下面的示例演示在调用 replace() 方法时将整数作为第一个参数:
var xml:XML = 
    <body>
        <p>Hello</p>
        <p>World</p>
        <hr/>
    </body>;

xml.replace(1, <p>Bob</p>);
trace(xml);
这将产生以下 trace() 输出:

 <body>
     <p>Hello</p>
     <p>Bob</p>
     <hr/>
 </body>
 

下面的示例调用 replace() 方法时将字符串作为第一个参数:
var xml:XML = 
    <body>
        <p>Hello</p>
        <p>World</p>
        <hr/>
    </body>;

xml.replace("p", <p>Hi</p>); 
trace(xml);
这将产生以下 trace() 输出:

 <body>
     <p>Hi</p>
     <hr/>
 </body>;
 

下面的示例演示在调用 replace() 方法时将 QName 作为第一个参数:
var xml:XML = 
    <ns:body xmlns:ns = "myNS">
        <ns:p>Hello</ns:p>
        <ns:p>World</ns:p>
        <hr/>
    </ns:body>;

var qname:QName = new QName("myNS", "p");
xml.replace(qname, <p>Bob</p>);
trace(xml);

这将产生以下 trace() 输出:

 <ns:body xmlns:ns = "myNS">
     <p>Bob</p>
     <hr/>
 </ns:body>
 

下面的示例演示在调用 replace() 方法时将字符串 "*" 作为第一个参数:
var xml:XML = 
    <body>
        <p>Hello</p>
        <p>World</p>
        <hr/>
    </body>;

xml.replace("*", <img src = "hello.jpg"/>);
trace(xml);
这将产生以下 trace() 输出:

 <body>
     <img src="hello.jpg"/>
 </body>
 

setChildren

()方法 
AS3 function setChildren(value:Object):XML

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

value 参数中提供的指定 XML 属性集替换该 XML 对象的子属性。

参数

value:Object — 替换 XML 属性。可以是单个 XML 对象或 XMLList 对象。

返回
XML — 生成的 XML 对象。

示例  ( 如何使用本示例 )

下面的示例演示在调用 setChildren() 方法时,先使用 XML 对象作为参数,然后使用 XMLList 对象作为参数:
var xml:XML = 
    <body>
        <p>Hello</p>
        <p>World</p>
    </body>;

var list:XMLList = xml.p;

xml.setChildren(<p>hello</p>);
trace(xml);

//    <body>
//        <p>hello</p>
//    </body>

xml.setChildren(list);
trace(xml);

//    <body>
//        <p>Hello</p>
//        <p>World</p>
//    </body>

setLocalName

()方法 
AS3 function setLocalName(name:String):void

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

将该 XML 对象的本地名称更改为给定的 name 参数。

参数

name:String — 本地名称的替换名称。


示例  ( 如何使用本示例 )

下面的示例使用 setLocalName() 方法更改 XML 元素的本地名称:
var xml:XML = 
    <ns:item xmlns:ns="http://example.com">
        toothbrush
    </ns:item>;
    
xml.setLocalName("orderItem");
trace(xml.toXMLString()); // <ns:orderItem xmlns:ns="http://example.com">toothbrush</ns:orderItem>

setName

()方法 
AS3 function setName(name:String):void

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

将该 XML 对象的名称设置为给定限定名称或属性名。

参数

name:String — 对象的新名称。


示例  ( 如何使用本示例 )

下面的示例使用 setName() 方法更改 XML 元素的名称:
var xml:XML = 
    <item>
        toothbrush
    </item>;
    
xml.setName("orderItem");
trace(xml.toXMLString()); // <orderItem>toothbrush</orderItem>

setNamespace

()方法 
AS3 function setNamespace(ns:Namespace):void

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

设置与该 XML 对象关联的命名空间。

参数

ns:Namespace — 新命名空间。


示例  ( 如何使用本示例 )

下例使用在某个 XML 对象中定义的 soap 命名空间,并将其应用于另一个 XML 对象 (xml2) 的命名空间:
var xml1:XML = 
        <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
            soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">
            <!-- ... -->
        </soap:Envelope>;
var ns:Namespace = xml1.namespace("soap");

var xml2:XML = 
    <Envelope>
        <Body/>
    </Envelope>;
    
xml2.setNamespace(ns);

trace(xml2);

setSettings

()方法 
AS3 static function setSettings(... rest):void

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

设置下列 XML 属性的值:ignoreCommentsignoreProcessingInstructionsignoreWhitespaceprettyIndentprettyPrinting。以下是默认设置,如果未提供 setObj 参数,将应用这些设置:

  • XML.ignoreComments = true
  • XML.ignoreProcessingInstructions = true
  • XML.ignoreWhitespace = true
  • XML.prettyIndent = 2
  • XML.prettyPrinting = true

注意:不要将此方法应用于 XML 类的实例;应将其应用于 XML,如以下代码所示:XML.setSettings()

参数

... rest — 具有下列各个属性的对象:
  • ignoreComments
  • ignoreProcessingInstructions
  • ignoreWhitespace
  • prettyIndent
  • prettyPrinting

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例演示如何在设置 XML 对象之前应用某些自定义设置(以便包含注释和处理指令),如何在设置另一个 XML 对象之前恢复为默认设置,以及如何再次设置自定义设置(以便设置更多 XML 对象):
XML.ignoreComments = false;
XML.ignoreProcessingInstructions = false;
var customSettings:Object = XML.settings();

var xml1:XML = 
        <foo>
            <!-- comment -->
            <?instruction ?>
        </foo>;
trace(xml1.toXMLString());
//    <foo>
//        <!-- comment -->
//         <?instruction ?>
//    </foo>

XML.setSettings(XML.defaultSettings());
var xml2:XML = 
        <foo>
            <!-- comment -->
            <?instruction ?>
        </foo>;
trace(xml2.toXMLString());

settings

()方法 
AS3 static function settings():Object

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

检索下列属性:ignoreCommentsignoreProcessingInstructionsignoreWhitespaceprettyIndentprettyPrinting

返回
Object — 具有下列 XML 属性的对象:
  • ignoreComments
  • ignoreProcessingInstructions
  • ignoreWhitespace
  • prettyIndent
  • prettyPrinting

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例演示如何在设置 XML 对象之前应用某些自定义设置(以便包含注释和处理指令),如何在设置另一个 XML 对象之前恢复为默认设置,以及如何再次设置自定义设置(以便设置更多 XML 对象):
XML.ignoreComments = false;
XML.ignoreProcessingInstructions = false;
var customSettings:Object = XML.settings();

var xml1:XML = 
        <foo>
            <!-- comment -->
            <?instruction ?>
        </foo>;
trace(xml1.toXMLString());
//    <foo>
//        <!-- comment -->
//         <?instruction ?>
//    </foo>

XML.setSettings(XML.defaultSettings());
var xml2:XML = 
        <foo>
            <!-- comment -->
            <?instruction ?>
        </foo>;
trace(xml2.toXMLString());

text

()方法 
AS3 function text():XMLList

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

返回 XML 对象用来表示 XML 文本节点的所有 XML 属性的 XMLList 对象。

返回
XMLList — 属性列表。

示例  ( 如何使用本示例 )

下面的示例使用 text() 方法获得 XML 对象的文本节点:
var xml:XML =
        <body>
            text1
            <hr/>
            text2
        </body>;
trace(xml.text()[0]); // text1
trace(xml.text()[1]); // text2

toJSON

()方法 
AS3 function toJSON(k:String):*

语言版本: ActionScript 3.0
运行时版本: Flash Player 11, AIR 3, Flash Lite 4

提供一种可覆盖的方法,用于在 XML 对象中自定义值的 JSON 编码。

JSON.stringify() 方法在其遍历的每个对象上寻找 toJSON() 方法。如果找到 toJSON() 方法,JSON.stringify() 会为其遇到的每个值调用该方法,传入与值配对的密钥。

XML 提供了 toJSON() 的默认实现,该实现只返回类名称。希望将 XML 对象导出到 JSON 的客户端必须提供其自己的实现。通过重新定义类原型中的 toJSON() 方法可执行此操作。

toJSON() 方法可返回任何类型的值。如果返回一个对象,则 stringify() 会递归到该对象中。如果 toJSON() 返回一个字符串,则 stringify() 不会递归并继续其遍历。

参数

k:StringJSON.stringify() 在遍历此对象时遇到的密钥/值对的密钥

返回
* — 类名称字符串。

相关 API 元素

object
Object.prototype

toString

()方法 
AS3 function toString():String

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

返回 XML 对象的字符串表示形式。此转换的规则取决于 XML 对象包含的是简单内容还是复杂内容:

  • 如果 XML 对象包含简单内容,toString() 将返回 XML 对象的字符串内容,但从中除去了以下内容:开始标签、属性、命名空间声明和结束标签。
  • 如果 XML 对象包含复杂内容,toString() 将返回 XML 编码字符串,该字符串表示完整的 XML 对象,包括开始标签、属性、命名空间声明和结束标签。

要每次都返回整个 XML 对象,请使用 toXMLString()

返回
String — XML 对象的字符串表示形式。

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例演示当 XML 对象包含简单内容时 toString() 方法的返回值:
var test:XML = <type name="Joe">example</type>;
trace(test.toString()); //example

下面的示例演示当 XML 对象包含复杂内容时 toString() 方法的返回值:
var test:XML = 
<type name="Joe">
    <base name="Bob"></base>
    example
</type>;
trace(test.toString());
  // <type name="Joe">
  // <base name="Bob"/>
  // example
  // </type> 

toXMLString

()方法 
AS3 function toXMLString():String

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

返回 XML 对象的字符串表示形式。与 toString() 方法不同,toXMLString() 方法始终返回 XML 对象的开始标签、属性和结束标签,与 XML 对象包含的是简单内容还是复杂内容无关。(toString() 方法去除包含简单内容的 XML 对象的这些项。)

返回
String — XML 对象的字符串表示形式。

相关 API 元素


示例  ( 如何使用本示例 )

下面的示例演示使用 toString() 方法(默认情况下适用于 trace() 方法的所有参数)与使用 toXMLString() 方法之间的区别:
var xml:XML =
        <p>hello</p>;
trace(xml); // hello
trace(xml.toXMLString()); // <p>hello</p>

valueOf

()方法 
AS3 function valueOf():XML

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 9

返回该 XML 对象。

返回
XML — XML 实例的原始值。

示例  ( 如何使用本示例 )

下面的示例演示 valueOf() 方法返回的值与源 XML 对象相同:
var xml:XML = <p>hello</p>;
trace(xml.valueOf() === xml); // true
XMLExample.as

下面的示例先创建一个 XML 变量并向其中添加节点。然后使用 XML 属性查找和输出 XML 节点。请注意,“at”(@) 符号用在多个 trace() 调用中,以按属性名称查找信息。
package {
    import flash.display.Sprite;

    public class XmlExample extends Sprite {        
        public function XmlExample() {
            var employees:XML =
                <employees>
                    <employee ssn="123-123-1234">
                        <name first="John" last="Doe"/>
                        <address>
                            <street>11 Main St.</street>
                            <city>San Francisco</city>
                            <state>CA</state>
                            <zip>98765</zip>
                        </address>
                    </employee>
                    <employee ssn="789-789-7890">
                        <name first="Mary" last="Roe"/>
                        <address>
                            <street>99 Broad St.</street>
                            <city>Newton</city>
                            <state>MA</state>
                            <zip>01234</zip>
                        </address>
                    </employee>
                </employees>;

            trace(employees.employee[0].address.zip);   // 98765

            trace(employees.employee[1].@ssn);          // 789-789-7890

            trace(employees.employee.name);             // <name first="John" last="Doe"/>
                                                        // <name first="Mary" last="Roe"/>

            trace(employees..zip[0]);                   // 98765

            trace(employees..@ssn[1]);                  // 789-789-7890

            trace(employees..name);                     // <name first="John" last="Doe"/>
                                                        // <name first="Mary" last="Roe"/>

            trace(employees.employee[0].address.*);     // <street>11 Main St.</street>    
                                                        // <city>San Francisco</city>
                                                        // <state>CA</state>
                                                        // <zip>98765</zip>
            var node:String = "zip";
            trace(employees.employee[0].address[node]); // 98765
            
            var attribute:String = "ssn";
            trace(employees.employee[1].@[attribute]);  // 789-789-7890
            
            for each (var num:XML in employees..@ssn) {
                trace(num);                             // 123-123-1234
            }                                           // 789-789-7890
            
            var ssnToFind:String = "789-789-7890";
            trace(employees.employee.(@ssn == ssnToFind).toXMLString());
                                                        // <employee ssn="789-789-7890">
                                                        // <name first="Mary" last="Roe"/>
                                                        // <address>
                                                        // <street>99 Broad St.</street>
                                                        // <city>Newton</city>
                                                        // <state>MA</state>
                                                        // <zip>01234</zip>
                                                        // </address>
                                                        // </employee>
        }
    }
}




[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。