包 | flash.events |
类 | public class SecurityErrorEvent |
继承 | SecurityErrorEvent ErrorEvent TextEvent Event Object |
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
text
属性,以确定尝试过哪些操作以及涉及哪些 URL。如果没有事件侦听器,Flash Player 的调试版或 AIR Debug Launcher (ADL) 应用程序将自动显示包含 text
属性内容的错误消息。只有一种类型的安全错误事件:SecurityErrorEvent.SECURITY_ERROR
。
安全错误事件是针对任何目标对象进行调度的最终事件。这意味着对于遇到安全错误的目标对象,不能调度任何其他事件(包括一般错误事件)。
相关 API 元素
公共方法
方法 | 由以下参数定义 | ||
---|---|---|---|
SecurityErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
创建一个 Event 对象,其中包含有关安全错误事件的信息。 | SecurityErrorEvent | ||
[覆盖]
创建 SecurityErrorEvent 对象的副本,并设置每个属性的值以匹配原始属性值。 | SecurityErrorEvent | ||
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。 | Event | ||
表示对象是否已经定义了指定的属性。 | Object | ||
检查是否已对事件调用 preventDefault() 方法。 | Event | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
如果可以取消事件的默认行为,则取消该行为。 | Event | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
设置循环操作动态属性的可用性。 | Object | ||
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。 | Event | ||
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。 | Event | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
[覆盖]
返回一个字符串,其中包含 SecurityErrorEvent 对象的所有属性。 | SecurityErrorEvent | ||
返回指定对象的原始值。 | Object |
公共常量
常量 | 由以下参数定义 | ||
---|---|---|---|
SECURITY_ERROR : String = "securityError" [静态]
SecurityErrorEvent.SECURITY_ERROR 常量定义 securityError 事件对象的 type 属性值。 | SecurityErrorEvent |
构造函数详细信息
SecurityErrorEvent | () | 构造函数 |
public function SecurityErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
创建一个 Event 对象,其中包含有关安全错误事件的信息。将 Event 对象作为参数传递给事件侦听器。
参数type:String — 事件的类型。事件侦听器可以通过继承的 type 属性访问此信息。只有一种类型的 error 事件:SecurityErrorEvent.SECURITY_ERROR 。
| |
bubbles:Boolean (default = false ) — 确定 Event 对象是否参与事件流的冒泡阶段。事件侦听器可以通过继承的 bubbles 属性访问此信息。
| |
cancelable:Boolean (default = false ) — 确定是否可以取消 Event 对象。事件侦听器可以通过继承的 cancelable 属性访问此信息。
| |
text:String (default = " ") — 要显示为错误消息的文本。事件侦听器可以通过 text 属性访问此信息。
| |
id:int (default = 0 ) — 要与特定错误关联的引用数字。
|
相关 API 元素
方法详细信息
clone | () | 方法 |
toString | () | 方法 |
override public function toString():String
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
返回一个字符串,其中包含 SecurityErrorEvent 对象的所有属性。字符串的格式如下:
[securityErrorEvent type=value bubbles=value cancelable=value text=value errorID=value]
errorId
仅在 Adobe AIR 中可用
String — 一个字符串,其中包含 SecurityErrorEvent 对象的所有属性。
|
常量详细信息
SECURITY_ERROR | 常量 |
public static const SECURITY_ERROR:String = "securityError"
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
SecurityErrorEvent.SECURITY_ERROR
常量定义 securityError
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false ;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 报告安全错误的网络对象。 |
text | 要显示为错误消息的文本。 |
相关 API 元素
示例 如何使用本示例
SecurityErrorEventExample.as
以下示例使用
SecurityErrorEventExample
类来说明如何实例化侦听器方法 securityErrorHandler()
并将其设置为侦听将要调度的 securityError
事件。当 URLRequest
位置与调用 SWF 不完全属于同一个域,而且请求的域没有获得通过跨域策略文件进行跨域访问的授权时,会发生此事件。
要创建 SecurityErrorEvent
,请将 http://www.[yourdomain].com
替换为一个未获得跨域访问授权的路径。
package { import flash.display.Sprite; import flash.net.URLLoader; import flash.net.URLRequest; import flash.events.SecurityErrorEvent; public class SecurityErrorEventExample extends Sprite { public function SecurityErrorEventExample() { var loader:URLLoader = new URLLoader(); loader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); var request:URLRequest = new URLRequest("http://www.[yourDomain].com"); loader.load(request); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } } }
Tue Jun 12 2018, 11:04 AM Z