Funkciók regisztrálása és hívása az Excel bővítményéből

Bevezetés

Szeretné javítani az Excel-élményt azáltal, hogy függvényeket hív meg egy bővítményből? Ha igen, akkor jó helyen jársz! Az Excel-bővítmények olyanok, mint a táblázatok tündérkeresztanyjai; varázslatosan kibővítik a funkcionalitást, és egy csomó új eszközt biztosítanak a keze ügyében. Az Aspose.Cells for .NET segítségével pedig minden eddiginél egyszerűbb regisztrálni és használni ezeket a kiegészítő funkciókat. Ebben az útmutatóban végigvezetem a függvények regisztrálásának és meghívásának folyamatán egy Excel-bővítményből az Aspose.Cells for .NET használatával. Lépésről lépésre mindent lebontunk, így pillanatok alatt profinak fogod érezni magad!

Előfeltételek

Mielőtt belemerülnénk a kódolási varázslóba, nézzük meg, mit kell a helyén tartani:

  1. Visual Studio: Győződjön meg arról, hogy a Visual Studio be van állítva a gépen. Itt írjuk és futtatjuk a kódunkat.
  2. Aspose.Cells Library: telepítenie kell az Aspose.Cells könyvtárat. Elkaphatod tőlükletöltési oldal.
  3. Alapvető C# ismerete: A C# egy kis megértése sokat segít; ez segít zökkenőmentesen követni.
  4. Excel-bővítmények: rendelkeznie kell egy bővítményfájllal (pl.xlam), amely a regisztrálni és használni kívánt funkciókat tartalmazza.
  5. Minta Excel-bővítmény: Ebben az oktatóanyagban egy Excel-bővítményt fogunk használniTESTUDF.xlam. Tehát győződjön meg róla, hogy ez a rendelkezésére áll! Most, hogy elkészült, feltűrjük az ingujjunkat, és kezdjük a kódolást!

Csomagok importálása

A kezdéshez importálnia kell néhány alapvető névteret a C# fájl tetején. A következőket kell tartalmaznia:

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

Ezek a névterek lehetővé teszik az oktatóanyagban használt osztályok és metódusok elérését. Bontsuk ezt fel kezelhető lépésekre. Az útmutató végére alapos ismerete lesz arról, hogyan regisztrálhat bővítményfüggvényeket, és hogyan használhatja azokat Excel-munkafüzeteiben.

1. lépés: Állítsa be a forrás- és kimeneti könyvtárakat

Mielőtt regisztrálná a bővítményt, meg kell határoznia, hogy a bővítmény- és kimeneti fájljai hol fognak élni.

// Forrás könyvtár
string sourceDir = "Your Document Directory";
// Kimeneti könyvtár
string outputDir = "Your Document Directory";

Cserélje ki"Your Document Directory" a tényleges útvonallal, ahol az Ön.xlam fájl és kimeneti fájlok mentésre kerülnek. Ez olyan, mint a színpad beállítása a műsor kezdete előtt.

2. lépés: Hozzon létre egy üres munkafüzetet

Ezután létre kell hoznia egy üres munkafüzetet, ahol játszhatunk a kiegészítő funkciókkal.

// Üres munkafüzet létrehozása
Workbook workbook = new Workbook();

Ez a kódsor egy új munkafüzetet hoz létre, amely játszóterünkként fog szolgálni. Tekintse úgy, mint egy friss vászonra, amely készen áll a kreatív vonásaira.

3. lépés: Regisztrálja a bővítmény funkciót

Most pedig térjünk a dolog lényegéhez! Ideje regisztrálni a bővítmény funkcióját. Íme, hogyan kell csinálni:

// Regisztrálja a makróképes bővítményt a függvény nevével együtt
int id = workbook.Worksheets.RegisterAddInFunction(sourceDir + @"TESTUDF.xlam", "TEST_UDF", false);

Ez a sor regisztrálja a nevű bővítmény függvénytTEST_UDF található aTESTUDF.xlam kiegészítő fájl. Afalseparaméter azt jelenti, hogy a bővítmény nincs „elszigetelt” módban betöltve.

4. lépés: További funkciók regisztrálása (ha vannak)

Ha ugyanabban a bővítményfájlban több funkció van regisztrálva, azokat is regisztrálhatja!

// További funkciók regisztrálása a fájlban (ha van)
workbook.Worksheets.RegisterAddInFunction(id, "TEST_UDF1");

Itt láthatja, milyen egyszerűen lehet több funkciót hozzáadni ugyanabból a bővítményből. Csak rakja egymásra őket, mint az építőkockákat!

5. lépés: Nyissa meg a munkalapot

Menjünk tovább, és nyissa meg a munkalapot, ahol a funkciónkat fogjuk használni.

// Az első munkalap elérése
Worksheet worksheet = workbook.Worksheets[0];

A képlet elhelyezéséhez elérjük a munkafüzet első munkalapját. Olyan, mintha kinyitnád a szoba ajtaját, ahol a szórakozás történik.

6. lépés: Hozzáférés egy adott cellához

Ezután ki kell választanunk, hogy melyik cellát szeretnénk használni a képlethez.

// Hozzáférés az első cellához
var cell = worksheet.Cells["A1"];

Itt az A1 cellára mutatunk. Itt fogjuk eldobni a varázsképletünket. Úgy is gondolhatod, mint egy célpontot a kincsestérképedre!

7. lépés: Állítsa be a képletet

Itt az ideje a nagyszabású leleplezésnek! Állítsuk be a képletet, amely meghívja a regisztrált függvényünket.

// Állítsa be a bővítményben található képlet nevét
cell.Formula = "=TEST_UDF()";

Ezzel a sorral azt mondjuk az Excelnek, hogy az A1 cellán belül használja a függvényünket. Ez olyan, mintha parancsot adna az Excelnek, és azt mondaná: „Hé, csináld!”

8. lépés: Mentse el a munkafüzetet

Végül, de nem utolsósorban itt az ideje megmenteni remekművünket.

// Mentse a munkafüzetet XLSX kimeneti formátumba.
workbook.Save(outputDir + @"test_udf.xlsx", Aspose.Cells.SaveFormat.Xlsx);

Itt a munkafüzetünket XLSX-fájlként mentjük. Ez az utolsó lépés olyan, mintha keretbe helyezné a festményét, és felkészülne a bemutatására!

9. lépés: Erősítse meg a végrehajtást

Végül fejezzük be az egészet egy sikerüzenet kinyomtatásával a konzolra.

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

Ez a vonal a mi győzelmi zászlónk. Ez egy kellemes kis érintés, amely megerősíti, hogy minden simán ment.

Következtetés

És megvan! Nemcsak azt tanulta meg, hogyan regisztrálhat és hívhat függvényeket az Excel-bővítményekből az Aspose.Cells for .NET használatával, hanem az egyes lépések mélyebb megértését is. Most egy kicsit könnyebb az élet, nem? Miért ne próbálhatná ki saját maga? Merüljön el az Excel-bővítményekben, és helyezze táblázatait az interaktivitás és a funkcionalitás új szintjére.

GYIK

Mi az Excel-bővítmény?

Az Excel-bővítmény egy olyan program, amely egyéni szolgáltatásokat, funkciókat vagy parancsokat ad az Excelhez, lehetővé téve a felhasználók számára a képességek bővítését.

Használhatom az Aspose.Cells-t helyi telepítés nélkül?

Nem, telepítenie kell az Aspose.Cells könyvtárat, hogy használni tudja a .NET-alkalmazásaiban.

Hogyan szerezhetek ideiglenes licencet az Aspose.Cells számára?

Meglátogathatod őketideiglenes licenc oldal további információkért.

Meg lehet hívni több függvényt egyetlen bővítményből?

Igen! Több funkciót is regisztrálhat ugyanabból a bővítményfájlból a segítségévelRegisterAddInFunction módszer.

Hol találok további dokumentációt az Aspose.Cells-ről?

Átfogó dokumentációjukat megtekintheti az oldalonitt.