Adobe® Flash® Platform용 ActionScript® 3.0 참조 설명서
 |  패키지 및 클래스 목록 숨기기 |  패키지  |  클래스  |  새로운 내용  |  색인  |  부록  |  영어로 표시되는 이유
필터: 서버에서 데이터를 검색하는 중...
서버에서 데이터를 검색하는 중...
flash.events 

IOErrorEvent  - AS3

패키지flash.events
클래스public class IOErrorEvent
상속IOErrorEvent Inheritance ErrorEvent Inheritance TextEvent Inheritance Event Inheritance Object

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0, Flash Player 9, Flash Lite 4

오류로 인해 입력 또는 출력 작업에 실패할 때 IOErrorEvent 객체가 전달됩니다.

Flash Player의 디버거 버전 또는 ADL(AIR Debug Launcher)을 사용하여 리스너가 없는 오류 이벤트를 확인할 수 있습니다. IOErrorEvent 생성자의 text 매개 변수에 의해 정의된 문자열이 표시됩니다.

예제 보기

관련 API 요소



공용 속성
 속성정의 주체
 Inheritedbubbles : Boolean
[읽기 전용] 이벤트가 버블링 이벤트인지 여부를 나타냅니다.
Event
 Inheritedcancelable : Boolean
[읽기 전용] 해당 이벤트와 연관된 비헤이비어를 차단할 수 있는지 여부를 나타냅니다.
Event
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
 InheritedcurrentTarget : Object
[읽기 전용] 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
Event
 InheritederrorID : int
[읽기 전용] 특정 오류와 연결된 참조 번호가 포함되어 있습니다.
ErrorEvent
 InheritedeventPhase : uint
[읽기 전용] 이벤트 흐름에서 현재 단계입니다.
Event
 Inheritedtarget : Object
[읽기 전용] 이벤트 대상입니다.
Event
 Inheritedtext : String
textInput 이벤트의 경우, 입력한 문자 또는 일련의 문자입니다.
TextEvent
 Inheritedtype : String
[읽기 전용] 이벤트 유형입니다.
Event
공용 메서드
 메서드정의 주체
  
IOErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
ioError 이벤트에 대한 특정 정보가 포함된 Event 객체를 만듭니다.
IOErrorEvent
  
[재정의] IOErrorEvent 객체의 복사본을 하나 만들고 각 속성의 값을 원본과 동일하게 설정합니다.
IOErrorEvent
 Inherited
formatToString(className:String, ... arguments):String
사용자 정의 ActionScript 3.0 Event 클래스에서 toString() 메서드를 구현하기 위한 유틸리티 함수입니다.
Event
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
이벤트에서 preventDefault() 메서드가 호출되었는지 여부를 확인합니다.
Event
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
이벤트의 기본 비헤이비어를 취소할 수 있는 경우, 그 비헤이비어를 취소합니다.
Event
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
이벤트 흐름에서 현재 노드 및 그 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.
Event
 Inherited
이벤트 흐름에서 현재 노드의 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.
Event
 Inherited
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.
Object
  
[재정의] IOErrorEvent 객체의 속성이 모두 포함된 문자열을 반환합니다.
IOErrorEvent
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
공용 상수
 상수정의 주체
  IO_ERROR : String = "ioError"
[정적] ioError 이벤트 객체의 type 속성 값을 정의합니다.
IOErrorEvent
  STANDARD_ERROR_IO_ERROR : String = "standardErrorIoError"
[정적] standardErrorIoError 이벤트는 NativeProcess 객체의 standardError 스트림에서 데이터를 읽는 동안 오류가 발생할 때 전달됩니다.
IOErrorEvent
  STANDARD_INPUT_IO_ERROR : String = "standardInputIoError"
[정적] standardInputIoError 이벤트는 NativeProcess 객체의 standardInput에 데이터를 쓰는 동안 오류가 발생할 때 전달됩니다.
IOErrorEvent
  STANDARD_OUTPUT_IO_ERROR : String = "standardOutputIoError"
[정적] standardOutputIoError 이벤트는 NativeProcess 객체의 standardOutput 스트림에서 데이터를 읽는 동안 오류가 발생할 때 전달됩니다.
IOErrorEvent
생성자 세부 정보

IOErrorEvent

()생성자
public function IOErrorEvent(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

ioError 이벤트에 대한 특정 정보가 포함된 Event 객체를 만듭니다. Event 객체는 매개 변수로 이벤트 리스너에 전달됩니다.

매개 변수
type:String — 이벤트 유형입니다. 이벤트 리스너는 상속된 type 속성을 통해 이 정보에 액세스할 수 있습니다. 입력/출력 오류 이벤트 유형은 IOErrorEvent.IO_ERROR 한 가지뿐입니다.
 
bubbles:Boolean (default = false) — Event 객체가 이벤트 흐름의 버블링 단계에 참여하는지 여부를 결정합니다. 이벤트 리스너는 상속된 bubbles 속성을 통해 이 정보에 액세스할 수 있습니다.
 
cancelable:Boolean (default = false) — Event 객체를 취소할 수 있는지 여부를 결정합니다. 이벤트 리스너는 상속된 cancelable 속성을 통해 이 정보에 액세스할 수 있습니다.
 
text:String (default = "") — 오류 메시지로 표시될 텍스트입니다. 이벤트 리스너는 text 속성을 통해 이 정보에 액세스할 수 있습니다.
 
id:int (default = 0) — 특정 오류와 연결할 참조 번호입니다(Adobe AIR에서만 지원).

관련 API 요소

메서드 세부 정보

clone

()메서드
override public function clone():Event

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0, Flash Player 9, Flash Lite 4

IOErrorEvent 객체의 복사본을 하나 만들고 각 속성의 값을 원본과 동일하게 설정합니다.

반환값
Event — 원본과 동일한 속성 값을 갖는 새 IOErrorEvent 객체입니다.

toString

()메서드 
override public function toString():String

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0, Flash Player 9, Flash Lite 4

IOErrorEvent 객체의 속성이 모두 포함된 문자열을 반환합니다. 문자열의 형식은 다음과 같습니다.

[IOErrorEvent type=value bubbles=value cancelable=value text=value errorID=value] errorId는 Adobe AIR에서만 사용할 수 있습니다.

반환값
String — IOErrorEvent 객체의 속성이 모두 포함된 문자열입니다.
상수 세부 정보

IO_ERROR

상수
public static const IO_ERROR:String = "ioError"

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0, Flash Player 9, Flash Lite 4

ioError 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubblesfalse
cancelablefalse. 취소할 기본 비헤이비어가 없습니다.
currentTarget이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
errorID특정 오류와 연결된 참조 번호입니다(AIR만 해당).
target입력/출력 오류가 발생한 네트워크 객체입니다.
text오류 메시지로 표시될 텍스트입니다.

관련 API 요소

STANDARD_ERROR_IO_ERROR

상수 
public static const STANDARD_ERROR_IO_ERROR:String = "standardErrorIoError"

언어 버전: ActionScript 3.0
런타임 버전: AIR 2, Flash Lite 4

standardErrorIoError 이벤트는 NativeProcess 객체의 standardError 스트림에서 데이터를 읽는 동안 오류가 발생할 때 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles아니요.
cancelable아니요. 취소할 기본 비헤이비어가 없습니다.
errorID특정 오류와 연결된 참조 번호입니다.
target오류가 발생한 객체입니다.
text오류 메시지로 표시될 텍스트입니다.

STANDARD_INPUT_IO_ERROR

상수 
public static const STANDARD_INPUT_IO_ERROR:String = "standardInputIoError"

언어 버전: ActionScript 3.0
런타임 버전: AIR 2, Flash Lite 4

standardInputIoError 이벤트는 NativeProcess 객체의 standardInput에 데이터를 쓰는 동안 오류가 발생할 때 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles아니요.
cancelable아니요. 취소할 기본 비헤이비어가 없습니다.
errorID특정 오류와 연결된 참조 번호입니다.
target오류가 발생한 객체입니다.
text오류 메시지로 표시될 텍스트입니다.

STANDARD_OUTPUT_IO_ERROR

상수 
public static const STANDARD_OUTPUT_IO_ERROR:String = "standardOutputIoError"

언어 버전: ActionScript 3.0
런타임 버전: AIR 2, Flash Lite 4

standardOutputIoError 이벤트는 NativeProcess 객체의 standardOutput 스트림에서 데이터를 읽는 동안 오류가 발생할 때 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles아니요.
cancelable아니요. 취소할 기본 비헤이비어가 없습니다.
errorID특정 오류와 연결된 참조 번호입니다.
target오류가 발생한 객체입니다.
text오류 메시지로 표시될 텍스트입니다.

IOErrorEventExample.as

다음 예제에서는 IOErrorEventExample 클래스를 사용하여 존재하지 않는 파일을 로드하려고 시도할 때 오류 이벤트 객체가 전달되는 방법을 보여 줍니다. 이는 다음 단계로 이루어집니다.
  1. 클래스 생성자가 URLLoader 객체의 새 인스턴스를 만들어 변수 loader에 할당합니다.
  2. URLLoader 인스턴스가 ioError 유형의 이벤트 리스너를 인스턴스화하는데, 이 리스너에는 trace()를 사용하여 이벤트에 대한 정보를 간단히 출력하는 연관된 구독자 메서드 ioErrorHandler()가 있습니다.
  3. 생성자는 다음으로, URLRequest 객체의 새 인스턴스인 request를 만들어, 없는 파일의 이름과 위치를 알 수 있도록 MissingFile.xml을 전달합니다.
  4. request 변수가 loader.load()로 전달되어, 없는 파일을 로드하려고 시도합니다. 파일이 없으므로 이벤트 핸들러가 ioError 이벤트를 전달합니다.

참고:

  • "로컬 재생 보안"을 "로컬 파일만 액세스"로 설정하여 SWF 파일을 컴파일해야 합니다.
  • SWF 파일과 같은 레벨에 "MissingFile.xml"이라는 파일이 있으면 안 됩니다.

package {
    import flash.display.Sprite;
    import flash.events.IOErrorEvent;
    import flash.net.URLLoader;
    import flash.net.URLRequest;

    public class IOErrorEventExample extends Sprite {
        public function IOErrorEventExample() {
            var loader:URLLoader = new URLLoader();
            loader.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);

            var request:URLRequest = new URLRequest("MissingFile.xml");
            loader.load(request);
        }

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




[ X ]영어로 표시되는 이유
ActionScript 3.0 참조 설명서의 내용이 영어로 나타납니다.

ActionScript 3.0 참조 설명서 중 일부는 전체 언어로 번역되지 않았습니다. 언어 요소가 번역되지 않은 경우 영어로 나타납니다. 예를 들어 ga.controls.HelpBox 클래스는 어떤 언어로도 번역되지 않았습니다. 그러므로 한국어 버전의 참조 설명서에서 ga.controls.HelpBox 클래스는 영어로 나타납니다.