Working with enums in C# is often associated with lists of exclusive values, but when a variable must represent the combination of multiple states at once, such as user permissions, file access modes, or interface options, the [Flags] attribute becomes essential.
What is [Flags] in C# The [Flags] attribute applied to an enum indicates that this enum should be treated as a bit field, that is, as a set of flags that can be combined using bitwise operations. A normal enum usually represents a single value, while an enum with [Flags] can store multiple active values in a single variable.
Defining an enum with [Flags] When defining an enum for flags, each value must be a power of 2: 1, 2, 4, 8, 16, etc. Practical example in a single line: [Flags] public enum FileAccess { None = 0, Read = 1, Write = 2, Execute = 4, ReadWrite = Read | Write, All = Read | Write | Execute }
Combining flags You can combine values using the bitwise OR operator with the vertical bar. Example: FileAccess access = FileAccess.Read | FileAccess.Write; Console.WriteLine(access); this will display Read, Write when the enum has the [Flags] attribute.
Checking if a flag is set To check if a flag is active, the bitwise AND operator is used. Examples: bool canRead = (access & FileAccess.Read) == FileAccess.Read; bool canExec = (access & FileAccess.Execute) == FileAccess.Execute. The use of & in HTML represents the bitwise AND operation.
Why use [Flags] instead of a normal enum The combination logic with OR and checking with AND works even if you do not mark the enum with [Flags], but ToString will return the raw number instead of readable names. With [Flags] the output is more expressive, for example Read, Write instead of 3.
Real example: user permissions A common use of [Flags] is to manage permissions in an application. Example: [Flags] public enum UserPermissions { None = 0, ViewDashboard = 1, EditUsers = 2, ManageProducts = 4, AccessReports = 8, All = ViewDashboard | EditUsers | ManageProducts | AccessReports } Then permissions are assigned by combining values and checked with AND as in previous examples.
Filtering users by permission In lists or queries it is easy to select users who have a specific flag: var reportUsers = users.Where(u => (u.Permissions & UserPermissions.AccessReports) == UserPermissions.AccessReports); This allows efficient filtering when permissions are stored as integers.
Best practices with [Flags] Use powers of 2 for each flag. Always define None = 0. Avoid overlapping values that break checks. Use [Flags] only when it makes sense to combine multiple values. Document predefined combinations like All or ReadWrite to improve clarity.
Storage and performance Enums marked with [Flags] can be stored as integers in databases, making them efficient in space and querying. By indexing an integer field, it is easy to filter and combine conditions in SQL or in LINQ queries against persisted entities.
Common errors to avoid Do not use arbitrary numbers that are not powers of 2. Do not rely on ToString for critical logic without checking the [Flags] attribute. Avoid confusing bitwise OR with arithmetic addition. Keep in mind that enums marked with [Flags] are still integer types underneath, so conversions must be handled carefully.
Conclusion The [Flags] attribute in C# is a powerful tool for representing multiple options in a single variable, improves readability, and simplifies the management of combinations of states or permissions. It is also practical for storing configurations in databases as integer values and for efficient queries.
About Q2BSTUDIO Q2BSTUDIO is a software development company that creates custom applications and custom software solutions. We specialize in artificial intelligence, AI for businesses, AI agents, cybersecurity, AWS and Azure cloud services, and business intelligence services. We offer Power BI integration for advanced analytics and reporting, develop custom AI agents, and provide consulting in security and cloud architecture. Our experience in AI, cybersecurity, and cloud services allows us to design robust, scalable, and secure solutions tailored to each client's needs.
How Q2BSTUDIO can help you apply [Flags] in your projects We can implement patterns like enums with [Flags] in microservices architectures, APIs, and databases, optimizing the storage of permissions and configurations. Additionally, we integrate artificial intelligence capabilities to automate permission decisions, apply security monitoring, and generate Power BI dashboards that extract relevant information from these combined states.
Keywords for positioning custom applications, custom software, artificial intelligence, cybersecurity, AWS and Azure cloud services, business intelligence services, AI for businesses, AI agents, Power BI.
Contact If you need a custom solution that includes advanced permission management, cloud integration, business intelligence, or AI agents, Q2BSTUDIO can help you design and implement the right solution.
Author Explanation adapted and translated to facilitate practical understanding of the [Flags] attribute and its application in real projects.
