Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : AIR 30.0 et versions antérieures, Flash Player 30.0 et versions antérieures, Flash Lite 4
Flex 4.6 et versions antérieures, Flash Pro CS6 et versions antérieures
Masquer les filtres
Niveau supérieur 

XML  - AS3

Packagesx

Niveau supérieur
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

Eléments du langage

Constantes globales
Fonctions globales
Opérateurs
Instructions, mots clés et directives
Types spéciaux

Annexes

Nouveautés
Erreurs de compilation
Avertissements du compilateur
Erreurs d’exécution
Migration vers ActionScript 3
Jeux de caractères pris en charge
Balises MXML uniquement
Eléments XML de mouvement
Balises Timed Text
Liste des éléments déconseillés
Constantes d’implémentation d’accessibilité
Utilisation des exemples de code ActionScript
Informations juridiques

Classes 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
PackageNiveau supérieur
Classepublic final dynamic class XML
HéritageXML Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

La classe XML contient les méthodes et propriétés réservées aux objets XML. A l’instar des classes XMLList, Namespace et QName, la classe XML implémente des normes de gestion XML performantes définies dans la spécification ECMAScript pour XML (E4X) (ECMA-357, édition 2).

La méthode toXMLString() permet de renvoyer une représentation sous forme de chaîne de l’objet XML, que son contenu soit simple ou complexe.

Remarque : la classe XML et les classes apparentées intégrées à ActionScript 2.0 ont été renommées XMLDocument et transférées dans le package flash.xml. La classe XML figure dans ActionScript 3.0 à des fins de compatibilité ascendante.

Consulter les exemples

Plus d’exemples

Informations complémentaires

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  ignoreComments : Boolean
[statique] Détermine si les commentaires XML sont ignorés lorsque les objets XML analysent les données XML source.
XML
  ignoreProcessingInstructions : Boolean
[statique] Détermine si les instructions de traitement XML sont ignorées lorsque les objets XML analysent les données XML source.
XML
  ignoreWhitespace : Boolean
[statique] Détermine si les caractères d’espace blanc placés au début et à la fin des nœuds de texte sont ignorés lors de l’analyse.
XML
  prettyIndent : int
[statique] Détermine la taille du retrait appliqué par les méthodes toString() et toXMLString() si la propriété XML.prettyPrinting est définie sur true.
XML
  prettyPrinting : Boolean
[statique] Détermine si les méthodes toString() et toXMLString() normalisent les caractères d’espace blanc entre certaines balises.
XML
Méthodes publiques
 MéthodeDéfini par
  
XML(value:Object)
Crée un objet XML.
XML
  
Ajoute un espace de noms à l’ensemble d’espaces de noms du domaine associé à l’objet XML.
XML
  
Ajoute l’enfant indiqué à la fin des propriétés de l’objet XML.
XML
  
attribute(attributeName:*):XMLList
Renvoie la valeur XML de l’attribut dont le nom correspond au paramètre attributeName.
XML
  
Renvoie une liste de valeurs d’attribut associée à l’objet XML indiqué.
XML
  
child(propertyName:Object):XMLList
Recense les enfants d’un objet XML.
XML
  
Identifie la position d’index qui commence à zéro de cet objet XML dans le contexte de l’objet parent.
XML
  
Recense les enfants de l’objet XML dans l’ordre dans lequel ils apparaissent.
XML
  
Recense les propriétés de l’objet XML qui contient des commentaires XML.
XML
  
Compare l’objet XML au paramètre value spécifié.
XML
  
Renvoie une copie de l’objet XML spécifié.
XML
  
[statique] Renvoie un objet avec les propriétés suivantes définies sur les valeurs par défaut : ignoreComments, ignoreProcessingInstructions, ignoreWhitespace, prettyIndent et prettyPrinting.
XML
  
Renvoie tous les descendants (enfants, petits-enfants, arrière-petits-enfants, etc.) de l’objet XML associés au paramètre name indiqué.
XML
  
Recense les éléments d’un objet XML.
XML
  
Vérifie si l’objet XML intègre un contenu complexe.
XML
  
Vérifie si l’objet possède la propriété spécifiée par le paramètre p.
XML
  
Vérifie si l’objet XML intègre un contenu simple.
XML
  
Recense les espaces de noms associés à l’objet XML, par rapport au parent de l’objet.
XML
  
Insère le paramètre child2 indiqué après le paramètre child1 dans cet objet XML et renvoie l’objet produit.
XML
  
Insère le paramètre child2 indiqué avant le paramètre child1 dans cet objet XML et renvoie l’objet produit.
XML
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.
Object
  
Pour les objets XML, cette méthode renvoie toujours l’entier 1.
XML
  
Indique la partie nom local du nom complet de l’objet XML.
XML
  
Indique le nom complet de l’objet XML.
XML
  
namespace(prefix:String = null):*
Si vous ne fournissez pas de paramètre, indique l’espace de noms associé au nom complet de cet objet XML.
XML
  
Recense les déclarations d’espace de nom associées à l’objet XML dans le contexte de l’objet parent.
XML
  
Définit le type de nœud : texte, commentaire, instruction de traitement, attribut ou élément.
XML
  
Pour l’objet XML et tous les objets XML descendants, fusionne les nœuds de texte adjacents et supprime les nœuds de texte vides.
XML
  
Renvoie le parent de l’objet XML.
XML
  
Insère une copie de l’objet child fourni dans l’élément XML avant toute propriété XML associée à cet élément.
XML
  
Si un paramètre name est spécifié, la méthode recense tous les enfants de l’objet XML qui contiennent des instructions de traitement portant le nom indiqué.
XML
  
Vérifie si la propriété p figurre dans le jeu de propriétés qui peut faire l’objet d’une itération avec une instruction for..in appliquée à l’objet XML.
XML
  
Supprime l’espace de noms indiqué pour cet objet et tous ses descendants.
XML
  
replace(propertyName:Object, value:XML):XML
Remplace les propriétés spécifiées par le paramètre propertyName par le paramètre value indiqué.
XML
  
Remplace les propriétés enfant de l’objet XML par l’ensemble de propriétés XML spécifié, fourni dans le paramètre value.
XML
  
Remplace le nom local de l’objet XML par le paramètre name indiqué.
XML
  
Règle le nom de l’objet XML sur le nom complet ou le nom d’attribut indiqué.
XML
  
Définit l’espace de noms associé à l’objet XML.
XML
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
  
[statique] Définit les valeurs des propriétés XML suivantes : ignoreComments, ignoreProcessingInstructions, ignoreWhitespace, prettyIndent et prettyPrinting.
XML
  
[statique] Extrait les propriétés suivantes : ignoreComments, ignoreProcessingInstructions, ignoreWhitespace, prettyIndent et prettyPrinting.
XML
  
Renvoie un objet XMLList contenant toutes les propriétés XML de l’objet XML qui représente les nœuds de texte XML.
XML
  
Fournit une méthode remplaçable pour personnaliser l’encodage JSON de valeurs dans un objet XML.
XML
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
  
Renvoie l’objet XML sous forme de chaîne.
XML
  
Renvoie l’objet XML sous forme de chaîne.
XML
  
Renvoie l’objet XML.
XML
Détails de la propriété

ignoreComments

propriété
ignoreComments:Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Détermine si les commentaires XML sont ignorés lorsque les objets XML analysent les données XML source. Par défaut, les commentaires sont ignorés (true). Pour inclure les commentaires XML, réglez cette propriété sur false. La propriété ignoreComments n’est utilisée que lors de l’analyse XML et non pendant l’appel d’une méthode, telle que myXMLObject.child(*).toXMLString(). Si les données XML source contiennent des nœuds de commentaire, ils sont conservés ou éliminés lors de l’analyse XML.



Implémentation
    public static function get ignoreComments():Boolean
    public static function set ignoreComments(value:Boolean):void

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
Cet exemple illustre l’effet de la définition de XML.ignoreComments sur false et sur 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

propriété 
ignoreProcessingInstructions:Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Détermine si les instructions de traitement XML sont ignorées lorsque les objets XML analysent les données XML source. Par défaut, les instructions de traitement sont ignorées (true). Pour les inclure, réglez la propriété sur false. La propriété ignoreProcessingInstructions n’est utilisée que lors de l’analyse XML et non pendant l’appel de toute méthode telle que myXMLObject.child(*).toXMLString(). Si les données XML source contiennent des nœuds d’instructions de traitement, ils sont conservés ou éliminés lors de l’analyse XML.



Implémentation
    public static function get ignoreProcessingInstructions():Boolean
    public static function set ignoreProcessingInstructions(value:Boolean):void

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
Cet exemple illustre l’effet de la définition de XML.ignoreProcessingInstructions sur false et sur 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

propriété 
ignoreWhitespace:Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Détermine si les caractères d’espace blanc placés au début et à la fin des nœuds de texte sont ignorés lors de l’analyse. Les espaces blancs sont ignorés par défaut (true). Si un nœud de texte est entièrement composé d’espaces blancs et que la propriété ignoreWhitespace est définie sur true, il n’est pas créé. Pour afficher les espaces blancs dans un nœud de texte, réglez la propriété ignoreWhitespace sur false.

Lorsque vous créez un objet XML, il place en mémoire cache la valeur actuelle de la propriété ignoreWhitespace. La modification de la propriété ignoreWhitespace ne change pas le comportement des objets XML.



Implémentation
    public static function get ignoreWhitespace():Boolean
    public static function set ignoreWhitespace(value:Boolean):void

Exemple  ( Comment utiliser cet exemple )
Cet exemple illustre l’effet de la définition de XML.ignoreWhitespace sur false et sur 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

propriété 
prettyIndent:int

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Détermine la taille du retrait appliqué par les méthodes toString() et toXMLString() si la propriété XML.prettyPrinting est définie sur true. Les retraits sont appliqués à l’aide de caractères d’espace et non de caractères de tabulation. La valeur par défaut est 2.



Implémentation
    public static function get prettyIndent():int
    public static function set prettyIndent(value:int):void

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
Cet exemple illustre l’effet de la définiton de la propriété statique 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

propriété 
prettyPrinting:Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Détermine si les méthodes toString() et toXMLString() normalisent les caractères d’espace blanc entre certaines balises. La valeur par défaut est true.



Implémentation
    public static function get prettyPrinting():Boolean
    public static function set prettyPrinting(value:Boolean):void

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )
Cet exemple illustre l’effet de la définiton de la propriété statique XML.prettyPrinting :
var xml:XML = <foo><bar/></foo>;
XML.prettyPrinting = false;
trace(xml.toXMLString());

XML.prettyPrinting = true;
trace(xml.toXMLString());
Détails du constructeur

XML

()Constructeur
public function XML(value:Object)

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Crée un objet XML. Vous devez utiliser le constructeur pour créer un objet XML avant d’appeler une des méthodes de la classe XML.

La méthode toXMLString() permet de renvoyer une représentation sous forme de chaîne de l’objet XML, que son contenu soit simple ou complexe.

Paramètres
value:Object — Tout objet qui peut être converti en objet XML à l’aide de la fonction de niveau supérieur XML().

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant indique comment charger un document XML distant dans ActionScript 3.0 à l’aide de la classe URLLoader dans Flash Professional. Exemple fourni par 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();
}

Voici une autre variante utilisant tout le code ActionScript. Exemple fourni par 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);
}
Détails de la méthode

addNamespace

()méthode
AS3 function addNamespace(ns:Object):XML

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Ajoute un espace de noms à l’ensemble d’espaces de noms du domaine associé à l’objet XML. Si l’espace de noms figure déjà dans l’ensemble d’espaces de noms du domaine associé à l’objet XML (avec un préfixe qui correspond au paramètre spécifié), le préfixe correspondant est réglé sur undefined. Si le paramètre d’entrée est un objet Namespace, il est utilisé directement. S’il correspond à un objet QName, l’URI du paramètre d’entrée est utilisé pour créer un espace de noms. Dans le cas contraire, il est converti en chaîne et un espace de noms est généré à partir de la chaîne.

Paramètres

ns:Object — Espace de noms à ajouter à l’objet XML.

Valeur renvoyée
XML — Nouvel objet XML, auquel est ajouté l’espace de noms.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

Cet exemple utilise un espace de noms défini dans un objet XML et l’applique à un autre objet 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

()méthode 
AS3 function appendChild(child:Object):XML

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Ajoute l’enfant indiqué à la fin des propriétés de l’objet XML. La méthode appendChild() accepte un objet XML, un objet XMLList ou tout autre type de données qui est ensuite converti en chaîne.

Utilisez l’opérateur delete (XML) pour supprimer les nœuds XML.

Paramètres

child:Object — Objet XML à ajouter.

Valeur renvoyée
XML — Objet XML produit.

Plus d’exemples

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

Cet exemple ajoute un nouvel élément à la fin de la liste enfant d’un objet 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

()méthode 
AS3 function attribute(attributeName:*):XMLList

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Renvoie la valeur XML de l’attribut dont le nom correspond au paramètre attributeName. Les attributs sont intégrés aux éléments XML. Dans l’exemple suivant, l’élément a un attribut appelé "gender" avec la valeur "boy" : <first gender="boy">John</first>.

Le paramètre attributeName peut correspondre à n’importe quel type de données, mais String est généralement utilisé. Si vous transmettez un objet autre que QName, le paramètre attributeName utilise la méthode toString() pour convertir le paramètre en chaîne.

Si une référence de nom complet s’impose, vous pouvez transmettre un objet QName. Un objet QName définit un espace de noms et le nom local, que vous pouvez utiliser pour définir le nom complet d’un attribut. De ce fait, appeler attribute(qname) n’est pas équivalent à appeler attribute(qname.toString()).

Paramètres

attributeName:* — Nom de l’attribut.

Valeur renvoyée
XMLList — Objet XMLList ou objet XMLList vide. Renvoie un objet XMLList vide si vous n’avez pas défini la valeur d’un attribut.

Plus d’exemples

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

Cet exemple porte sur un objet QName transmis par la méthode attribute(). La propriété localName est attr et la propriété namespace est 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

Pour renvoyer un attribut avec un nom qui correspond à un mot ActionScript réservé, utilisez la méthode attribute() et non pas l’opérateur d’identificateur d’attribut (@), comme dans l’exemple suivant :
 var xml:XML = <example class="first" />
 trace(xml.attribute("class"));
 

attributes

()méthode 
AS3 function attributes():XMLList

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Renvoie une liste de valeurs d’attribut associée à l’objet XML indiqué. Utilisez la méthode name() en conjonction avec la méthode attributes() pour renvoyer le nom d’un attribut. L’utilisation de xml.attributes() est équivalente à xml.@*.

Valeur renvoyée
XMLList — Liste de valeurs d’attributs.

Plus d’exemples

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant renvoie le nom de l’attribut :
var xml:XML=<example id='123' color='blue'/>
trace(xml.attributes()[1].name()); //color

Cet exemple renvoie les noms de tous les attributs :
 
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

()méthode 
AS3 function child(propertyName:Object):XMLList

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Recense les enfants d’un objet XML. Un enfant XML est un élément, un nœud de texte, un commentaire ou une instruction de traitement XML.

Le paramètre propertyName permet de recenser le contenu d’un enfant XML spécifique. Par exemple, pour renvoyer le contenu d’un enfant appelé <first>, appelez child("first") sur l’objet XML. Vous pouvez générer le même résultat à partir du numéro d’index de l’enfant. Le numéro d’index identifie la position de l’enfant dans la liste d’enfants XML. Par exemple, child(0) renvoie le premier enfant d’une liste.

Utilisez un astérisque (*) pour extraire tous les enfants dans un document XML. Exemple : doc.child("*").

La méthode length() associée au paramètre astérisque (*) de la méthode child() permet de produire le nombre total d’enfants. Exemple : numChildren = doc.child("*").length().

Paramètres

propertyName:Object — Nom de l’élément ou entier de l’objet XML enfant.

Valeur renvoyée
XMLList — Objet XMLList contenant les nœuds enfant qui correspondent au paramètre d’entrée.

Plus d’exemples

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

Cet exemple porte sur l’utilisation de la méthode child() pour identifier les éléments enfant avec le nom spécifié :
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

()méthode 
AS3 function childIndex():int

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Identifie la position d’index qui commence à zéro de cet objet XML dans le contexte de l’objet parent.

Valeur renvoyée
int — Position de l’objet. Renvoie -1 et des entiers positifs.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

Cet exemple indique comment utiliser la méthode childIndex() :
var xml:XML = 
            <foo>
                <bar />
                text
                <bob />
            </foo>;
trace(xml.bar.childIndex()); // 0
trace(xml.bob.childIndex()); // 2

children

()méthode 
AS3 function children():XMLList

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Recense les enfants de l’objet XML dans l’ordre dans lequel ils apparaissent. Un enfant XML est un élément, un nœud de texte, un commentaire ou une instruction de traitement XML.

Valeur renvoyée
XMLList — Objet XMLList contenant les enfants de l’objet XML.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

Cet exemple indique comment utiliser la méthode 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

()méthode 
AS3 function comments():XMLList

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Recense les propriétés de l’objet XML qui contient des commentaires XML.

Valeur renvoyée
XMLList — Objet XMLList des propriétés qui contiennent des commentaires.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

Cet exemple indique comment utiliser la méthode comments() :
XML.ignoreComments = false;
var xml:XML = 
        <foo>
            <!-- example -->
            <!-- example2 -->
        </foo>;
trace(xml.comments().length()); // 2
trace(xml.comments()[1].toXMLString()); // <!-- example2 -->

contains

()méthode 
AS3 function contains(value:XML):Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Compare l’objet XML au paramètre value spécifié.

Paramètres

value:XML — Valeur à comparer à l’objet XML en cours.

Valeur renvoyée
Boolean — Renvoie true si l’objet XML correspond au paramètre value, false dans le cas contraire.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

Cet exemple indique comment utiliser la méthode 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

()méthode 
AS3 function copy():XML

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Renvoie une copie de l’objet XML spécifié. Cette copie est une duplication de l’arborescence entière de nœuds. L’objet XML copié ne possède pas de parent et renvoie null si vous tentez d’appeler la méthode parent().

Valeur renvoyée
XML — Copie de l’objet.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

Cet exemple indique que la méthode copy() crée une nouvelle occurrence d’un objet XML. Lorsque vous modifiez la copie, l’original reste inchangé :
var xml1:XML = <foo />;
var xml2:XML = xml1.copy();
xml2.appendChild(<bar />);
trace(xml1.bar.length()); // 0
trace(xml2.bar.length()); // 1

defaultSettings

()méthode 
AS3 static function defaultSettings():Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Renvoie un objet avec les propriétés suivantes définies sur les valeurs par défaut : ignoreComments, ignoreProcessingInstructions, ignoreWhitespace, prettyIndent et prettyPrinting. Les valeurs par défaut sont les suivantes :

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

Remarque : cette méthode ne doit pas être appliquée à une occurrence de la classe XML, mais à XML, comme illustré dans le code suivant : var df:Object = XML.defaultSettings().

Valeur renvoyée
Object — Objet dont les propriétés sont réglées sur leur valeur par défaut.

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple ci-dessous illustre les points suivants : comment appliquer des paramètres personnalisés (pour l’inclusion de commentaires et d’instructions de traitement) avant de définir un objet XML ; comment ensuite rétablir les paramètres par défaut avant de définir un autre objet XML ; et enfin comment définir de nouveau les paramètres par défaut (pour définir d’autres objets 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

()méthode 
AS3 function descendants(name:Object = *):XMLList

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Renvoie tous les descendants (enfants, petits-enfants, arrière-petits-enfants, etc.) de l’objet XML associés au paramètre name indiqué. Le paramètre name est facultatif. Le paramètre name peut être un objet QName, un type de données String ou tout autre type de données converti ensuite au type de données String.

Pour renvoyer tous les descendants, utilisez le paramètre « * ». Si aucun paramètre n’est transmis, la chaîne « * » est transmise et renvoie tous les descendants de l’objet XML.

Paramètres

name:Object (default = *) — Nom de l’élément pour lequel établir une correspondance.

Valeur renvoyée
XMLList — Objet XMLList contenant tous les descendants correspondants. S’il n’existe pas de descendants, la méthode renvoie un objet XMLList vide.

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

Pour renvoyer les descendants sous des noms qui correspondent aux mots réservés ActionScript, utilisez la méthode descendants() de préférence à l’opérateur de descendance (..), comme indiqué dans l’exemple suivant :
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")); 

Cet exemple illustre le fait que la méthode descendants() renvoie un objet XMLList qui contient tous les objets descendants, ce qui inclut les enfants, les petits enfants, etc. :
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

()méthode 
AS3 function elements(name:Object = *):XMLList

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Recense les éléments d’un objet XML. Un élément se compose d’une balise de début et d’une balise de fin, telle que <first></first>. Le paramètre name est facultatif. Le paramètre name peut être un objet QName, un type de données String ou tout autre type de données converti ensuite au type de données String. Utilisez le paramètre name pour recenser un élément spécifique. Par exemple, l’élément first renvoie John dans cet exemple : <first>John</first>.

Pour recenser tous les éléments, utilisez le paramètre astérisque (*). L’astérisque est également le paramètre par défaut.

La méthode length() associée au paramètre astérisque permet d’extraire le nombre total d’éléments. Par exemple, numElement = addressbook.elements("*").length().

Paramètres

name:Object (default = *) — Nom de l’élément. Un nom d’élément est entouré de chevrons. Par exemple, "first" correspond à name dans cet exemple : <first></first> .

Valeur renvoyée
XMLList — Objet XMLList qui comporte le contenu de l’élément. Le contenu d’un élément est compris entre la balise de début et la balise de fin. Si vous utilisez l’astérisque (*) pour appeler tous les éléments, les balises et le contenu sont renvoyés.

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant indique que la méthode elements() renvoie uniquement une liste d’éléments — sans commentaire, propriété de texte ou instruction de traitement :
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>

Pour renvoyer les descendants sous des noms qui correspondent aux mots réservés ActionScript, utilisez la méthode elements() de préférence à l’opérateur point (.) du code XML, comme indiqué dans l’exemple suivant :
var xml:XML =
 <student id="206">
    <class name="Trigonometry" />
    <class name="Spanish 2" />
 </student>
trace(xml.elements("class")); 

hasComplexContent

()méthode 
AS3 function hasComplexContent():Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Vérifie si l’objet XML intègre un contenu complexe. Le contenu d’un objet XML est complexe s’il possède des éléments enfant. Les objets XML qui représentent des attributs, des commentaires, des instructions de traitement et des nœuds de texte n’intègrent pas un contenu complexe. Le contenu d’un objet qui intègre ces entités peut néanmoins être considéré comme complexe si l’objet possède des éléments enfant.

Valeur renvoyée
Boolean — Renvoie true si l’objet XML intègre un contenu complexe, false dans le cas contraire.

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant porte sur un objet XML, avec une propriété appelée a qui a un contenu simple et une autre propriété a qui a du contenu complexe :
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

()méthode 
AS3 function hasOwnProperty(p:String):Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Vérifie si l’objet possède la propriété spécifiée par le paramètre p.

Paramètres

p:String — Propriété pour laquelle établir une correspondance.

Valeur renvoyée
Boolean — Renvoie true si la propriété existe, false dans le cas contraire.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant utilise la méthode hasOwnProperty() pour s’assurer que la propriété (b) existe avant d’évaluer une expression (b == "11") qui utilise cette propriété :
var xml:XML = 
        <foo>
            <a />
            <a>
                <b>10</b>
            </a>
            <a>
                <b>11</b>
            </a>
        </foo>;
trace(xml.a.(hasOwnProperty("b") && b == "11")); 
Si la dernière ligne de cet exemple était remplacée par ce qui suit, Flash Player renverrait une exception dans la mesure où le premier élément appelé a ne comporte pas de propriété b :

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


L’exemple suivant utilise la méthode hasOwnProperty() pour s’assurer que la propriété (item) existe avant d’évaluer une expression (item.contains("toothbrush")) qui utilise cette propriété :
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

()méthode 
AS3 function hasSimpleContent():Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Vérifie si l’objet XML intègre un contenu simple. Un objet XML intègre un contenu simple s’il représente un nœud de texte, un nœud d’attribut ou un élément XML sans élément enfant. Les objets XML qui représentent des commentaires et des instructions de traitement n’intègrent pas un contenu simple.

Valeur renvoyée
Boolean — Renvoie true si l’objet XML intègre un contenu simple, false dans le cas contraire.

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant porte sur un objet XML, avec une propriété appelée a qui a un contenu simple et une autre propriété a qui a du contenu complexe :
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

()méthode 
AS3 function inScopeNamespaces():Array

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Recense les espaces de noms associés à l’objet XML, par rapport au parent de l’objet.

Valeur renvoyée
Array — Tableau d’objets Namespace.

Informations complémentaires

insertChildAfter

()méthode 
AS3 function insertChildAfter(child1:Object, child2:Object):*

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Insère le paramètre child2 indiqué après le paramètre child1 dans cet objet XML et renvoie l’objet produit. Si le paramètre child1 est réglé sur null, la méthode insère le contenu de child2 avant tous les enfants de l’objet XML (en d’autres termes, après none). Si child1 est fourni, mais qu’il n’existe pas dans l’objet XML, celui-ci n’est pas modifié et undefined est renvoyé.

Si vous appelez cette méthode pour un enfant XML qui n’est pas un élément (texte, attributs, commentaires, pi, etc.), undefined est renvoyé.

Utilisez l’opérateur delete (XML) pour supprimer les nœuds XML.

Paramètres

child1:Object — Objet dans l’objet source que vous insérez avant child2.
 
child2:Object — Objet à insérer.

Valeur renvoyée
* — Objet XML produit ou undefined.

Plus d’exemples

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant ajoute un nouvel élément à la fin des éléments enfant d’un objet XML :
var xml:XML = 
        <menu>
            <item>burger</item>
            <item>soda</item>
        </menu>;
xml.insertChildAfter(xml.item[0], <saleItem>fries</saleItem>);
trace(xml);
Le code trace() suivant est renvoyé :
 <menu>
     <item>burger</item>
     <saleItem>fries</saleItem>
     <item>soda</item>
 </menu>

insertChildBefore

()méthode 
AS3 function insertChildBefore(child1:Object, child2:Object):*

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Insère le paramètre child2 indiqué après le paramètre child1 dans cet objet XML et renvoie l’objet produit. Si le paramètre child1 est réglé sur null, la méthode insère le contenu de child2 après tous les enfants de l’objet XML (en d’autres termes, avant none). Si child1 est fourni, mais qu’il n’existe pas dans l’objet XML, celui-ci n’est pas modifié et undefined est renvoyé.

Si vous appelez cette méthode pour un enfant XML qui n’est pas un élément (texte, attributs, commentaires, pi, etc.), undefined est renvoyé.

Utilisez l’opérateur delete (XML) pour supprimer les nœuds XML.

Paramètres

child1:Object — Objet de l’objet source que vous insérez après child2.
 
child2:Object — Objet à insérer.

Valeur renvoyée
* — Objet XML produit ou undefined.

Plus d’exemples

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant ajoute un nouvel élément à la fin des éléments enfant d’un objet XML :
var xml:XML = 
        <menu>
            <item>burger</item>
            <item>soda</item>
        </menu>;
xml.insertChildBefore(xml.item[0], <saleItem>fries</saleItem>);
trace(xml);
Le code trace() suivant est renvoyé :
 <menu>
     <saleItem>fries</saleItem>
     <item>burger</item>
     <item>soda</item>
 </menu>

length

()méthode 
AS3 function length():int

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Pour les objets XML, cette méthode renvoie toujours l’entier 1. La méthode length() de la classe XMLList renvoie la valeur 1 si l’objet XMLList ne contient qu’une seule valeur.

Valeur renvoyée
int — Renvoie toujours 1 pour tout objet XML.

Informations complémentaires

localName

()méthode 
AS3 function localName():Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Indique la partie nom local du nom complet de l’objet XML.

Valeur renvoyée
Object — Nom local exprimé sous forme de chaîne ou null.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant illustre l’utilisation de la méthode 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

()méthode 
AS3 function name():Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Indique le nom complet de l’objet XML.

Valeur renvoyée
Object — Le nom complet correspond à QName ou null.

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant illustre l’utilisation de la méthode name() pour obtenir le nom qualifié d’un objet 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"

L’exemple suivant illustre l’utilisation de la méthode name() lorsqu’elle est appelée sur une propriété XML, sur un élément de texte et sur un attribut :
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

()méthode 
AS3 function namespace(prefix:String = null):*

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Si vous ne fournissez pas de paramètre, indique l’espace de noms associé au nom complet de cet objet XML. Si vous spécifiez un paramètre prefix, la méthode renvoie l’espace de noms correspondant au paramètre prefix qui figure dans le domaine associé à l’objet XML. S’il n’existe pas d’espace de noms de ce type, la méthode renvoie undefined.

Paramètres

prefix:String (default = null) — Préfixe pour lequel établir une correspondance.

Valeur renvoyée
* — Renvoie null, undefined ou un espace de noms.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant utilise la méthode namespace() pour obtenir l’espace de noms d’un objet XML et l’affecter à un objet Namespace appelé soap qui est ensuite utilisé pour identifier une propriété de l’objet 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"

L’exemple suivant utilise la méthode namespace() pour obtenir l’espace de noms par défaut d’un nœud, ainsi que l’espace de noms pour un préfixe spécifique ("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

()méthode 
AS3 function namespaceDeclarations():Array

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Recense les déclarations d’espace de nom associées à l’objet XML dans le contexte de l’objet parent.

Valeur renvoyée
Array — Tableau d’objets Namespace.

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant renvoie les déclarations d’espace de noms d’un objet 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);
}
Le code trace() suivant est renvoyé :
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

()méthode 
AS3 function nodeKind():String

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Définit le type de nœud : texte, commentaire, instruction de traitement, attribut ou élément.

Valeur renvoyée
String — Type de nœud utilisé.

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

Cet exemple suit les cinq types de nœud :
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

()méthode 
AS3 function normalize():XML

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Pour l’objet XML et tous les objets XML descendants, fusionne les nœuds de texte adjacents et supprime les nœuds de texte vides.

Valeur renvoyée
XML — Objet XML normalisé produit.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant illustre l’effet de l’appel de la méthode 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

()méthode 
AS3 function parent():*

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Renvoie le parent de l’objet XML. Si l’objet XML ne possède pas de parent, la méthode renvoie undefined.

Valeur renvoyée
* — Une référence XML du noeud parent ou undefined si l’objet XML n’a pas de parent.

Plus d’exemples

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant utilise la méthode parent() pour identifier l’élément parent d’un élément spécifique dans une structure 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

()méthode 
AS3 function prependChild(value:Object):XML

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Insère une copie de l’objet child fourni dans l’élément XML avant toute propriété XML associée à cet élément.

Utilisez l’opérateur delete (XML) pour supprimer les nœuds XML.

Paramètres

value:Object — Objet à insérer.

Valeur renvoyée
XML — Objet XML produit.

Plus d’exemples

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant utilise la méthode prependChild() pour ajouter un élément au début de la liste d’enfants d’un objet 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

()méthode 
AS3 function processingInstructions(name:String = "*"):XMLList

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Si un paramètre name est spécifié, recense tous les enfants de l’objet XML qui contiennent des instructions de traitement portant le name indiqué. Si aucun paramètre n’est spécifié, la méthode recense tous les enfants de l’objet XML qui contiennent des instructions de traitement.

Paramètres

name:String (default = "*") — Nom des instructions de traitement pour lesquelles établir une correspondance.

Valeur renvoyée
XMLList — Liste d’objets enfant correspondants.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant utilise la méthode processingInstructions() pour obtenir un tableau d’instructions de traitement pour un objet 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

()méthode 
AS3 function propertyIsEnumerable(p:String):Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Vérifie si la propriété p figure dans le jeu de propriétés qui peut faire l’objet d’une itération avec une instruction for..in appliquée à l’objet XML. Ne renvoie true que si toString(p) == "0".

Paramètres

p:String — Propriété à vérifier.

Valeur renvoyée
Boolean — Si la propriété peut faire l’objet d’une itération dans une instruction for..in, puis true ; sinon false.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant indique que, pour un objet XML, la méthode propertyNameIsEnumerable() ne renvoie la valeur true que pour la valeur 0, tandis que pour un objet XMLList, la valeur renvoyée est true pour chaque valeur d’index valide pour l’objet 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

()méthode 
AS3 function removeNamespace(ns:Namespace):XML

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Supprime l’espace de noms indiqué pour cet objet et tous ses descendants. La méthode removeNamespaces() ne supprime pas un espace de noms s’il est référencé par le nom complet de l’objet ou celui des attributs de l’objet.

Paramètres

ns:Namespace — Espace de noms à supprimer.

Valeur renvoyée
XML — Copie de l’objet XML produit.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant indique comment supprimer une déclaration d’espace de noms à partir d’un objet 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

()méthode 
AS3 function replace(propertyName:Object, value:XML):XML

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Remplace les propriétés spécifiées par le paramètre propertyName par le paramètre value indiqué. Si aucune propriété ne correspond à propertyName, l’objet XML n’est pas modifié.

Paramètres

propertyName:Object — Peut être une valeur numérique, un nom incomplet d’ensemble d’éléments XML, un nom complet d’ensemble d’éléments XML ou le caractère générique astérisque (« * »). Utilisez un nom incomplet pour identifier les éléments XML dans l’espace de noms par défaut.
 
value:XML — Valeur de remplacement, qui peut être un objet XML, un objet XMLList ou toute valeur pouvant être convertie par le biais de toString().

Valeur renvoyée
XML — Objet XML produit, dans lequel les propriétés correspondantes ont été remplacées.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant illustre l’appel à la méthode replace() avec un entier en tant que premier paramètre :
var xml:XML = 
    <body>
        <p>Hello</p>
        <p>World</p>
        <hr/>
    </body>;

xml.replace(1, <p>Bob</p>);
trace(xml);
Le résultat du code trace() est le suivant :

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

L’exemple suivant appelle la méthode replace() avec une chaîne en tant que premier paramètre :
var xml:XML = 
    <body>
        <p>Hello</p>
        <p>World</p>
        <hr/>
    </body>;

xml.replace("p", <p>Hi</p>); 
trace(xml);
Le résultat du code trace() est le suivant :

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

L’exemple suivant illustre l’appel à la méthode replace() avec un QName en tant que premier paramètre :
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);

Le résultat du code trace() est le suivant :

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

L’exemple suivant illustre l’appel à la méthode replace() avec la chaîne "*" en tant que premier paramètre :
var xml:XML = 
    <body>
        <p>Hello</p>
        <p>World</p>
        <hr/>
    </body>;

xml.replace("*", <img src = "hello.jpg"/>);
trace(xml);
Le résultat du code trace() est le suivant :

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

setChildren

()méthode 
AS3 function setChildren(value:Object):XML

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Remplace les propriétés enfant de l’objet XML par l’ensemble de propriétés XML spécifié, fourni dans le paramètre value.

Paramètres

value:Object — Propriétés XML de remplacement (objet XML unique ou objet XMLList).

Valeur renvoyée
XML — Objet XML produit.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant illustre l’appel de la méthode setChildren(), tout d’abord en utilisant un objet XML en tant que paramètre, puis utilise un objet XMLList en tant que paramètre :
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

()méthode 
AS3 function setLocalName(name:String):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Remplace le nom local de l’objet XML par le paramètre name indiqué.

Paramètres

name:String — Nom de remplacement du nom local.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant utilise la méthode setLocalName() pour modifier le nom local d’un élément 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

()méthode 
AS3 function setName(name:String):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Règle le nom de l’objet XML sur le nom complet ou le nom d’attribut indiqué.

Paramètres

name:String — Nouveau nom de l’objet.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant utilise la méthode setName() pour modifier le nom local d’un élément XML :
var xml:XML = 
    <item>
        toothbrush
    </item>;
    
xml.setName("orderItem");
trace(xml.toXMLString()); // <orderItem>toothbrush</orderItem>

setNamespace

()méthode 
AS3 function setNamespace(ns:Namespace):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Définit l’espace de noms associé à l’objet XML.

Paramètres

ns:Namespace — Nouvel espace de noms.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant utilise l’espace de noms soap défini dans un objet XML et l’applique à l’espace de noms d’un autre objet 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

()méthode 
AS3 static function setSettings(... rest):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Définit les valeurs des propriétés XML suivantes : ignoreComments, ignoreProcessingInstructions, ignoreWhitespace, prettyIndent et prettyPrinting. Les réglages par défaut, appliqués si vous ne spécifiez pas de paramètre setObj, sont les suivants :

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

Remarque : cette méthode ne doit pas être appliquée à une occurrence de la classe XML, mais à XML, comme illustré dans le code suivant : XML.setSettings().

Paramètres

... rest — Objet doté des propriétés suivantes :
  • ignoreComments
  • ignoreProcessingInstructions
  • ignoreWhitespace
  • prettyIndent
  • prettyPrinting

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple ci-dessous illustre les points suivants : comment appliquer des paramètres personnalisés (pour l’inclusion de commentaires et d’instructions de traitement) avant de définir un objet XML ; comment ensuite rétablir les paramètres par défaut avant de définir un autre objet XML ; et enfin comment définir de nouveau les paramètres par défaut (pour définir d’autres objets 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

()méthode 
AS3 static function settings():Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Extrait les propriétés suivantes : ignoreComments, ignoreProcessingInstructions, ignoreWhitespace, prettyIndent et prettyPrinting.

Valeur renvoyée
Object — Objet doté des propriétés XML suivantes :
  • ignoreComments
  • ignoreProcessingInstructions
  • ignoreWhitespace
  • prettyIndent
  • prettyPrinting

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple ci-dessous illustre les points suivants : comment appliquer des paramètres personnalisés (pour l’inclusion de commentaires et d’instructions de traitement) avant de définir un objet XML ; comment ensuite rétablir les paramètres par défaut avant de définir un autre objet XML ; et enfin comment définir de nouveau les paramètres par défaut (pour définir d’autres objets 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

()méthode 
AS3 function text():XMLList

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Renvoie un objet XMLList contenant toutes les propriétés XML de l’objet XML qui représente les nœuds de texte XML.

Valeur renvoyée
XMLList — Liste des propriétés.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant utilise la méthode text() pour obtenir les nœuds texte d’un objet XML :
var xml:XML =
        <body>
            text1
            <hr/>
            text2
        </body>;
trace(xml.text()[0]); // text1
trace(xml.text()[1]); // text2

toJSON

()méthode 
AS3 function toJSON(k:String):*

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 11, AIR 3, Flash Lite 4

Fournit une méthode remplaçable pour personnaliser l’encodage JSON de valeurs dans un objet XML.

La méthode JSON.stringify() recherche une méthode toJSON() sur chaque objet qu’elle traverse. Si la méthode toJSON() est trouvée, la méthode JSON.stringify() l’appelle automatiquement pour chaque valeur qu’elle rencontre, en transmettant la clé associée à la valeur.

XML fournit une implémentation par défaut de la méthode toJSON(), qui renvoie simplement le nom de la classe. Les clients qui souhaitent exporter les objets XML vers la méthode JSON doivent fournir leur propre implémentation. Pour ce faire, vous pouvez redéfinir la méthode toJSON() sur le prototype de classe.

La méthode toJSON() peut renvoyer une valeur de n’importe quel type. Si elle renvoie un objet, stringify() se répète dans cet objet. Si toJSON() renvoie une chaîne, stringify() ne se répète pas et poursuit sa traversée.

Paramètres

k:String — Clé d’une paire clé/valeur que la méthode JSON.stringify() a rencontré lors de la traversée de cet objet.

Valeur renvoyée
* — Nom de la classe String.

Informations complémentaires

Eléments de l’API associés

Object
Object.prototype

toString

()méthode 
AS3 function toString():String

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Renvoie l’objet XML sous forme de chaîne. Les règles de cette conversion varient selon que l’objet XML intègre un contenu simple ou complexe :

  • Si l’objet XML comporte un contenu simple, toString() renvoie le contenu de la chaîne de l’objet XML en éliminant les éléments suivants : la balise initiale, les attributs, les déclarations d’espace de noms et la balise de fin.
  • Si l’objet XML intègre un contenu complexe, toString() renvoie une chaîne codée au format XML qui représente l’objet XML entier, y compris la balise de début, les attributs, les déclarations d’espace de noms et la balise de fin.

Pour renvoyer à chaque fois l’objet XML entier, utilisez la méthode toXMLString().

Valeur renvoyée
String — Représentation sous forme de chaîne de l’objet XML.

Plus d’exemples

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant indique ce que la méthode toString() renvoie lorsque l’objet XML a un contenu simple :
var test:XML = <type name="Joe">example</type>;
trace(test.toString()); //example

L’exemple suivant indique ce que la méthode toString() renvoie lorsque l’objet XML a un contenu complexe :
var test:XML = 
<type name="Joe">
    <base name="Bob"></base>
    example
</type>;
trace(test.toString());
  // <type name="Joe">
  // <base name="Bob"/>
  // example
  // </type> 

toXMLString

()méthode 
AS3 function toXMLString():String

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Renvoie l’objet XML sous forme de chaîne. A l’encontre de la méthode toString(), la méthode toXMLString() renvoie toujours la balise de début, les attributs et la balise de fin de l’objet XML, que son contenu soit simple ou complexe (la méthode toString() supprime ces éléments si l’objet XML intègre un contenu simple).

Valeur renvoyée
String — Représentation sous forme de chaîne de l’objet XML.

Plus d’exemples

Informations complémentaires

Eléments de l’API associés


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant illustre la différence entre l’utilisation de la méthode toString() (qui s’applique à tous les paramètres d’une méthode trace(), par défaut) et celle de la méthode toXMLString() :
var xml:XML =
        <p>hello</p>;
trace(xml); // hello
trace(xml.toXMLString()); // <p>hello</p>

valueOf

()méthode 
AS3 function valueOf():XML

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9

Renvoie l’objet XML.

Valeur renvoyée
XML — Valeur primitive d’une occurrence de XML.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

L’exemple suivant indique que la valeur renvoyée par la méthode valueOf() est identique à l’objet XML source :
var xml:XML = <p>hello</p>;
trace(xml.valueOf() === xml); // true
XMLExample.as

L’exemple suivant crée tout d’abord une variable XML, puis y ajoute des nœuds. Ensuite, les propriétés XML permettent de trouver et imprimer des nœuds XML. Vous pouvez constater que le symbole « arrobase » (@) est utilisé dans plusieurs des appels trace() pour rechercher des informations en fonction du nom d’attribut.
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 ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.