Определяет число байт, загруженных до настоящего момента в ходе операции загрузки.

Определяет общее число байт загруженных данных. Во время операции загрузки данное свойство имеет значение 0 и заполняется по завершении операции. Вдобавок, отсутствие заголовка Content-Length не позволит определить параметр bytesTotal.

Данные, полученные при загрузке. Данное свойство заполняется только после завершения операции загрузки. Формат данных зависит от значения свойства dataFormat:

Если свойство dataFormat имеет значение URLLoaderDataFormat.TEXT, то в качестве данных будет получена строка, содержащая текст загруженного файла.

Если свойство dataFormat имеет значение URLLoaderDataFormat.BINARY, то в качестве данных будет получен объект ByteArray, содержащий необработанные двоичные данные.

Если свойство dataFormat имеет значение URLLoaderDataFormat.VARIABLES, то в качестве данных будет получен объект URLVariables, содержащий переменные в кодировке URL-адреса.

См. также

Определяет, в каком виде получаются загружаемые данные: в виде текста (URLLoaderDataFormat.TEXT), необработанных двоичных данных (URLLoaderDataFormat.BINARY) или переменных в кодировке URL (URLLoaderDataFormat.VARIABLES).

Если свойство dataFormat имеет значение URLLoaderDataFormat.TEXT, то в качестве данных будет получена строка, содержащая текст загруженного файла.

Если свойство dataFormat имеет значение URLLoaderDataFormat.BINARY, то в качестве данных будет получен объект ByteArray, содержащий необработанные двоичные данные.

Если свойство dataFormat имеет значение URLLoaderDataFormat.VARIABLES, то в качестве данных будет получен объект URLVariables, содержащий переменные в кодировке URL-адреса.

Значение по умолчанию URLLoaderDataFormat.TEXT

См. также

Создает объект URLLoader.

См. также

Закрывает выполняемую операцию загрузки. Любая операция загрузки, выполняемая в данный момент, сразу же прекращается. Если в текущий момент нет потокового воспроизведения с URL-адреса, создается ошибка "недопустимый поток".

Отправляет и загружает данные с заданного URL-адреса. Данные могут быть получены как текст, необработанные двоичные данные или переменные в кодировке URL. Это зависит от значения, установленного для свойства dataFormat. Обратите внимание на то, что значением свойства dataFormat по умолчанию является текст. Для того чтобы отправить данные на указанный URL-адрес, можно установить свойство data в объекте URLRequest.

Примечание. Если загружаемый файл содержит символы, не принадлежащие коду ASCII (например, во многих языках, кроме английского), рекомендуется сохранить файл в кодировке UTF-8 или UTF-16, как противоположных стандарту ASCII.

SWF-файл в изолированной программной среде, локальной для файловой системы, может не поддерживать загрузку и передачу данных для ресурса, находящегося в сетевой изолированной программной среде.

По умолчанию вызывающий SWF-файл и загружаемый URL-адрес должны находиться в одном и том же домене. Например, SWF-файл на www.adobe.com может загружать данные только из источников, которые также размещены на сайте www.adobe.com. Чтобы загрузить данные с другого домена, разместите файл политики для URL на сервере, где расположены эти данные.

Нельзя подключаться к общепринятым зарезервированным портам. Полный список заблокированных портов см. в разделе "Ограничение сетевых API-интерфейсов" в главе "Безопасность" книги Программирование на ActionScript 3.0.

Можно запретить использование SWF-файлом этого метода путем установки параметра allowNetworking для тегов object и embed на странице HTML, содержащей SWF-содержимое.

Дополнительные сведения о безопасности см. в следующих ресурсах.

• Раздел центра разработки Flash Player: Безопасность

Параметры

См. также

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.";
        }
    }
}

Отправляется после декодирования всех полученных данных и размещения их в свойстве data объекта URLLoader. Полученные данные станут доступными, как только будет отправлено это событие.

Данное событие имеет следующие свойства.

См. также

Отправляется, если путем вызова метода URLLoader.load() предпринимается попытка доступа к данным по протоколу HTTP, а текущая среда Flash Player может определить и вернуть код состояния для запроса. (В среде некоторых обозревателей данная информация не предоставляется.) Обратите внимание на то, что событие httpStatus (при наличии такового) будет отправляться до (как дополнение) любого события complete или error.

Данное событие имеет следующие свойства.

См. также

Отправляется, если вызов метода URLLoader.load() приводит к неустранимой ошибке, прекращающей загрузку.

Данное событие имеет следующие свойства.

См. также

Отправляется, когда операция загрузки начинается после вызова метода URLLoader.load().

Данное событие имеет следующие свойства.

См. также

Отправляется в случае получения данных в ходе операции загрузки.

Обратите внимание на то, что в случае с объектом URLLoader, данные становятся доступными только после полной загрузки. Поэтому событие состояния служит лишь оповещением о том, как проходит загрузка. Для доступа к данным, которые еще не загружены полностью, используйте объект URLStream.

Данное событие имеет следующие свойства.

См. также

Отправляется, если путем вызова метода URLLoader.load() предпринимается попытка загрузить данные с сервера, расположенного за пределами изолированной среды.

Данное событие имеет следующие свойства.

См. также

Примечание. Чтобы запустить этот пример, поместите файл urlLoaderExample.txt в тот же каталог, где находится ваш SWF-файл. Данный файл должен содержать только следующую строку текста: answer=42&question=unknown

Данный пример кода выполняет следующее:

1. Функция конструктора создает экземпляр URLLoader под именем loader и экземпляр URLRequest под именем request, в котором указывается место размещения и имя загружаемого файла.
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);
        }
    }
}