You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
EPPlus has from this new major version changed license from LGPL to[Polyform Noncommercial 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0/).
6
+
## License
7
+
EPPlus 8 has a dual license model with a community license for noncommercial use:[Polyform Noncommercial 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0/).
8
8
9
-
With the new license EPPlus is still free to use in some cases, but will require a commercial license to be used in a commercial business.
10
-
11
-
This is explained in more detail [here](https://www.epplussoftware.com/Home/LgplToPolyform).
9
+
With this license EPPlus is free to use for personal or noncommercial use, but will require a commercial license to be used in a commercial business.
12
10
13
11
Commercial licenses, which includes support, can be purchased at (https://www.epplussoftware.com/).
14
12
15
-
The source code of EPPlus has moved to a [new github repository](https://github.com/EPPlusSoftware/EPPlus)
13
+
The source code for EPPlus is available at [EPPlus Software's github repository](https://github.com/EPPlusSoftware/EPPlus)
14
+
15
+
## License parameter must be set
16
+
Before using EPPlus 8, you must specify the license to use. This is done via the License property of the ExcelPackage class
17
+
18
+
For commercial use, you use the License.SetCommercial(string), with your license key as argument.
19
+
Your license key is available on your license, under the section "My Licenses" on our website.
16
20
17
-
## LicenseContext parameter must be set
18
-
With the license change EPPlus has a new parameter that needs to be configured. If the LicenseContext is not set, EPPlus will throw a LicenseException (only in debug mode).
21
+
For noncommercial use, you set the License.SetNonCommercialOrganization(string) or License.SetNonCommercialPersonal(string) with the name as argument.
22
+
Noncommercial use will reserve the Comment and Tag field of the package for license information and add a license file within the package.
19
23
20
-
This is a simple configuration that can be set in a few alternative ways:
24
+
You can also configure these settings in the configuration files or in an environment varialble:
21
25
22
26
### 1. Via code
23
27
```csharp
24
28
// If you are a commercial business and have
25
29
// purchased commercial licenses use the static property
<addkey="EPPlus:ExcelPackage.License"value="NonCommercialPersonal:Your Name" /> //..or use "NonCommercialOrganization:Your Organizations name"
55
61
</appSettings>
56
62
```
57
63
### 4. Set the environment variable 'EPPlusLicenseContext'
58
-
This might be the easiest way of configuring this. Just as above, set the variable to Commercial or NonCommercial depending on your usage.
59
-
60
-
**Important!** The environment variable should be set at the user or process level.
61
-
62
-
## New features in EPPlus 7
63
-
* Calculation engine update to support array formulas. https://epplussoftware.com/en/Developers/EPPlus7
64
-
* Support for calculating legacy / dynamic array formulas.
65
-
* Support for intersect operator.
66
-
* Support for implicit intersection.
67
-
* Support for array parameters in functions.
68
-
* Better support for using the colon operator with functions.
69
-
* Better handling of circular references
70
-
* 90 new functions
71
-
* Faster optimized calculation engine with configurable expression caching.
72
-
* Breaking changes: Updated calculation engine, See [Breaking Changes in EPPlus 7](https://github.com/EPPlusSoftware/EPPlus/wiki/Breaking-Changes-in-EPPlus-7) for more information.
73
-
* Conditional Formatting improvements
74
-
* Improved performance, xml is now read and written on load and save.
75
-
* Cross worksheet support formula support.
76
-
* Extended styling options for color scales, data bars and icon sets.
64
+
This might be the easiest way of configuring this. Just as above, set the variable EPPlusLicense.
77
65
66
+
## New features in EPPlus 8
67
+
* Support for OLE objects (Linked or Embedded files).
68
+
* Support for digital signing workbooks and signature lines.
69
+
* In-cell pictures / support for the IMAGE function.
70
+
* Sensitivity Label API to integrate with MIP (Microsoft Information Protection SDK).
71
+
* Many minor features and bug fixes.
72
+
*
78
73
## Breaking Changes
79
-
See https://github.com/EPPlusSoftware/EPPlus/wiki/Breaking-Changes-in-EPPlus-7
74
+
See https://github.com/EPPlusSoftware/EPPlus/wiki/Breaking-Changes-in-EPPlus-8
80
75
81
-
## Improved documentation
82
-
EPPlus 7 has a new web sample site available here: (https://samples.epplussoftware.com/) , Source code is available here: [EPPlus.WebSamples](https://github.com/EPPlusSoftware/EPPlus.WebSamples)
83
-
There is also a new sample project for four different docker images, [EPPlus.DockerSample](https://github.com/EPPlusSoftware/EPPlus.DockerSample).
84
-
EPPlus also has two separate sample projects for [C#](https://github.com/EPPlusSoftware/EPPlus.Samples.CSharp) and [Visual Basic](https://github.com/EPPlusSoftware/EPPlus.Samples.VB/) respectively.
85
-
There is also an updated [developer wiki](https://github.com/EPPlusSoftware/EPPlus/wiki).
86
-
The work with improving the documentation will continue, feedback is highly appreciated!
EPPlus has from this new major version changed license from LGPL to [Polyform Noncommercial 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0/).
3
+
## License
4
+
EPPlus 8 has a dual license model with a community license for noncommercial use: [Polyform Noncommercial 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0/).
5
5
6
-
With the new license EPPlus is still free to use in some cases, but will require a commercial license to be used in a commercial business.
7
-
8
-
This is explained in more detail [here](https://www.epplussoftware.com/Home/LgplToPolyform).
6
+
With this license EPPlus is free to use for personal or noncommercial use, but will require a commercial license to be used in a commercial business.
9
7
10
8
Commercial licenses, which includes support, can be purchased at (https://www.epplussoftware.com/).
11
9
12
-
The source code of EPPlus has moved to a [new github repository](https://github.com/EPPlusSoftware/EPPlus)
10
+
The source code for EPPlus is available at [EPPlus Software's github repository](https://github.com/EPPlusSoftware/EPPlus)
11
+
12
+
## License parameter must be set
13
+
Before using EPPlus 8, you must specify the license to use. This is done via the License property of the ExcelPackage class
14
+
15
+
For commercial use, you use the License.SetCommercial(string), with your license key as argument.
16
+
Your license key is available on your license, under the section "My Licenses" on our website.
13
17
14
-
## LicenseContext parameter must be set
15
-
With the license change EPPlus has a new parameter that needs to be configured. If the LicenseContext is not set, EPPlus will throw a LicenseException (only in debug mode).
18
+
For noncommercial use, you set the License.SetNonCommercialOrganization(string) or License.SetNonCommercialPersonal(string) with the name as argument.
19
+
Noncommercial use will reserve the Comment and Tag field of the package for license information and add a license file within the package.
16
20
17
-
This is a simple configuration that can be set in a few alternative ways:
21
+
You can also configure these settings in the configuration files or in an environment varialble:
18
22
19
23
### 1. Via code
20
24
```csharp
21
25
// If you are a commercial business and have
22
26
// purchased commercial licenses use the static property
<add key="EPPlus:ExcelPackage.License" value="NonCommercialPersonal:Your Name" /> //..or use "NonCommercialOrganization:Your Organizations name"
52
58
</appSettings>
53
59
```
54
60
### 4. Set the environment variable 'EPPlusLicenseContext'
55
-
This might be the easiest way of configuring this. Just as above, set the variable to Commercial or NonCommercial depending on your usage.
56
-
57
-
**Important!** The environment variable should be set at the user or process level.
58
-
59
-
## New features in EPPlus 7 preview 1
60
-
* Calculation engine update to array formulas. https://github.com/EPPlusSoftware/EPPlus/wiki/EPPlus-7-Preview
61
-
* Support for calculating legacy / dynamic array formulas.
62
-
* Support for intersect operator.
63
-
* Support for Implicit intersection.
64
-
* Support for array parameters in functions.
65
-
* Better support for using the colon operator with functions.
66
-
* 21 new functions
67
-
61
+
This might be the easiest way of configuring this. Just as above, set the variable EPPlusLicense.
62
+
63
+
## New features in EPPlus 8
64
+
* Support for OLE objects (Linked or Embedded files).
65
+
* Support for digital signing workbooks and signature lines.
66
+
* In-cell pictures / support for the IMAGE function.
67
+
* Sensitivity Label API to integrate with MIP (Microsoft Information Protection SDK).
68
+
* Many minor features and bug fixes.
69
+
*
68
70
## Breaking Changes
69
-
The formula parser has changed significantly in EPPlus 7, requiring all custom functions that inherits from the `ExcelFunction` class to be reviewed.
70
-
The `ExcelFunction` class now exposes new properties used to handle array results and condition behaviour.
71
-
* `NamespacePrefix` - If the function requires a prefix when saved, for example "_xlfn." or "_xlfn._xlws."
72
-
* `HasNormalArguments` a boolean indicating if the formula only has normal arguments. If false, the `GetParameterInfo` method must be implemented. Default is true.
73
-
* `ReturnsReference` - If true the function can return a reference to a range. Use the `CreateAddressResult` to return the result with a reference. Returning a reference, will cause the dependency chain to check the address and will allow the colon operator to be used with the function.
74
-
* `IsVolatile` - If the function returns different result when called with the same parameters. Default false.
75
-
* `ArrayBehaviour` - If the function allows arrays as input in a parameter, resulting in an array output. Also see the `GetArrayBehaviourConfig` method.
76
-
Methods
77
-
* `CreateAddressResult` - Return the result with an range to a range.
78
-
* `CreateDynamicArrayResult` - The result should be treated as a dynamic array.
79
-
* `GetArrayBehaviourConfig` - Sets the index if the parameters that can be arrays. Also see the `ArrayBehaviour` property.
80
-
81
-
* The source code tokenizer now tokenize more detailed, tokenizing addresses.
82
-
* The expression handling is totally rewritten and now uses reversed polish notation instead of group expressions.
83
-
84
-
85
-
### Breaking Changes in version 6.1
86
-
* All public references to System.Drawing.Common has been removed from EPPlus. See [Breaking Changes in EPPlus 6](https://github.com/EPPlusSoftware/EPPlus/wiki/Breaking-Changes-in-EPPlus-6).
87
-
* Static class 'FontSize' has splitted width and heights into two dictionaries. FontSizes are lazy-loaded when needed.
88
-
* ...and more, see https://epplussoftware.com/docs/6.0/articles/breakingchanges.html
89
-
### Breaking Changes in version 5.
90
-
* The default behavior for the Worksheet collection base in .NET Framework has changed from 1 to 0. This is the same default behavior as in .NET core today.
91
-
* Pictures have changed the behavior as the oneCellAnchor tag is used instead of the twoCellAnchor tag with the editAs="oneCell".
71
+
See https://github.com/EPPlusSoftware/EPPlus/wiki/Breaking-Changes-in-EPPlus-8
92
72
93
-
## Improved documentation
94
-
EPPlus 6 has a new web sample site available here: (https://samples.epplussoftware.com/) , Source code is available here: [EPPlus.WebSamples](https://github.com/EPPlusSoftware/EPPlus.WebSamples)
95
-
There is also a new sample project for four different docker images, [EPPlus.DockerSample](https://github.com/EPPlusSoftware/EPPlus.DockerSample)
96
-
EPPlus also has two separate sample projects for [.NET Core](https://github.com/EPPlusSoftware/EPPlus.Sample.NetCore/tree/version/EPPlus6.0) and [.NET Framework](https://github.com/EPPlusSoftware/EPPlus.Sample.NetFramework/tree/version/EPPlus6.0) respectively.
97
-
There is also an updated [developer wiki](https://github.com/EPPlusSoftware/EPPlus/wiki).
98
-
The work with improving the documentation will continue, feedback is highly appreciated!
0 commit comments