Często nasi użytkownicy muszą zmieniać parametry eksportu plików, dlatego dziś przyjrzymy się ich implementacji. Funkcja ta została wprowadzona w wersji 2022.1. Załóżmy, że mamy gotowy projekt. Weźmy dowolny raport z aplikacji demonstracyjnej FastReport .NET i dodajmy dodatkowe parametry do okna eksportu za pomocą tego kodu:
WebReport.Toolbar.Exports.EnableSettings = true;
Teraz otwórzmy naszą aplikację i zobaczmy rezultaty:
Przyjrzyjmy się bardziej dokładnie, jak to działa w FastReport Web for Core.
Wszystkie opcje zaawansowanych ustawień eksportu zostały zaimplementowane tak, aby były włączone lub wyłączone w zależności od jednego ustawienia, EnableExportSettings. Można ustawić niestandardowe opcje eksportu. Załóżmy, że potrzebujemy tylko plików PDF i HTML. Implementacja będzie wyglądać następująco:
Exports = new ExportMenuSettings() { ExportTypes = Exports.Pdf | Exports.HTML }
Zmieńmy nieco ustawienia eksportu w kontenerze, więcej na ten temat można przeczytać w artykule Dostosowanie paska narzędzi i ustawienia eksportu w FastReport.Web dla Core.
Włączmy zaawansowane ustawienia za pomocą właściwości EnableSettings, umożliwi to wywołanie okien modalnych z różnymi dodatkowymi ustawieniami dla eksportu:
WebReport.Toolbar.Exports.EnableSettings = true;
Otwórzmy naszą aplikację i zobaczmy rezultaty:
Na powyższym zrzucie ekranu mamy do dyspozycji tylko dwa formaty zapisu. Można również zauważyć możliwość lokalizacji na różne języki. Aby używać różnych języków, należy dopisać krótką linię kodu:
webReport.LocalizationFile = Path.Combine(Directory.GetCurrentDirectory(),"Localization", "English.frl");
Ale jak wyeksportować plik z ustawieniami zaawansowanymi? Przyjrzyjmy się temu krok po kroku.
Krok 1. Kliknij na kółko zębate naprzeciwko opcji "Eksportuj do PDF", po czym powinno pojawić się następujące okno:
Krok 2. Wybierz parametry, których potrzebujemy, na przykład plik HTML bez obrazów:
Krok 3. Kliknij przycisk OK i obejrzyj wynik:
Jeśli obrazy nie są wyświetlane, to znaczy, że wszystko zrobiliśmy dobrze.
Warto zauważyć, że okno ustawień można dostosować do własnych potrzeb. Przyjrzyjmy się, jak to zrobić. Najpierw napiszmy kilka linijek kodu:
WebReport.Toolbar.Exports.Color = Color.Gray; WebReport.Toolbar.Exports.FontSettings = new Font("Times New Roman", 14, FontStyle.Bold);
Zobaczmy wynik:
Można zauważyć, że kolor jest ustawiony na szary, a rodzaj czcionki to Times New Roman, jak określono.
Na tym etapie sprawdziliśmy, jak korzystać z ustawień zaawansowanych eksportu dla FastReport.Web dla Core.
Teraz pokażemy, jak pracować w Blazorze. Ponownie przeanalizujemy jeden z dostępnych raportów. Dla przykładu, weźmy aplikację demo z naszego artykułu. Dostosowywanie paska narzędzi i ustawienia eksportu i dodajmy do niej nowe funkcje. Ponownie dodajmy zaawansowane ustawienia i wszystkie rodzaje eksportu. Przy okazji, tutaj również istnieje możliwość dostosowania i jest ona wykorzystywana w taki sam sposób, jak w Core. Przejdź do pliku Pages/Index.razor.cs i napisz dwie linie kodu:
webReport.Toolbar.Exports= ExportMenuSettings.All;
webReport.Toolbar.Exports.EnableSettings = true;
Otwórzmy naszą aplikację:
Jak widać, wyświetlane są wszystkie formaty eksportu, a także ich ustawienia zaawansowane. Wypróbujmy zaawansowane opcje eksportu do formatu "HTML". Aby to wykonać, przejdź do ustawień, klikając lewym przyciskiem myszy na koło zębate, gdzie na przykład pozostawimy tylko bieżącą stronę z obrazkami:
Potwierdzamy nasz wybór przyciskiem "OK" i oglądamy wynik:
Omówiliśmy, jak korzystać z zaawansowanych ustawień eksportu dla FastReport.Web dla Core i Blazor Server poprzez kod aplikacji.
