{"title":"FieldRef.Length() Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/fieldref/fieldref-length-method/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/fieldref/fieldref-length-method, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/fieldref/fieldref-length-method","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Gets the maximum size of the field (the size specified in the DataLength property of the field).","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Syntax","slug":"syntax","at":241,"chars":116},{"level":2,"title":"Parameters","slug":"parameters","at":357,"chars":97},{"level":2,"title":"Return Value","slug":"return-value","at":454,"chars":58},{"level":2,"title":"Remarks","slug":"remarks","at":512,"chars":174},{"level":2,"title":"Example","slug":"example","at":686,"chars":777},{"level":2,"title":"Related information","slug":"related-information","at":1463,"chars":136}],"text":"> Version: _Available or changed with runtime version 1.0._\nGets the maximum size of the field (the size specified in the DataLength property of the field). This method is usually used for finding the defined length of code and text fields.\n## Syntax\n```al\nLength :=   FieldRef.Length()\n```\n> NOTE\n> This method can be invoked using property access syntax.\n## Parameters\nFieldRef\nType: fieldref-data-type\nAn instance of the fieldref-data-type data type.\n## Return Value\nLength\nType: ../integer/integer-data-type\n## Remarks\nFor Text and Code fields this method returns the defined length. For other types of fields, it returns the fixed byte size, for example, Integer fields returns 4.\n## Example\nThe following example opens the Customer table as a RecordRef variable. The ../recordref/recordref-field-method creates a FieldRef for any specified field and stores the reference in the MyFieldRef variable. The LENGTH method retrieves the maximum size of the field and stores the value in the varLength variable. The value that is stored in the varLength is displayed in a message box.\n```al\nvar\n    MyFieldRef: FieldRef;\n    CustomerRecref: RecordRef;\n    varLength: Integer;\n    varFieldNo: Integer;\n    Text000: Label 'The maximum size of the field is %1.';\nbegin\n    varFieldNo := 1;\n    CustomerRecref.Open(Database::Customer);\n    MyFieldRef := CustomerRecref.Field(varFieldNo);\n    varLength := MyFieldRef.Length();\n    Message(Text000, varLength);\nend;\n```\n## Related information\nfieldref-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}