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/contentservice/ could be the link to the new documentation for Umbraco 9 and newer versions.

    ContentService

    The ContentService acts as a "gateway" to Umbraco data for operations which are related to Content.

    Browse the v8 API documentation for ContentService.

    • 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 content service in a class that inherits from one of the Umbraco base classes (eg. SurfaceController, UmbracoApiController or UmbracoAuthorizedApiController), you can access the content service through a local Services property:

    IContentService contentService = Services.ContentService;
    

    The Services property is also available in the Razor veiw inheriting from UmbracoViewPage.

    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 IContentService interface in your constructor:

    public class MyClass
    {
    
        private readonly IContentService _contentService;
        
        public MyClass(IContentService contentService)
        {
            _contentService = contentService;
        }
    
    }
    

    Static accessor

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

    IContentService contentService = Umbraco.Core.Composing.Current.Services.ContentService;
    

    Samples