Weergaveformaten aanpassen met door de gebruiker gedefinieerde getallen

Invoering

Werken met Excel-bestanden vereist vaak aangepaste opmaak van cellen om gegevens op een zinvollere en gebruiksvriendelijkere manier te presenteren. Stel je voor dat je een Excel-bestand voor een rapport maakt. Je wilt niet alleen ruwe getallen. Je wilt dat datums, percentages en valuta’s er strak en professioneel uitzien, toch? Dat is waar aangepaste weergaveformaten in het spel komen. In deze tutorial duiken we diep in Aspose.Cells voor .NET om je te laten zien hoe je de weergave-indeling van getallen kunt aanpassen met behulp van door de gebruiker gedefinieerde instellingen.

Vereisten

Voordat je begint, zorg dat je alles klaar hebt om deze tutorial te volgen. Dit heb je nodig:

  • Aspose.Cells voor .NET geïnstalleerd.Download het hier.
  • Basiskennis van C# en .NET Framework.
  • Een geldige licentie voor Aspose.Cells. Als je die niet hebt, pak dan eengratis proefperiode of vraag eentijdelijke licentie.
  • Een IDE zoals Visual Studio.
  • .NET Framework 4.0 of hoger. Als u iets mist, maak u dan geen zorgen. U kunt altijd deze links opnieuw bezoeken om de benodigde bestanden te downloaden of hulp te zoeken bij deAspose ondersteuningsforum.

Naamruimten importeren

Voordat u met de code aan de slag gaat, moet u de vereiste naamruimten importeren om toegang te krijgen tot alle benodigde Aspose.Cells-functionaliteiten.

using System.IO;
using Aspose.Cells;
using System;

Deze twee namespaces zijn uw belangrijkste tools in deze tutorial. Laten we nu naar het leuke gedeelte gaan:

Stap 1: De projectdirectory instellen

Eerst heb je een plek nodig om je bestanden op te slaan, toch? Laten we een directory maken om het Excel-uitvoerbestand op te slaan. In deze stap controleren we ook of de directory bestaat voordat we iets opslaan.

// Het pad naar de documentenmap.
string dataDir = "Your Document Directory";
// Maak een map aan als deze nog niet bestaat.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);
  • We definiëren eendataDir variabele om het pad op te slaan waar het Excel-uitvoerbestand naartoe moet.
  • Vervolgens controleren we of de directory bestaat met behulp vanSystem.IO.Directory.Exists().
  • Als de map niet bestaat, wordt deze aangemaakt met behulp vanSystem.IO.Directory.CreateDirectory().

Stap 2: Maak een nieuwe werkmap en voeg een werkblad toe

Nu we een map hebben, kunnen we een nieuwe Excel-werkmap maken en er een werkblad aan toevoegen.

// Een werkmapobject instantiëren
Workbook workbook = new Workbook();
// Een nieuw werkblad toevoegen aan het Excel-object
int i = workbook.Worksheets.Add();
// De referentie van het nieuw toegevoegde werkblad verkrijgen door de index van het werkblad door te geven
Worksheet worksheet = workbook.Worksheets[i];
  • Eerst creëren we een nieuweWorkbook object. Beschouw dit als uw Excel-bestand.
  • We voegen een nieuw werkblad toe aan deze werkmap met behulp van deAdd()methode en sla de index op in een variabelei.
  • We verwijzen naar dit werkblad met behulp van deworkbook.Worksheets[i].

Stap 3: Datum toevoegen aan een cel en de opmaak ervan aanpassen

Laten we nu de huidige datum in een cel invoegen en deze opmaken om op een aangepaste manier weer te geven. In plaats van de standaarddatumnotatie, stellen we een aangepaste notatie in zoalsd-mmm-yy.

// De huidige systeemdatum toevoegen aan cel "A1"
worksheet.Cells["A1"].PutValue(DateTime.Now);
// De stijl van A1-cel verkrijgen
Style style = worksheet.Cells["A1"].GetStyle();
// Het aangepaste weergaveformaat instellen om de datum weer te geven als "d-mmm-jj"
style.Custom = "d-mmm-yy";
// De stijl toepassen op cel A1
worksheet.Cells["A1"].SetStyle(style);
  • We voegen de huidige systeemdatum toe aan celA1 gebruik makend vanPutValue(DateTime.Now).
  • We halen de huidige stijl van de cel opA1 gebruik makend vanGetStyle().
  • We wijzigen de stijl van de cel door in te stellenstyle.Custom = "d-mmm-yy", waarmee de datum wordt opgemaakt met de dag, afgekorte maand en jaar.
  • Ten slotte passen we de nieuwe stijl toe op de cel metSetStyle().

Stap 4: Een cel opmaken als percentage

Laten we nu met getallen werken. We voegen een numerieke waarde toe aan een andere cel, bijvoorbeeldA2en formatteer het als een percentage.

//Een numerieke waarde toevoegen aan cel "A2"
worksheet.Cells["A2"].PutValue(20);
// De stijl van A2-cel verkrijgen
style = worksheet.Cells["A2"].GetStyle();
// Het aangepaste weergaveformaat instellen om de waarde als percentage weer te geven
style.Custom = "0.0%";
// De stijl toepassen op cel A2
worksheet.Cells["A2"].SetStyle(style);
  • Wij voegen waarde toe20 naar celA2.
  • We halen de stijl van de cel opA2 en stel de aangepaste opmaak in op0.0% om de waarde als percentage weer te geven (bijv. 20%).
  • Ten slotte passen we de stijl toe op de cel met behulp vanSetStyle().

Stap 5: Een cel opmaken als valuta

Laten we nog een waarde toevoegen, bijvoorbeeld aan celA3, en formatteer het om het weer te geven als valuta. Om het interessanter te maken, gebruiken we een formaat dat positieve waarden weergeeft als valuta in ponden en negatieve waarden in dollars.

// Een numerieke waarde toevoegen aan cel "A3"
worksheet.Cells["A3"].PutValue(2546);
// De stijl van A3-cel verkrijgen
style = worksheet.Cells["A3"].GetStyle();
// Het aangepaste weergaveformaat instellen om de waarde als valuta weer te geven
style.Custom = "£#,##0;[Red]$-#,##0";
// De stijl toepassen op cel A3
worksheet.Cells["A3"].SetStyle(style);
  • Wij voegen waarde toe2546 naar celA3.
  • Wij stellen een aangepast formaat in£#,##0;[Red]$-#,##0, waarbij positieve waarden met een pondteken worden weergegeven en negatieve waarden in het rood met een dollarteken.
  • We passen de stijl toe op de cel met behulp vanSetStyle().

Stap 6: De werkmap opslaan

De laatste stap is om de werkmap op te slaan als een Excel-bestand. We gebruiken het Excel 97-2003-formaat voor deze tutorial.

// Het Excel-bestand opslaan
workbook.Save(dataDir + "book1.out.xls", SaveFormat.Excel97To2003);
  • DeSave() Met deze methode wordt de werkmap opgeslagen in de opgegeven map.
  • Wij kiezenSaveFormat.Excel97To2003 om compatibiliteit met oudere versies van Excel te garanderen.

Conclusie

Daar heb je het! We hebben zojuist een Excel-bestand gemaakt, aangepaste datum-, percentage- en valutaformaten toegevoegd aan specifieke cellen met Aspose.Cells voor .NET en het bestand opgeslagen. Aangepaste opmaak maakt je Excel-bestanden veel leesbaarder en professioneler. Vergeet niet om andere opmaakopties in Aspose.Cells te verkennen, zoals voorwaardelijke opmaak, voor nog meer controle over hoe je gegevens eruit zien.

Veelgestelde vragen

Hoe kan ik complexere opmaakopties toepassen in Aspose.Cells?

U kunt verschillende opmaakstijlen, zoals tekstkleur, randen en achtergrondkleuren, combineren met aangepaste getalnotaties.

Kan ik een aangepaste getalnotatie toepassen op een celbereik?

Ja, met Aspose.Cells kunt u een stijl toepassen op een cellenbereik met behulp van deRange.SetStyle() methode.

In welke andere bestandsformaten kan ik de werkmap opslaan?

Aspose.Cells ondersteunt veel formaten, waaronder XLSX, CSV en PDF. Verander eenvoudig deSaveFormat in deSave() methode.

Kan ik negatieve getallen anders opmaken?

Absoluut! U kunt aangepaste getalformaten gebruiken om negatieve getallen met verschillende kleuren of symbolen weer te geven.

Is Aspose.Cells voor .NET gratis?

Aspose.Cells biedt een gratis proefperiode, maar voor volledige functionaliteit hebt u een geldige licentie nodig. U kunt eentijdelijke licentie hier.

Ingebouwde getalnotaties in Excel programmatisch gebruiken