Redpoint.StringEnum 2025.1129.345

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package Redpoint.StringEnum --version 2025.1129.345
                    
NuGet\Install-Package Redpoint.StringEnum -Version 2025.1129.345
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Redpoint.StringEnum" Version="2025.1129.345" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Redpoint.StringEnum" Version="2025.1129.345" />
                    
Directory.Packages.props
<PackageReference Include="Redpoint.StringEnum" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Redpoint.StringEnum --version 2025.1129.345
                    
#r "nuget: Redpoint.StringEnum, 2025.1129.345"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#addin nuget:?package=Redpoint.StringEnum&version=2025.1129.345
                    
Install as a Cake Addin
#tool nuget:?package=Redpoint.StringEnum&version=2025.1129.345
                    
Install as a Cake Tool

Redpoint.StringEnum

This library provides an API for defining and using string-backed enumeration types. These are useful when used with databases, where storing string values for enumerations improves forward and backward compatibility (unlike storing numeric values).

Defining a string-backed enumeration type

You can create a string-backed enumeration, by defining a class like so:

class Example : StringEnum<Example>
{
    public static readonly StringEnumValue<Example> FirstValue = Create("first-value");

    public static readonly StringEnumValue<Example> SecondValue = Create("second-value");

    public static readonly StringEnumValue<Example> ThirdValue = Create("third-value");

    // ...
}

The string values that represent the enumeration are case-and-byte sensitive (ordinal comparison). You can not create enumeration values from a null string; ArgumentNullException will be thrown if you pass a null value to Create.

Defining additional enumeration values at runtime

There is currently no API for defining additional enumeration values at runtime; the possible enumeration values are lazy-loaded once by looking at the static fields and static properties of the class that inherits from StringEnum<T> (via the T type parameter). Both public and non-public fields/properties are included.

This library is both trim and AOT-compatible, as it uses [DynamicallyAccessedMembers] to ensure the fields and properties of the enumeration type are available at runtime for reflection.

Static usage of values

In most code, you'll simply use the static readonly fields you've defined, such as Example.FirstValue. All instances of the value - even those from parsing - are guaranteed to be reference and value equal.

Parsing known values from strings

To parse a value that is known to be valid from a string, you can use Example.Parse or StringEnumValue<Example>.Parse:

var value = Example.Parse("first-value");
var value2 = StringEnumValue<Example>.Parse("second-value");

If the value is not valid when calling Parse, StringEnumParseException will be thrown. You should use TryParse (see below) if the value is potentially invalid.

If you pass a null value to Parse, ArgumentNullException will be thrown.

Parsing potentially invalid string values

If you're unsure whether a string is a valid enumeration value, you can use Example.TryParse or StringEnumValue<Example>.TryParse:

var isValid = Example.TryParse("...", out var value);
var isValid2 = StringEnumValue<Example>.TryParse("...", out var value2);

If you pass a null value to TryParse, ArgumentNullException will be thrown.

Parsing strings to runtime-based enumeration types

If you don't know the type of the string enumeration you want to parse into at compile time, you can use DynamicStringEnumValue.TryParse to parse any string value into an instance of StringEnumValue<T> by passing the StringEnumValue<T> type as the first parameter, like so:

var type = typeof(StringEnumValue<Example>);
var isValid = DynamicStringEnumValue.TryParse(type, "...", out var value);

You can use DynamicStringEnumValue.IsStringEnumValueType to check if type is a constructed generic type of StringEnumValue<T>. The APIs provided by DynamicStringEnumValue are primarily intended to be used with database serialization and deserialization, where the concrete types of values are not known at the point of deserialization.

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net9.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Redpoint.StringEnum:

Package Downloads
Redpoint.CloudFramework

A framework for building ASP.NET Core applications on top of Google Cloud Firestore in Datastore mode. Not only does this framework provide a model-based API for interacting with Google Cloud Firestore, it contains useful implementations of things like database migrations, distributed locks, geographic indexes and sharded counters.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2025.1183.853 134 7/2/2025
2025.1181.644 129 6/30/2025
2025.1175.340 184 6/24/2025
2025.1174.62 143 6/23/2025
2025.1171.352 119 6/20/2025
2025.1169.413 141 6/18/2025
2025.1166.1191 151 6/15/2025
2025.1166.1178 133 6/15/2025
2025.1166.1177 135 6/15/2025
2025.1159.445 115 6/8/2025
2025.1159.364 109 6/8/2025
2025.1159.324 107 6/8/2025
2025.1155.438 143 6/4/2025
2025.1141.1424 147 5/21/2025
2025.1140.383 138 5/20/2025
2025.1140.377 146 5/20/2025
2025.1139.983 153 5/19/2025
2025.1139.952 149 5/19/2025
2025.1139.941 140 5/19/2025
2025.1139.855 137 5/19/2025
2025.1139.850 138 5/19/2025
2025.1139.837 141 5/19/2025
2025.1139.811 140 5/19/2025
2025.1139.806 144 5/19/2025
2025.1139.796 132 5/19/2025
2025.1139.729 135 5/19/2025
2025.1139.719 150 5/19/2025
2025.1139.706 151 5/19/2025
2025.1139.694 138 5/19/2025
2025.1139.679 142 5/19/2025
2025.1139.662 141 5/19/2025
2025.1139.638 136 5/19/2025
2025.1139.628 142 5/19/2025
2025.1139.626 139 5/19/2025
2025.1139.619 139 5/19/2025
2025.1139.605 139 5/19/2025
2025.1139.600 145 5/19/2025
2025.1139.583 140 5/19/2025
2025.1139.573 137 5/19/2025
2025.1139.564 138 5/19/2025
2025.1139.552 151 5/19/2025
2025.1139.543 144 5/19/2025
2025.1138.909 142 5/18/2025
2025.1136.150 202 5/16/2025
2025.1135.267 217 5/15/2025
2025.1135.143 222 5/15/2025
2025.1133.453 235 5/13/2025
2025.1133.351 228 5/13/2025
2025.1133.349 229 5/13/2025
2025.1133.347 238 5/13/2025
2025.1130.236 77 5/10/2025
2025.1129.831 111 5/9/2025
2025.1129.346 135 5/9/2025
2025.1129.345 130 5/9/2025
2025.1121.1370 159 5/1/2025
2025.1119.450 163 4/29/2025
2025.1119.436 156 4/29/2025
2025.1119.409 157 4/29/2025
2025.1119.388 160 4/29/2025
2025.1119.360 153 4/29/2025
2025.1119.328 173 4/29/2025
2025.1119.299 158 4/29/2025
2025.1119.287 159 4/29/2025
2025.1116.868 91 4/26/2025
2025.1116.841 81 4/26/2025
2025.1116.444 85 4/26/2025
2025.1115.498 128 4/25/2025
2025.1115.491 134 4/25/2025
2025.1100.365 181 4/10/2025
2025.1100.336 176 4/10/2025
2025.1100.331 180 4/10/2025
2025.1098.108 171 4/8/2025
2025.1093.291 185 4/3/2025
2025.1091.38 182 4/1/2025
2025.1091.26 182 4/1/2025
2025.1090.237 171 3/31/2025
2025.1089.1386 168 3/30/2025
2025.1083.515 418 3/24/2025
2025.1083.408 349 3/24/2025
2025.1083.398 346 3/24/2025
2025.1083.125 344 3/24/2025
2025.1080.41 155 3/21/2025
2025.1075.357 227 3/16/2025
2025.1073.332 148 3/14/2025
2025.1072.541 177 3/13/2025
2025.1072.536 158 3/13/2025
2025.1064.602 241 3/5/2025
2025.1064.546 219 3/5/2025
2025.1062.589 168 3/3/2025
2025.1061.513 121 3/2/2025
2025.1060.490 113 3/1/2025
2025.1059.134 122 2/28/2025
2025.1057.1020 119 2/26/2025
2025.1056.584 117 2/25/2025
2025.1050.282 136 2/19/2025
2025.1050.232 133 2/19/2025
2025.1049.55 147 2/18/2025
2025.1045.285 127 2/14/2025
2025.1043.288 113 2/12/2025
2025.1043.246 116 2/12/2025
2025.1043.197 124 2/12/2025
2025.1043.180 107 2/12/2025
2025.1043.108 108 2/12/2025
2025.1043.38 106 2/12/2025
2025.1043.27 110 2/12/2025
2025.1042.725 122 2/11/2025
2025.1042.690 113 2/11/2025
2025.1042.688 119 2/11/2025
2025.1042.418 112 2/11/2025
2025.1042.215 119 2/11/2025
2025.1042.203 119 2/11/2025
2025.1042.184 111 2/11/2025
2025.1042.142 123 2/11/2025
2025.1042.127 120 2/11/2025
2025.1037.1327 111 2/6/2025
2025.1036.280 118 2/5/2025
2025.1036.55 125 2/5/2025
2025.1035.1387 133 2/4/2025
2025.1031.111 127 1/31/2025
2025.1030.916 121 1/30/2025
2025.1030.895 126 1/30/2025
2025.1030.592 122 1/30/2025
2025.1029.664 104 1/29/2025
2025.1029.632 103 1/29/2025
2025.1029.596 108 1/29/2025
2025.1028.386 101 1/28/2025
2025.1025.723 103 1/25/2025
2025.1025.712 109 1/25/2025
2025.1019.913 112 1/19/2025
2025.1018.374 107 1/18/2025
2025.1018.285 142 1/18/2025
2025.1017.646 103 1/17/2025
2025.1017.379 134 1/17/2025
2025.1016.1370 113 1/16/2025
2025.1016.765 104 1/16/2025
2025.1016.712 106 1/16/2025
2025.1016.550 107 1/16/2025
2025.1016.541 107 1/16/2025
2025.1016.532 108 1/16/2025
2025.1016.325 103 1/16/2025
2025.1016.308 106 1/16/2025
2025.1016.296 99 1/16/2025
2025.1016.237 124 1/16/2025
2025.1016.184 100 1/16/2025
2025.1016.70 103 1/16/2025
2025.1016.6 106 1/16/2025
2025.1015.1438 104 1/16/2025
2025.1015.1437 99 1/16/2025
2025.1015.1411 103 1/15/2025
2025.1015.240 72 1/15/2025
2025.1015.223 63 1/15/2025
2025.1015.183 71 1/15/2025
2025.1014.1342 81 1/14/2025
2025.1014.273 90 1/14/2025
2025.1014.256 95 1/14/2025
2025.1012.440 95 1/12/2025
2025.1012.327 106 1/12/2025
2025.1012.279 102 1/12/2025
2025.1002.636 116 1/2/2025
2025.1001.1435 124 1/2/2025
2025.1001.1397 117 1/1/2025
2025.1001.770 118 1/1/2025
2025.1001.570 126 1/1/2025
2025.1001.558 111 1/1/2025
2025.1001.421 117 1/1/2025
2025.1001.390 118 1/1/2025
2025.1001.234 131 1/1/2025
2025.1001.123 122 1/1/2025
2024.1360.354 119 12/25/2024
2024.1360.60 109 12/25/2024
2024.1360.32 110 12/25/2024
2024.1358.450 109 12/23/2024
2024.1358.359 111 12/23/2024
2024.1358.312 107 12/23/2024
2024.1358.244 117 12/23/2024
2024.1358.120 106 12/23/2024
2024.1348.253 126 12/13/2024
2024.1345.1379 103 12/10/2024
2024.1345.506 104 12/10/2024
2024.1345.379 101 12/10/2024
2024.1345.145 104 12/10/2024
2024.1345.72 108 12/10/2024
2024.1345.69 101 12/10/2024
2024.1345.15 110 12/10/2024
2024.1344.1436 106 12/10/2024
2024.1344.600 114 12/9/2024
2024.1344.411 114 12/9/2024
2024.1340.379 117 12/5/2024
2024.1340.15 123 12/5/2024
2024.1338.786 120 12/3/2024
2024.1338.722 125 12/3/2024
2024.1338.697 115 12/3/2024
2024.1338.639 118 12/3/2024
2024.1338.541 116 12/3/2024
2024.1338.318 107 12/3/2024
2024.1338.298 111 12/3/2024
2024.1338.98 118 12/3/2024
2024.1337.756 118 12/2/2024
2024.1337.634 120 12/2/2024
2024.1337.625 107 12/2/2024
2024.1337.621 112 12/2/2024
2024.1337.594 110 12/2/2024
2024.1337.136 102 12/2/2024
2024.1336.793 123 12/1/2024
2024.1336.773 121 12/1/2024
2024.1336.305 112 12/1/2024
2024.1336.12 127 12/1/2024
2024.1335.1421 119 11/30/2024
2024.1335.1384 117 11/30/2024
2024.1334.1308 121 11/29/2024
2024.1334.764 111 11/29/2024
2024.1334.722 118 11/29/2024
2024.1330.185 115 11/25/2024
2024.1328.505 124 11/23/2024
2024.1328.470 109 11/23/2024
2024.1328.452 114 11/23/2024
2024.1323.910 123 11/18/2024
2024.1323.653 108 11/18/2024
2024.1323.185 107 11/18/2024
2024.1323.49 104 11/18/2024
2024.1322.714 107 11/17/2024
2024.1320.653 116 11/15/2024
2024.1320.619 106 11/15/2024
2024.1320.601 101 11/15/2024
2024.1320.159 109 11/15/2024
2024.1320.98 109 11/15/2024
2024.1320.2 116 11/15/2024
2024.1319.1431 115 11/15/2024
2024.1319.1335 116 11/14/2024
2024.1317.631 118 11/12/2024
2024.1316.330 124 11/11/2024
2024.1311.540 115 11/6/2024
2024.1306.225 112 11/1/2024
2024.1306.199 122 11/1/2024
2024.1306.171 115 11/1/2024
2024.1306.117 122 11/1/2024
2024.1305.506 107 10/31/2024
2024.1305.502 107 10/31/2024
2024.1305.465 108 10/31/2024
2024.1305.442 110 10/31/2024
2024.1305.399 109 10/31/2024
2024.1299.1070 115 10/25/2024
2024.1289.621 127 10/15/2024
2024.1289.338 115 10/15/2024
2024.1277.836 116 10/5/2024
2024.1277.711 118 10/3/2024
2024.1277.695 114 10/3/2024
2024.1270.409 130 9/26/2024
2024.1269.621 132 9/25/2024
2024.1269.619 117 9/25/2024
2024.1269.605 127 9/25/2024
2024.1242.282 129 8/29/2024
2024.1242.261 127 8/29/2024
2024.1242.233 134 8/29/2024
2024.1238.829 145 8/25/2024
2024.1238.327 147 8/25/2024
2024.1225.297 135 8/12/2024
2024.1205.140 132 7/23/2024
2024.1204.110 136 7/22/2024
2024.1204.62 126 7/22/2024
2024.1190.491 139 7/8/2024
2024.1177.305 133 6/25/2024
2024.1168.700 146 6/16/2024
2024.1168.649 136 6/16/2024
2024.1168.535 141 6/16/2024
2024.1167.643 135 6/15/2024
2024.1166.989 130 6/14/2024
2024.1166.818 131 6/14/2024
2024.1166.535 139 6/14/2024
2024.1166.422 130 6/14/2024
2024.1166.362 129 6/14/2024
2024.1166.360 134 6/14/2024
2024.1165.1212 133 6/13/2024
2024.1165.1160 128 6/13/2024
2024.1165.1019 133 6/13/2024
2024.1165.978 130 6/13/2024
2024.1165.920 126 6/13/2024
2024.1165.908 135 6/13/2024
2024.1165.873 134 6/13/2024
2024.1165.830 128 6/13/2024
2024.1165.806 133 6/13/2024
2024.1165.794 137 6/13/2024
2024.1165.792 140 6/13/2024
2024.1165.761 132 6/13/2024
2024.1165.743 131 6/13/2024
2024.1165.735 136 6/13/2024
2024.1165.713 133 6/13/2024
2024.1165.640 125 6/13/2024
2024.1165.574 137 6/13/2024
2024.1165.466 127 6/13/2024
2024.1165.417 132 6/13/2024
2024.1165.392 129 6/13/2024
2024.1164.341 119 6/12/2024
2024.1155.941 145 6/3/2024
2024.1140.783 149 5/19/2024
2024.1140.692 130 5/19/2024
2024.1140.673 136 5/19/2024
2024.1129.506 138 5/8/2024
2024.1128.831 150 5/7/2024
2024.1124.465 116 5/3/2024
2024.1123.1162 123 5/2/2024
2024.1123.1117 108 5/2/2024
2024.1123.1050 98 5/2/2024
2024.1122.352 136 5/1/2024
2024.1122.233 135 5/1/2024
2024.1115.1101 137 4/24/2024
2024.1115.1048 124 4/24/2024
2024.1115.932 124 4/24/2024
2024.1115.858 136 4/24/2024
2024.1115.665 135 4/24/2024
2024.1115.648 130 4/24/2024
2024.1115.591 139 4/24/2024
2024.1101.390 134 4/10/2024
2024.1100.741 141 4/9/2024
2024.1099.526 142 4/8/2024
2024.1099.466 137 4/8/2024
2024.1098.573 140 4/7/2024
2024.1095.977 140 4/4/2024
2024.1095.847 135 4/4/2024
2024.1095.604 139 4/4/2024
2024.1095.485 161 4/4/2024
2024.1094.930 134 4/3/2024
2024.1094.910 148 4/3/2024
2024.1094.387 149 4/3/2024
2024.1094.313 134 4/3/2024
2024.1093.520 137 4/2/2024
2024.1092.240 134 4/1/2024
2024.1089.1425 150 3/29/2024
2024.1089.983 141 3/29/2024
2024.1089.942 126 3/29/2024
2024.1089.2 145 3/29/2024
2024.1088.1343 136 3/28/2024
2024.1088.1139 142 3/28/2024
2024.1088.875 111 3/28/2024
2024.1088.700 126 3/28/2024
2024.1088.603 142 3/28/2024
2024.1088.590 145 3/28/2024
2024.1088.575 139 3/28/2024
2024.1088.561 141 3/28/2024
2024.1088.506 145 3/28/2024
2024.1088.18 143 3/28/2024
2024.1087.1181 154 3/27/2024
2024.1087.1173 141 3/27/2024
2024.1087.1143 148 3/27/2024
2024.1087.1108 129 3/27/2024
2024.1087.950 144 3/27/2024
2024.1087.939 131 3/27/2024
2024.1087.252 144 3/27/2024
2024.1070.736 143 3/10/2024
2024.1049.1437 148 2/19/2024
2024.1036.571 151 2/5/2024
2024.1036.508 135 2/5/2024
2024.1032.1204 138 2/1/2024
2024.1032.1133 134 2/1/2024
2024.1032.1122 157 2/1/2024
2024.1032.1071 130 2/1/2024
2024.1032.940 129 2/1/2024
2024.1031.912 127 1/31/2024
2024.1031.893 131 1/31/2024
2024.1031.851 117 1/31/2024
2024.1031.829 128 1/31/2024
2024.1031.386 126 1/31/2024
2024.1031.318 145 1/31/2024
2024.1017.460 153 1/17/2024
2024.1017.420 130 1/17/2024
2024.1017.163 133 1/17/2024
2024.1016.414 667 1/16/2024
2024.1012.167 153 1/12/2024
2024.1011.406 146 1/11/2024
2024.1010.315 158 1/10/2024
2023.1358.326 187 12/24/2023
2023.1351.473 152 12/17/2023
2023.1351.445 152 12/17/2023
2023.1351.432 161 12/17/2023
2023.1350.478 155 12/16/2023
2023.1344.600 167 12/10/2023
2023.1344.529 206 12/10/2023
2023.1339.582 166 12/5/2023
2023.1338.1072 171 12/4/2023
2023.1336.844 168 12/2/2023
2023.1335.378 166 12/1/2023
2023.1335.236 161 12/1/2023
2023.1335.203 151 12/1/2023