{"title":"KeyRef.FieldCount() Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/keyref/keyref-fieldcount-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/keyref/keyref-fieldcount-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/keyref/keyref-fieldcount-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 number of fields that have been defined in a key.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Syntax","slug":"syntax","at":159,"chars":114},{"level":2,"title":"Parameters","slug":"parameters","at":273,"chars":91},{"level":2,"title":"Return Value","slug":"return-value","at":364,"chars":110},{"level":2,"title":"Example","slug":"example","at":474,"chars":726},{"level":2,"title":"Related information","slug":"related-information","at":1200,"chars":134}],"text":"> Version: _Available or changed with runtime version 1.0._\nGets the number of fields that have been defined in a key. Returns an error if no key is selected.\n## Syntax\n```al\nNo :=   KeyRef.FieldCount()\n```\n> NOTE\n> This method can be invoked using property access syntax.\n## Parameters\nKeyRef\nType: keyref-data-type\nAn instance of the keyref-data-type data type.\n## Return Value\nNo\nType: ../integer/integer-data-type\nThe number of fields that have been defined in the key.\n## Example\nThe following example retrieves the number of fields that are defined in a key in record. The table with ID 18 \\(the Customer table\\) is open with a reference to table 18. The KeyIndex Method \\(RecordRef\\)<../library> method retrieves the second key in the record and store the KeyRef in the varKeyRef variable. The FieldCount Method \\(KeyREF\\)<../library> is then used to return the number of fields defined in the key and displayed in a message box.\n```al\nvar\n    RecRef: RecordRef;\n    varKeyRef: KeyRef;\n    VarCount: Integer;\nbegin\n    RecRef.Open(18);\n    varKeyRef := RecRef.KeyIndex(2);\n    VarCount := varKeyRef.FieldCount;\n    Message('The number of fields defined in the key is: %1', VarCount);\nend;\n```\n## Related information\nkeyref-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}