Registreren en aanroepen van functies vanuit een invoegtoepassing in Excel

Invoering

Wilt u uw Excel-ervaring verbeteren door functies aan te roepen vanuit een invoegtoepassing? Zo ja, dan bent u hier aan het juiste adres! Excel-invoegtoepassingen zijn als de goede feeën van spreadsheets; ze breiden op magische wijze de functionaliteit uit en geven u een heleboel nieuwe tools binnen handbereik. En met Aspose.Cells voor .NET is het eenvoudiger dan ooit om deze invoegtoepassingsfuncties te registreren en te gebruiken. In deze gids zal ik je door het proces leiden van het registreren en aanroepen van een functie vanuit een Excel-invoegtoepassing met Aspose.Cells voor .NET. We zullen alles stap voor stap uitleggen, zodat je je in no time een pro voelt!

Vereisten

Voordat we ons verdiepen in de programmeerkunst, bespreken we eerst wat je allemaal nodig hebt:

1. Visual Studio: Zorg ervoor dat Visual Studio op uw machine is ingesteld. Dit is waar we onze code schrijven en uitvoeren.
2. Aspose.Cells Library: Je hebt de Aspose.Cells-bibliotheek nodig. Je kunt deze ophalen van hundownloadpagina.
3. Basiskennis van C#: Een beetje kennis van C# is heel handig; het zal u helpen de cursus naadloos te volgen.
4. Excel-invoegtoepassingen: u moet een invoegtoepassingsbestand hebben (zoals.xlam) dat de functies bevat die u wilt registreren en gebruiken.
5. Een voorbeeld van een Excel-invoegtoepassing: voor deze zelfstudie gebruiken we een Excel-invoegtoepassing met de naamTESTUDF.xlamZorg er dus voor dat u dit bij de hand hebt! Nu alles is ingesteld, kunnen we de mouwen opstropen en aan de slag met coderen!

Pakketten importeren

Om te beginnen moet u een aantal essentiële namespaces bovenaan uw C#-bestand importeren. Dit is wat u moet opnemen:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

Met deze naamruimten krijgt u toegang tot de klassen en methoden die we in deze tutorial gebruiken. Laten we dit opsplitsen in beheersbare stappen. Aan het einde van deze gids hebt u een goed begrip van hoe u add-infuncties registreert en gebruikt in uw Excel-werkmappen.

Stap 1: Stel uw bron- en uitvoermappen in

Voordat u uw invoegtoepassing kunt registreren, moet u definiëren waar de invoegtoepassing en de uitvoerbestanden worden opgeslagen.

// Bron directory
string sourceDir = "Your Document Directory";
// Uitvoermap
string outputDir = "Your Document Directory";

Vervangen"Your Document Directory" met het werkelijke pad waar je.xlam bestand en output bestanden worden opgeslagen. Dit is net als het opzetten van het podium voordat de show begint.

Stap 2: Maak een lege werkmap

Vervolgens wilt u een lege werkmap maken waarin u kunt experimenteren met invoegtoepassingen.

// Lege werkmap maken
Workbook workbook = new Workbook();

Deze regel code creëert een nieuwe werkmap die als onze speeltuin zal dienen. Zie het als een nieuw canvas, klaar voor uw creatieve slagen.

Stap 3: Registreer de invoegtoepassingsfunctie

Laten we nu tot de kern van de zaak komen! Het is tijd om uw add-in-functie te registreren. Dit is hoe u dat doet:

// Registreer de macro-ingeschakelde invoegtoepassing samen met de functienaam
int id = workbook.Worksheets.RegisterAddInFunction(sourceDir + @"TESTUDF.xlam", "TEST_UDF", false);

Deze regel registreert de invoegtoepassingsfunctie met de naamTEST_UDF gevonden in deTESTUDF.xlam add-in-bestand. Defalseparameter betekent dat de invoegtoepassing niet in een ‘geïsoleerde’ modus wordt geladen.

Stap 4: Registreer extra functies (indien van toepassing)

Als u meerdere functies in hetzelfde invoegtoepassingsbestand hebt geregistreerd, kunt u die ook registreren!

// Registreer meer functies in het bestand (indien van toepassing)
workbook.Worksheets.RegisterAddInFunction(id, "TEST_UDF1");

Hier ziet u hoe eenvoudig het is om meer functies toe te voegen vanuit dezelfde add-in. Blijf ze gewoon stapelen als bouwstenen!

Stap 5: Toegang tot het werkblad

Laten we verdergaan en naar het werkblad gaan waar we onze functie gaan gebruiken.

// Toegang tot eerste werkblad
Worksheet worksheet = workbook.Worksheets[0];

We openen het eerste werkblad in de werkmap om onze formule te plaatsen. Het is alsof we de deur openen naar de kamer waar het plezier plaatsvindt.

Stap 6: Toegang tot een specifieke cel

Vervolgens moeten we kiezen welke cel we willen gebruiken voor onze formule.

// Toegang tot eerste cel
var cell = worksheet.Cells["A1"];

Hier wijzen we naar cel A1. Dit is waar we onze magische formule gaan neerzetten. Je kunt het zien als het vastpinnen van een doelwit op je schatkaart!

Stap 7: Stel de formule in

Nu is het tijd voor de grote onthulling! Laten we de formule instellen die onze geregistreerde functie aanroept.

// Formulenaam instellen die aanwezig is in de invoegtoepassing
cell.Formula = "=TEST_UDF()";

Met deze regel vertellen we Excel om onze functie in cel A1 te gebruiken. Het is alsof je Excel een opdracht geeft en zegt: “Hé, doe dit!”

Stap 8: Sla de werkmap op

En als laatste, maar zeker niet onbelangrijk, is het tijd om ons meesterwerk te redden.

// Werkmap opslaan in uitvoerformaat XLSX.
workbook.Save(outputDir + @"test_udf.xlsx", Aspose.Cells.SaveFormat.Xlsx);

Hier slaan we onze werkmap op als een XLSX-bestand. Deze laatste stap is alsof je je schilderij in een lijst doet en klaarmaakt om het te laten zien!

Stap 9: Bevestig de uitvoering

Tot slot ronden we het geheel af door een succesbericht op de console af te drukken.

Console.WriteLine("RegisterAndCallFuncFromAddIn executed successfully.");

Deze lijn fungeert als onze overwinningsvlag. Het is een leuk gebaar om te bevestigen dat alles soepel is verlopen.

Conclusie

En daar heb je het! Je hebt niet alleen geleerd hoe je functies registreert en aanroept vanuit Excel-invoegtoepassingen met Aspose.Cells voor .NET, maar je hebt ook een dieper begrip gekregen van elke betrokken stap. Het leven is nu net iets makkelijker, nietwaar? Dus waarom zou je het niet zelf proberen? Duik in die Excel-invoegtoepassingen en geef je spreadsheets een nieuw niveau van interactiviteit en functionaliteit.

Veelgestelde vragen

Wat is een Excel-invoegtoepassing?

Een Excel-invoegtoepassing is een programma dat aangepaste functies, kenmerken of opdrachten aan Excel toevoegt, zodat gebruikers de mogelijkheden ervan kunnen uitbreiden.

Kan ik Aspose.Cells gebruiken zonder het lokaal te installeren?

Nee, u moet de Aspose.Cells-bibliotheek installeren om deze in uw .NET-toepassingen te kunnen gebruiken.

Hoe krijg ik een tijdelijke licentie voor Aspose.Cells?

U kunt hun bezoekentijdelijke licentiepagina voor meer informatie.

Is het mogelijk om meerdere functies vanuit één invoegtoepassing aan te roepen?

Ja! U kunt meerdere functies registreren vanuit hetzelfde invoegtoepassingsbestand met behulp van deRegisterAddInFunction methode.

Waar kan ik meer documentatie over Aspose.Cells vinden?

U kunt hun uitgebreide documentatie op de site bekijkenhier.