0

0

C# 枚举类型使用方法 C#如何定义和使用enum

星降

星降

发布时间:2026-01-28 12:15:09

|

206人浏览过

|

来源于php中文网

原创

C#中enum是值类型,用于定义命名常量,默认底层类型为int;支持显式赋值、自定义底层类型、[Flags]位运算、安全转换(TryParse)、字符串序列化及数据库存储建议。

c# 枚举类型使用方法 c#如何定义和使用enum

enum 基本定义和语法结构

在 C# 中,enum 是一种值类型,用于定义一组命名的常量。它本质是整数(默认 int),但语义更清晰、可读性更强。

定义时必须指定名称,成员默认从 0 开始递增;也可显式赋值,支持跳号、重复值(不推荐):

public enum Status
{
    Pending = 0,
    Processing = 1,
    Completed = 2,
    Failed = -1  // 可跨类型赋值,如负数或大整数
}
  • 枚举底层类型可以是 sbytebyteshortushortint(默认)、uintlongulong,声明时用冒号指定:enum Priority : byte { Low, Medium, High }
  • 枚举成员名必须是合法标识符,不能带空格或特殊字符;若需显示“User ID”,应配合 [Display][Description] 特性处理
  • 不要在枚举里写方法或字段——enum 不支持继承、不能有实例构造函数,也不是类

如何安全地将字符串或数字转为 enum

运行时解析用户输入(如 API 参数、配置文件)时,常见需求是把 stringint 转成对应枚举值。直接强制转换可能抛出异常,必须校验。

  • Enum.TryParse 最安全:返回 bool 表示是否成功,不抛异常
  • Enum.IsDefined 只检查值是否存在,但对字符串不敏感大小写(默认),且无法识别带空格或连字符的别名
  • 避免用 (MyEnum)someInt 强转——若 someInt 不在枚举范围内,不会报错,但值非法,后续逻辑易出错
string input = "Completed";
if (Enum.TryParse(input, true, out Status result))
{
    Console.WriteLine(result); // 输出 Completed
}
else
{
    Console.WriteLine("无效状态");
}

使用 [Flags] 特性实现位运算组合

当枚举需要表示「多个状态同时存在」(比如权限、选项集合),应加 [Flags] 特性,并确保值是 2 的幂次(1, 2, 4, 8…)。否则 .ToString()Enum.ToString() 无法正确解析组合值。

中小企业网站系统前台源码(SmallBusinessStarterKit)
中小企业网站系统前台源码(SmallBusinessStarterKit)

小型企业入门套件(The Small Business Starter Kit)提供了一个商业宣传网站的完整演示,他适合中小型企业。使用他创建的网站支持自定义模板,具有先进的功能,包括:内容和数据管理的SQL和XML数据源整合。该源码包含C#和VB两个版本,只有前台部分源码,微软官方截止到51aspx发布源码时还没有提供后台代码。小型企业网站入门套件的关键页面包括:产品分类显示新闻发布显示商户认证

下载
  • 未加 [Flags] 时,Permission.Read | Permission.Write 的结果调用 .ToString() 会输出数字(如 "3"),而非 "Read, Write"
  • 每个成员值必须唯一且为 2 的幂;可使用十六进制(0x10)或左移(1 )提升可读性
  • 判断是否包含某标志用 HasFlag(.NET Core 2.0+ 推荐用 (value & flag) == flag,性能更好)
[Flags]
public enum Permission
{
    None = 0,
    Read = 1,
    Write = 2,
    Execute = 4,
    All = Read | Write | Execute
}

Permission userPerm = Permission.Read | Permission.Write; Console.WriteLine(userPerm); // 输出 "Read, Write"

序列化与反序列化注意事项

JSON 序列化(如 System.Text.Json 或 Newtonsoft.Json)默认按枚举数值序列化,不是名称。这容易引发前后端协作问题:前端看到数字 1,却不知道对应哪个状态。

  • System.Text.Json:用 JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter()) 改为字符串序列化
  • Newtonsoft.Json:全局设置 JsonConvert.DefaultSettings = () => new JsonSerializerSettings { Converters = { new StringEnumConverter() } };
  • 数据库存储建议存字符串(提高可读性、避免迁移风险),若存整数,务必确保枚举定义稳定——增删成员或改顺序会导致历史数据含义错乱
  • ASP.NET Core API 默认用 System.Text.Json,不加转换器时,enum 字段响应体是数字,前端需硬编码映射,非常脆弱

枚举本身轻量,但它的语义边界一旦被跨层(如 DB → DTO → UI)模糊处理,就容易变成隐性 bug 温床。最稳妥的做法是:定义即冻结、传输即字符串、日志即名称、数据库字段加注释说明取值含义。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

419

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

535

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

311

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

77

2025.09.10

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

443

2023.08.02

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1501

2023.10.24

mysql标识符无效错误怎么解决
mysql标识符无效错误怎么解决

mysql标识符无效错误的解决办法:1、检查标识符是否被其他表或数据库使用;2、检查标识符是否包含特殊字符;3、使用引号包裹标识符;4、使用反引号包裹标识符;5、检查MySQL的配置文件等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

183

2023.12.04

Python标识符有哪些
Python标识符有哪些

Python标识符有变量标识符、函数标识符、类标识符、模块标识符、下划线开头的标识符、双下划线开头、双下划线结尾的标识符、整型标识符、浮点型标识符等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

287

2024.02.23

俄罗斯Yandex引擎入口
俄罗斯Yandex引擎入口

2026年俄罗斯Yandex搜索引擎最新入口汇总,涵盖免登录、多语言支持、无广告视频播放及本地化服务等核心功能。阅读专题下面的文章了解更多详细内容。

158

2026.01.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.6万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号