We have moved!

You are currently looking at documentation for Umbraco 8 and older versions.
An automated guess is that docs.umbraco.com/umbraco-cms/reference/management/services/textservice/ could be the link to the new documentation for Umbraco 9 and newer versions.

    TextService

    The TextService is the entry point to localize any key in the text storage source for a given culture.

    Browse the API documentation for ILocalizedTextService interface.

    • Namespace: Umbraco.Core.Services
    • Assembly: Umbraco.Core.dll

    All samples in this document will require references to the following dll:

    • Umbraco.Core.dll

    All samples in this document will require the following using statements:

    using Umbraco.Core;
    using Umbraco.Core.Models;
    using Umbraco.Core.Services;
    

    Getting the service

    Services property

    If you wish to use the text service in a class that inherits from one of the Umbraco base classes (eg. SurfaceController, UmbracoApiController or UmbracoAuthorizedApiController), you can access the text service through a local Services property:

    ILocalizedTextService localizedTextService = Services.TextService;
    

    Dependency Injection

    In other cases, you may be able to use Dependency Injection. For instance if you have registered your own class in Umbraco's dependency injection, you can specify the ILocalizedTextService interface in your constructor:

    public class MyClass
    {
    
        private ILocalizedTextService _textService;
    
    	public MyClass(ILocalizedTextService textService)
    	{
    		_textService = textService;
    	}
    
    }
    

    Static accessor

    If neither a Services property or Dependency Injection is available, you can also reference the static Current class directly:

    ILocalizedTextService textService = Umbraco.Core.Composing.Current.Services.TextService;