Свойство Microsoft.Reporting.WebFormsClient.ReportViewer.isLoading

Статья
05/06/2011

Возвращает значение типа Boolean, которое показывает, что веб-страница выполняет обратную передачу или клиентский элемент управления выполняет загрузку содержимого.

Примечание

Для получения или установки значений свойств клиентского API необходимо вызывать методы доступа к свойствам, которые именуются с помощью префиксов get_ и set_.

Синтаксис

var loading = $find(viewerId).get_isLoading();

Возвращаемое значение

Значение true, если веб-страница выполняет обратную передачу или клиентский элемент управления выполняет загрузку содержимого, в противном случае значение false.

Замечания

Когда клиентский элемент управления загружает содержимое, он может выполнять обратную передачу, например обновлять данные в отчете или загружать содержимое в обозреватель после обратной передачи. Это свойство не вызывает исключение, когда веб-страница или клиентский элемент управления выполняет обратную передачу. Это свойство позволяет проверить, выполняется ли обновление отчета или страницы и можно ли обращаться к методам и свойствам.

Если выполняется реализация пользовательской панели инструментов, с помощью этого свойства можно переключать состояние элементов панели инструментов (включен-выключен). Например, можно добавить ссылку на скрипт в следующий код JavaScript в элементе управления ScriptManager, чтобы переключать состояние внешней кнопки (включена-выключена).

Примечание

Элемент управления ScriptManager гарантирует, что упоминаемый скрипт будет выполняться до загрузки клиентского элемента управления. Это позволяет обработчику события обрабатывать все изменения свойства isLoading.

Sys.Application.add_load(function () {
    $find("ReportViewer1").add_propertyChanged(viewerPropertyChanged);
});

function viewerPropertyChanged(sender, e) {
    if (e.get_propertyName() === "isLoading") {
        var viewer = $find("ReportViewer1");
        var button = document.getElementById("Button1");
        button.disabled = viewer.get_isLoading();
    }
}

В случае если клиентский элемент управления выполняет продолжительную обратную передачу, можно использовать метод Sys.WebForms.PageRequestManager.abortPostBack, чтобы отменить обратную передачу. Пример.

function cancelPostBack() {
    var prm = Sys.WebForms.PageRequestManager.getInstance();
    if (prmn.get_isInAsyncPostBack()) {
        prm.abortPostBack();
    }
}

См. также

Справочник

Класс Microsoft.Reporting.WebFormsClient.ReportViewer

Другие ресурсы

Ajax Client Life-Cycle Events

Sys.Application.load Event

Sys.WebForms.PageRequestManager Class

Поделиться через