{"record":{"id":"61e938d7ab38d12a","repo":"JamesNK/Newtonsoft.Json","slug":"can-not-convert-0-to-byte","errorCode":null,"errorMessage":"Can not convert {0} to Byte.","messagePattern":"Can not convert (.+?) to Byte\\.","errorType":"exception","errorClass":"ArgumentException","httpStatus":null,"severity":"error","filePath":"Src/Newtonsoft.Json/Linq/JToken.cs","lineNumber":909,"sourceCode":"            {\n                return (char)integer;\n            }\n#endif\n\n            return Convert.ToChar(v.Value, CultureInfo.InvariantCulture);\n        }\n\n        /// <summary>\n        /// Performs an explicit conversion from <see cref=\"JToken\"/> to <see cref=\"Byte\"/>.\n        /// </summary>\n        /// <param name=\"value\">The value.</param>\n        /// <returns>The result of the conversion.</returns>\n        public static explicit operator byte(JToken value)\n        {\n            JValue? v = EnsureValue(value);\n            if (v == null || !ValidateToken(v, NumberTypes, false))\n            {\n                throw new ArgumentException(\"Can not convert {0} to Byte.\".FormatWith(CultureInfo.InvariantCulture, GetType(value)));\n            }\n\n#if HAVE_BIG_INTEGER\n            if (v.Value is BigInteger integer)\n            {\n                return (byte)integer;\n            }\n#endif\n\n            return Convert.ToByte(v.Value, CultureInfo.InvariantCulture);\n        }\n\n        /// <summary>\n        /// Performs an explicit conversion from <see cref=\"Newtonsoft.Json.Linq.JToken\"/> to <see cref=\"System.SByte\"/>.\n        /// </summary>\n        /// <param name=\"value\">The value.</param>\n        /// <returns>The result of the conversion.</returns>\n        [CLSCompliant(false)]","sourceCodeStart":891,"sourceCodeEnd":927,"githubUrl":"https://github.com/JamesNK/Newtonsoft.Json/blob/4f73e74372445108d2c1bda37b36e6f5e43402e0/Src/Newtonsoft.Json/Linq/JToken.cs#L891-L927","documentation":"Thrown by the explicit (non-nullable) cast operator byte(JToken) at JToken.cs:909. The token type must be in NumberTypes = {Integer, Float, String, Comment, Raw, Boolean}. A JSON null, a Date/Guid/Uri/Bytes value, or a container (JObject/JArray) fails this ArgumentException. Out-of-range/negative values fail later with OverflowException.","triggerScenarios":"Casting a JSON null JValue to (byte)token; casting a Date/Object/Array/Guid to byte; an omitted byte field parsed as null.","commonSituations":"A byte field (e.g. a small flag or channel) that came back null or as an object; reading a Date value as a byte.","solutions":["Use the nullable cast (byte?)token and coalesce: ((byte?)token) ?? (byte)0.","Guard with token.Type == JTokenType.Integer before the cast.","Use token.Value<byte?>() to tolerate null/missing.","Deserialize into a nullable byte POCO property."],"exampleFix":"// before\nbyte channel = (byte)token[\"channel\"]; // throws when channel is null\n\n// after\nbyte channel = (byte?)token[\"channel\"] ?? (byte)0;","handlingStrategy":"type-guard","validationCode":"// Verify the token is a number-compatible scalar before the non-nullable byte cast\nstatic bool CanToByte(JToken? t) =>\n    t is JValue v && (v.Type == JTokenType.Integer || v.Type == JTokenType.Float\n                      || v.Type == JTokenType.String || v.Type == JTokenType.Boolean);","typeGuard":"static byte? SafeByte(JToken? t) => t switch {\n    JValue v when v.Type is JTokenType.Integer or JTokenType.Float\n                       or JTokenType.String or JTokenType.Boolean => (byte?)t,\n    JValue v when v.Type is JTokenType.Null or JTokenType.Undefined => null,\n    _ => null\n};","tryCatchPattern":"try\n{\n    byte b = (byte)token;\n}\ncatch (ArgumentException ex) when (ex.Message.StartsWith(\"Can not convert\"))\n{\n    // token is null/container/date; default to 0\n}","preventionTips":["Use the nullable cast (byte?)token for fields that may be JSON null.","Check token.Type is Integer/Float before the non-nullable byte cast.","Prefer token.Value<byte?>() which tolerates missing/null.","Deserialize into a nullable byte POCO property."],"tags":["linq-to-json","jtoken","cast","byte","argumentexception"],"analyzedSha":"4f73e74372445108d2c1bda37b36e6f5e43402e0","analyzedAt":"2026-08-07T06:10:08.596Z","schemaVersion":2},"datasetVersion":"2026-08-07T07:17:06.508Z"}