Microsoft.Reporting.WebFormsClient.ReportViewer.isLoading-Eigenschaft

Artikel
05/06/2011

Ruft einen Boolean-Wert ab oder legt ihn fest, der angibt, ob die Webseite ein Postback ausführt oder das clientseitige Steuerelement Inhalt lädt.

Tipp

Um Eigenschaftswerte für Eigenschaften von Client-APIs abzurufen oder festzulegen, müssen Sie Eigenschaftenaccessormethoden aufrufen, deren Namen mit den Präfixen get_ und set_ beginnen.

Syntax

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

Rückgabewert

true, wenn die Webseite ein Postback ausführt oder das clientseitige Steuerelement Inhalt lädt, andernfalls false.

Hinweise

Wenn das clientseitige Steuerelement Inhalt lädt, kann es sich um ein Postback handeln, wie beispielsweise das Aktualisieren eines Berichts mit neuen Daten, oder aber um das Laden des Inhalts in den Browser nach einem Postback. Diese Eigenschaft löst keine Ausnahme aus, wenn die Webseite oder das clientseitige Steuerelement ein Postback ausführt. Verwenden Sie diese Eigenschaft, um zu überprüfen, ob der Bericht oder die Seite aktualisiert wird und ob Sie auf die Methoden und Eigenschaften zugreifen können.

Wenn Sie eine benutzerdefinierte Symbolleiste implementieren, können Sie diese Eigenschaft verwenden, um zwischen dem Status "aktiviert" und "deaktiviert" der Symbolleistenelemente zu wechseln. Sie können beispielsweise einen Skriptverweis auf den folgenden JavaScript-Code in Ihrem ScriptManager-Steuerelement hinzufügen, um zwischen dem Status "aktiviert" und "deaktiviert" einer externen Schaltfläche zu wechseln.

Tipp

Das ScriptManager-Steuerelement stellt sicher, dass das Skript, auf das verwiesen wird, vor dem Laden des clientseitigen Steuerelements ausgeführt wird. Dadurch kann der Ereignishandler alle Änderungen der isLoading-Eigenschaft behandeln.

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();
    }
}

Falls das clientseitige Steuerelement ein Postback mit langer Laufzeit ausführt, können Sie das Postback mit der Sys.WebForms.PageRequestManager.abortPostBack-Methode abbrechen. Beispiel:

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

Siehe auch

Verweis

Microsoft.Reporting.WebFormsClient.ReportViewer-Klasse

Andere Ressourcen

Ajax Client Life-Cycle Events

Sys.Application.load Event

Sys.WebForms.PageRequestManager Class

Freigeben über