{"title":"TextBuilder.Replace(Text, Text, Integer, Integer) Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/textbuilder/textbuilder-replace-text-text-integer-integer-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/textbuilder/textbuilder-replace-text-text-integer-integer-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/textbuilder/textbuilder-replace-text-text-integer-integer-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":"Replaces, within a substring of this instance, all occurrences of a specified string in this TextBuilder instance with another specified string.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Syntax","slug":"syntax","at":205,"chars":117},{"level":2,"title":"Parameters","slug":"parameters","at":322,"chars":423},{"level":2,"title":"Return Value","slug":"return-value","at":745,"chars":274},{"level":2,"title":"Related information","slug":"related-information","at":1019,"chars":139}],"text":"> Version: _Available or changed with runtime version 1.0._\nReplaces, within a substring of this instance, all occurrences of a specified string in this TextBuilder instance with another specified string.\n## Syntax\n```al\n[Ok := ]  TextBuilder.Replace(OldText: Text, NewText: Text, StartIndex: Integer, Count: Integer)\n```\n## Parameters\nTextBuilder\nType: textbuilder-data-type\nAn instance of the textbuilder-data-type data type.\nOldText\nType: ../text/text-data-type\nThe string to replace.\nNewText\nType: ../text/text-data-type\nThe string that replaces OldText.\nStartIndex\nType: ../integer/integer-data-type\nThe position in this TextBuilder instance where the substring begins.\nCount\nType: ../integer/integer-data-type\nThe length of the substring.\n## Return Value\n*[Optional] Ok*\nType: ../boolean/boolean-data-type\ntrue if all occurrences of a specified string were successfully replaced, otherwise false. If you omit this optional return value and the operation does not execute successfully, a runtime error will occur.\n## Related information\ntextbuilder-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}