Raw Property Name Support — Test Design

OpenAPI property names containing snake_case, kebab-case, or spaces are sanitized into valid C# identifiers by removing invalid characters and applying specific formatting rules. This prevents compile-time errors while preserving the original JSON serialization mappings.

OpenAPI reserved keywords are handled during C# code generation by escaping them with the @ prefix, such as @class or @event. This ensures the generated code compiles correctly while accurately tracking the original property name for JSON deserialization.

Generated C# clients fail to deserialize JSON when raw OpenAPI property names are not properly mapped to valid C# identifiers. Sanitizing invalid characters and escaping keywords ensures the generated code preserves the correct JSON mappings needed for successful deserialization.

The best way to sanitize invalid characters in OpenAPI property names for C# is to apply identifier sanitization rules that strip or replace unsupported characters while preserving valid original names. Escaping reserved keywords with @ is also enforced to guarantee compilation.

OpenAPI code generation preserves valid C# identifier names whenever possible during the conversion process. If the original property name is already a valid identifier, it remains unchanged to maintain consistency between the OpenAPI spec and the generated C# code.