ספריית קוד פתוח .NET לעיבוד גיליונות אלקטרוניים של Excel  

תחילת העבודה עם Excel-DNA

הדרך המומלצת להתקין את ExcelDNA היא מ-NuGet, אנא השתמש בפקודה הבאה להתקנה מהירה יותר.

 Install-Package ExcelDna.AddIn

צור פונקציות Excel באמצעות .NET API

ExcelDNA מעניק למתכנתי C# .NET את היכולת ליצור פונקציות Excel באמצעות C#. אתה יכול גם להשתמש ב- ExcelFunctionAttributes כמו שם, תיאור, קטגוריה, IsHidden, IsExceptionSafe ועוד. התכונה IsMacroType משנה את הפרמטרים שבהם Excel-DNA משתמש בעת רישום הפונקציה.

public class GetInfoFunctions
{
    [ExcelFunction(Description = "Returns the result of xlfGetCell.", IsMacroType = true)]
    public static object GetCell(int type_num, [ExcelArgument(AllowReference = true)] object reference)
    {
        return XlCall.Excel(XlCall.xlfGetCell, type_num, reference);
    }
    [ExcelFunction(Description = "Returns the result of xlfGetWorkspace.", IsMacroType = true)]
    public static object GetWorkspace(int type_num)
    {
        return XlCall.Excel(XlCall.xlfGetWorkspace, type_num);
    }
    [ExcelFunction(Description = "Returns the current list separator.", IsMacroType = true)]
    public static string GetListSeparator(int type_num)
    {
        object[,] workspaceSettings = (object[,])XlCall.Excel(XlCall.xlfGetWorkspace, 37);
        string listSeparator = (string)workspaceSettings[0, 4];
        return listSeparator;
    }
}

תמיכה במערכים דינמיים

הקוד הפתוח .NET API Excel-DNA תומך גם בשימוש במערכים דינמיים בתוך אקסל. כאשר אתה כותב נוסחת מערך דינמי, הוא קובע אם לנוסחה יש פוטנציאל להחזיר ערכים מרובים.

public static object dnaMakeArrayAndResize(int rows, int columns, string unused, string unusedtoo)
        {
            object[,] result = dnaMakeArray(rows, columns);
            return ArrayResizer.dnaResize(result);
            // Can also call Resize via Excel - so if the Resize add-in is not part of this code, it should still work
            // (though calling direct is better for large arrays - it prevents extra marshaling).
            // return XlCall.Excel(XlCall.xlUDF, "Resize", result);
        }
        public static double[,] dnaMakeArrayAndResizeDoubles(int rows, int columns)
        {
            double[,] result = dnaMakeArrayDoubles(rows, columns);
            return ArrayResizer.dnaResizeDoubles(result);
        }
    }

סיוע התחברות אבחון

ExcelDNA API מאפשר למפתחי NET להשתמש ברישום אבחון תוך כדי עבודה עם תוסף Excel. Excel-DNA משתמש במנגנוני .NET System.Diagnostics.Trace הסטנדרטיים לרישום אבחון.

public void AutoOpen()
{
    // Log warnings and errors to the Excel-DNA LogDisplay
    Trace.Listeners.Add(new LogDisplayTraceListener());
}
...
Trace.TraceInformation("Trace information!");
Trace.TraceWarning("Trace warning!");
Trace.TraceError("Trace error!");