Użyj anonimowych typów z inteligentnymi znacznikami Aspose.Cells

Wstęp

Jeśli chodzi o generowanie dynamicznych raportów Excela w aplikacjach .NET, Aspose.Cells wyróżnia się jako potężne narzędzie. Jedną z jego najlepszych cech jest możliwość pracy z inteligentnymi znacznikami i typami anonimowymi. Jeśli jesteś nowy w tej koncepcji, nie martw się! Ten przewodnik rozłoży wszystko, co musisz wiedzieć, od wymagań wstępnych po praktyczne przykłady, a jednocześnie będzie angażujący i łatwy do zrozumienia.

Wymagania wstępne

Zanim zagłębimy się w kod, upewnijmy się, że masz wszystko, czego potrzebujesz, by płynnie uruchomić przykłady z tego samouczka.

1. Środowisko .NET

Upewnij się, że masz działające środowisko .NET skonfigurowane na swoim komputerze lokalnym. Możesz użyć Visual Studio lub dowolnego innego IDE według własnego wyboru.

2. Biblioteka Aspose.Cells

Będziesz potrzebować biblioteki Aspose.Cells. Jeśli jeszcze jej nie pobrałeś, możesz ją łatwo znaleźć Tutaj . Możesz również wypróbować bezpłatną wersję próbną dostępną pod adresem ten link .

3. Podstawowa wiedza o C#

Podstawowa znajomość programowania w języku C# pomoże ci łatwiej poruszać się po samouczku. Jeśli terminy takie jak klasy, obiekty i właściwości są ci znane, możesz zaczynać!

Importuj pakiety

Aby użyć biblioteki Aspose.Cells w swoim projekcie, musisz zaimportować powiązane przestrzenie nazw. Dodaj następujące dyrektywy using na górze swojego pliku C#:

using System.IO;
using Aspose.Cells;
using System.Collections.Generic;

Te przestrzenie nazw dadzą ci dostęp do wszystkich niezbędnych klas i metod, które zostaną omówione później. A teraz przejdźmy do sedna samouczka! Zobaczysz, jak utworzyć plik Excela z inteligentnymi znacznikami, używając niestandardowej klasy. Nie martw się; rozbijemy wszystko na łatwe do opanowania kroki!

Krok 1: Utwórz klasę niestandardową

Najpierw potrzebujemy prostej klasy, która będzie reprezentować dane, które chcemy dodać do naszego pliku Excel. Ta klasa będzie zawierać informacje o osobie.

public class Person
{
    private string m_Name;
    private int m_Age;
    public string Name
    {
        get { return m_Name; }
        set { m_Name = value; }
    }
    public int Age
    {
        get { return m_Age; }
        set { m_Age = value; }
    }
    internal Person(string name, int age)
    {
        this.m_Name = name;
        this.m_Age = age;
    }
}

Tutaj definiujemy klasę o nazwiePerson z dwiema nieruchomościami,Name IAge. Konstruktor inicjuje te właściwości.

Krok 2: Skonfiguruj projektanta skoroszytów

Następnie utwórzmy instancjęWorkbookDesignerklasę, której użyjemy do zaprojektowania naszego pliku Excel z inteligentnymi znacznikami.

// Ścieżka do katalogu dokumentów.
string dataDir = "Your Document Directory";
// Utwórz wystąpienie obiektu projektanta skoroszytu.
WorkbookDesigner report = new WorkbookDesigner();

Zastępować"Your Document Directory" z rzeczywistą ścieżką pliku, w której chcesz zapisać plik Excel.WorkbookDesigner Klasa stanowi serce tej operacji, w której definiujesz swój szablon.

Krok 3: Dodaj znaczniki do komórek

Teraz musimy dodać inteligentne znaczniki do arkusza kalkulacyjnego. Te znaczniki będą symbolami zastępczymi dla danych, które wprowadzimy później.

// Pobierz pierwszy arkusz ze skoroszytu.
Aspose.Cells.Worksheet sheet = report.Workbook.Worksheets[0];
// Wprowadź znaczniki do komórek.
sheet.Cells["A1"].PutValue("Name");
sheet.Cells["B1"].PutValue("Age");
sheet.Cells["A2"].PutValue("&=MyProduct.Name");
sheet.Cells["B2"].PutValue("&=MyProduct.Age");

Oznaczamy pierwszy arkusz roboczy i ustawiamy wartości dla komórek nagłówka. Inteligentne znaczniki są poprzedzone prefiksem&= co informuje Aspose, że są to symbole zastępcze danych, które zostaną wstawione później.

Krok 4: Utwórz listę osób

Teraz utwórzmy listę osób za pomocą naszegoPerson klasa, której użyjemy do wypełnienia inteligentnych znaczników.

// Utwórz instancję kolekcji list na podstawie klasy niestandardowej.
IList<Person> list = new List<Person>();
// Podaj wartości dla znaczników, korzystając z obiektu klasy niestandardowej.
list.Add(new Person("Simon", 30));
list.Add(new Person("Johnson", 33));

Tworzymy listę i dodajemy wystąpieniaPersondo niego. Ta lista służy jako nasze źródło danych podczas wypełniania szablonu Excela.

Krok 5: Ustaw źródło danych i znaczniki procesu

Gdy już przygotujemy naszą listę, musimy ustawić ją jako źródło danych dla naszegoWorkbookDesigner instancję, a następnie przetworzyć znaczniki.

// Ustaw źródło danych.
report.SetDataSource("MyProduct", list);
// Przetwórz znaczniki.
report.Process(false);

TenSetDataSource Metoda łączy naszą wcześniej zdefiniowaną listę z markerami.Process Metoda ta zastępuje inteligentne znaczniki w skoroszycie rzeczywistymi wartościami z naszych obiektów.

Krok 6: Zapisz plik Excel

Na koniec zapiszemy zmodyfikowany skoroszyt w wyznaczonym katalogu.

// Zapisz plik Excela.
report.Workbook.Save(dataDir + "Smart Marker Customobjects.xls");

Ten wiersz zapisuje skoroszyt do określonej ścieżki pliku. Możesz otworzyć ten plik za pomocą programu Excel, aby zobaczyć wstawione dane.

Wniosek

I masz! Udało Ci się utworzyć plik Excela przy użyciu inteligentnych znaczników w Aspose.Cells z własną niestandardową klasą. Ta metoda nie tylko sprawia, że zarządzanie danymi jest bardziej dynamiczne, ale także utrzymuje kod w czystości i porządku. Niezależnie od tego, czy generujesz raporty analityczne, śledzisz informacje czy wykonujesz inne zadania związane z danymi, inteligentne znaczniki będą Twoim sojusznikiem w tworzeniu raportów w programie Excel, które będą łatwiejsze w zarządzaniu i bardziej elastyczne!

Najczęściej zadawane pytania

Czym są inteligentne znaczniki w Aspose.Cells?

Inteligentne znaczniki to specjalne symbole zastępcze w dokumencie programu Excel, które umożliwiają dynamiczne wstawianie danych w czasie wykonywania.

Czy mogę używać typów anonimowych w przypadku znaczników inteligentnych?

Tak! Inteligentne znaczniki mogą być używane z dowolnym typem obiektu, w tym typami anonimowymi, o ile pasują do oczekiwanej struktury danych.

Czy korzystanie z Aspose.Cells jest bezpłatne?

Aspose.Cells jest produktem płatnym, ale możesz zacząć od bezpłatnego okresu próbnego, aby poznać jego funkcje.

Jakie formaty plików obsługuje Aspose.Cells?

Obsługuje szeroką gamę formatów plików, w tym XLS, XLSX, CSV i inne.

Gdzie mogę znaleźć więcej informacji na temat Aspose.Cells?

Więcej szczegółów znajdziesz tutaj dokumentacja lub odwiedź forum wsparcia .