로드 작업 중 지금까지 로드한 바이트 수를 나타냅니다.

다운로드한 데이터의 총 바이트 수를 나타냅니다. 이 속성은 로드 작업이 진행 중인 경우에는 0을 포함하고 작업이 완료되면 채워집니다. 또한 Content-Length 머리글이 누락되면 총 바이트 수가 확정되지 않습니다.

로드 작업으로 수신된 데이터입니다. 이 속성은 로드 작업이 완료된 때만 채워집니다. 데이터의 형식은 dataFormat 속성의 설정에 따라 달라집니다.

dataFormat 속성이 URLLoaderDataFormat.TEXT인 경우 수신된 데이터는 로드된 파일의 텍스트가 포함된 문자열입니다.

dataFormat 속성이 URLLoaderDataFormat.BINARY인 경우 수신된 데이터는 원시 이진 데이터가 포함된 ByteArray 객체입니다.

dataFormat 속성이 URLLoaderDataFormat.VARIABLES인 경우 수신된 데이터는 URL 인코딩된 변수가 포함된 URLVariables 객체입니다.

참고 사항

다운로드하는 데이터를 텍스트(URLLoaderDataFormat.TEXT), 원시 이진 데이터(URLLoaderDataFormat.BINARY) 또는 URL 인코딩된 변수(URLLoaderDataFormat.VARIABLES) 중 어떤 형식으로 수신할 것인지 제어합니다.

dataFormat 속성 값이 URLLoaderDataFormat.TEXT인 경우 수신된 데이터는 로드된 파일의 텍스트가 포함된 문자열입니다.

dataFormat 속성 값이 URLLoaderDataFormat.BINARY인 경우 수신된 데이터는 원시 이진 데이터가 포함된 ByteArray 객체입니다.

dataFormat 속성 값이 URLLoaderDataFormat.VARIABLES인 경우 수신된 데이터는 URL 인코딩된 변수가 포함된 URLVariables 객체입니다.

기본값은 URLLoaderDataFormat.TEXT.

참고 사항

URLLoader 객체를 만듭니다.

참고 사항

진행 중인 로드 작업을 닫습니다. 진행 중인 모든 로드 작업이 즉시 종료됩니다. 현재 스트리밍될 URL이 없으면 잘못된 스트림 오류가 발생합니다.

지정된 URL에서 데이터를 보내거나 로드합니다. 데이터는 dataFormat 속성에 지정한 값에 따라 텍스트, 원시 이진 데이터 또는 URL 인코딩된 변수로 수신할 수 있습니다. dataFormat 속성의 기본값은 텍스트입니다. 지정된 URL로 데이터를 보내려는 경우 URLRequest 객체의 data 속성을 지정할 수 있습니다.

참고: 로드되는 파일에 ASCII가 아닌 문자(영어가 아닌 다른 언어에서 사용)가 포함되어 있는 경우 UTF-8 또는 UTF-16과 같은 유니코드 인코딩을 사용하여 파일을 저장하는 것이 좋습니다. ASCII는 유니코드 형식이 아닙니다.

이 메서드를 사용할 경우 다음과 같은 Flash Player 보안 모델을 생각해 볼 수 있습니다.

Flash Player 9 이상의 경우, SWF 내용을 포함하는 HTML 페이지에서 object 및 embed 태그의 allowNetworking 매개 변수를 설정하여 SWF 파일에서 이 메서드를 사용하지 못하도록 할 수 있습니다.

Flash Player 8 이상의 경우:

• 호출하는 SWF 파일이 local-with-file-system 샌드박스에 있고 대상 리소스가 네트워크 샌드박스에서 가져온 것이면 데이터를 로드할 수 없습니다.
• 호출하는 SWF 파일이 네트워크 샌드박스에서 가져온 것이고 대상 리소스가 로컬 시스템에 있는 경우에도 데이터를 로드할 수 없습니다.

Flash Player 7 이상의 경우 웹 사이트에서 크로스 도메인 정책 파일을 통해 리소스에 대한 도메인 간 액세스를 허용할 수 있습니다. Flash Player 7 버전 이상에서 실행되는 SWF 파일에서 url은 정확히 같은 도메인에 있어야 합니다. 예를 들어 www.adobe.com에 있는 SWF 파일은 같은 도메인인 www.adobe.com에 있는 소스에서만 데이터를 로드할 수 있습니다.

자세한 내용은 다음을 참조하십시오.

• 보안 장(ActionScript 3.0 프로그래밍 설명서) 및 LiveDocs의 최신 의견
• Flash Player 9보안 백서

Flash Player 7 이전 버전에서 실행되는 SWF 파일에서 url은 이 호출을 수행하는 SWF 파일과 동일한 수퍼 도메인에 있어야 합니다. 수퍼 도메인은 파일의 URL에서 가장 왼쪽 구성 요소를 제거하여 파생됩니다. 예를 들어, www.adobe.com에 있는 SWF 파일은 store.adobe.com에 있는 소스에서 데이터를 로드할 수 있습니다. 두 파일 모두 adobe.com이라는 이름의 수퍼 도메인에 있기 때문입니다.

매개 변수

참고 사항

package {
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.net.URLLoader;
    import flash.net.URLRequest;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.xml.*;
    import flash.events.IOErrorEvent;
  
    public class URLLoader_loadExample extends Sprite {
        private var xmlTextField:TextField = new TextField();
        private var externalXML:XML;    
        private var loader:URLLoader;

        public function URLLoader_loadExample() {
            var request:URLRequest = new URLRequest("xmlFile.xml");

            loader = new URLLoader();
            
            try {
                loader.load(request);
            }
            catch (error:SecurityError)
            {
                trace("A SecurityError has occurred.");
            }

             loader.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
            loader.addEventListener(Event.COMPLETE, loaderCompleteHandler);

            xmlTextField.x = 10;
            xmlTextField.y = 10;
            xmlTextField.background = true;
            xmlTextField.autoSize = TextFieldAutoSize.LEFT;

            addChild(xmlTextField);
        }

        private function loaderCompleteHandler(event:Event):void {

                try {
                    externalXML = new XML(loader.data);
                    readNodes(externalXML);    
                } catch (e:TypeError) {
                    trace("Could not parse the XML file.");
                }
        }

        private function readNodes(node:XML):void {

                for each (var element:XML in node.elements()) {
                    xmlTextField.appendText(element.attributes()[0] + "\n");

                    readNodes(element);
                }    
        }

        private function errorHandler(e:IOErrorEvent):void {
            xmlTextField.text = "Had problem loading the XML File.";
        }
    }
}

수신된 모든 데이터가 디코딩된 후 URLLoader 객체의 data 속성에 배치되면 전달됩니다. 수신된 데이터는 이 이벤트가 전달되면 액세스할 수 있습니다.

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

참고 사항

URLLoader.load() 호출로 HTTP를 통해 데이터 액세스를 시도하고 현재의 Flash Player 환경이 이 요청에 대한 상태 코드를 감지 및 반환할 수 있을 때 전달됩니다. 일부 브라우저 환경에서는 이 정보를 제공할 수 없습니다. httpStatus 이벤트는 complete 또는 error 이벤트 발생 전에 추가로 전송됩니다.

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

참고 사항

URLLoader.load() 호출로 치명적인 오류가 발생하여 다운로드가 중단되면 전달됩니다.

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

참고 사항

URLLoader.load() 메서드에 대한 호출에 이어 다운로드 작업이 시작될 때 전달됩니다.

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

참고 사항

다운로드 작업이 진행되어 데이터가 수신될 때 전달됩니다.

데이터가 완전히 수신되기 전에는 URLLoader 객체로 데이터를 액세스할 수 없습니다. 따라서 progress 이벤트는 다운로드 진행 상황을 알리는 역할만을 합니다. 데이터가 완전히 다운로드되기 전에 액세스하려면 URLStream 객체를 사용합니다.

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

참고 사항

URLLoader.load() 호출로 보안 샌드박스 외부의 서버로부터 데이터 로드를 시도할 때 전달됩니다.

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

참고 사항

참고: 이 예제를 실행하려면 urlLoaderExample.txt라는 이름의 파일을 SWF 파일과 같은 디렉토리에 넣어야 합니다. 이 파일에는 다음과 같은 내용의 텍스트만 포함되어 있어야 합니다. answer=42&question=unknown

이 예제 코드는 다음 작업을 수행합니다.

1. 생성자 함수는 loader라는 이름의 URLLoader 인스턴스와 request라는 이름의 URLRequest 인스턴스를 만들며, 이것은 로드할 파일의 위치와 이름을 포함합니다.
2. loader 객체는 configureListeners() 메서드에 전달되고, 이 메서드는 지원되는 각 URLLoader 이벤트에 대해 리스너를 추가합니다.
3. 그런 다음 request 객체가 loader.load()에 전달되고, 이 메서드는 해당 텍스트 파일을 로드합니다.
4. URLLoader가 텍스트 파일 로드를 완료하면 Event.COMPLETE 이벤트가 발생하여 completeHandler() 메서드가 트리거됩니다. completeHandler() 메서드는 파일에서 로드된 텍스트에서 URLVariables 객체를 만듭니다. URLVariables 객체는 URL 인코딩된 이름/값 쌍을 ActionScript 속성으로 변환하여 로드된 데이터를 조작하기 쉽게 만듭니다.

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.*;

    public class URLLoaderExample extends Sprite {
        public function URLLoaderExample() {
            var loader:URLLoader = new URLLoader();
            configureListeners(loader);

            var request:URLRequest = new URLRequest("urlLoaderExample.txt");
            try {
                loader.load(request);
            } catch (error:Error) {
                trace("Unable to load requested document.");
            }
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
        }

        private function completeHandler(event:Event):void {
            var loader:URLLoader = URLLoader(event.target);
            trace("completeHandler: " + loader.data);
    
            var vars:URLVariables = new URLVariables(loader.data);
            trace("The answer is " + vars.answer);
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            trace("progressHandler loaded:" + event.bytesLoaded + " total: " + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

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