Check out the latest documentation.

What's Covered

This tutorial illustrates how to create a 51Degrees device detection dataset with a custom caching configuration.

Code and Explanation

Find profiles example of using 51Degrees device detection. The example shows how to:

  1. Use the DataSetBuilder to create a 51Degrees data set that will use a custom caching configuration.

    												
    string fileName = args[0];
    DataSet dataSet = DataSetBuilder.File()                
                    .ConfigureCachesFromTemplate(
                        DataSetBuilder.CacheTemplate.SingleThreadLowMemory)
                    .SetCacheBuilder(CacheType.SignaturesCache, new CustomCacheBuilder())
                    .SetCacheBuilder(CacheType.ProfilesCache, null)
                    .SetTempFile(false)
                    .Build(fileName)
    
    												

This tutorial assumes you are building this from within the 51Degrees Visual Studio solution. Running the executable produced inside Visual Studio will ensure all the command line arguments are preset correctly. If you are running outside of Visual Studio, make sure to add the path to a 51Degrees data file as an argument.

Full Source File
											
        public static void Run(string fileName)
        {
            // DataSet is the object used to interact with the data file.
            // DataSetBuilder creates a DataSet with a pool of binary 
            // readers to perform device lookup using file on disk.
            // The type is disposable and is therefore contained in using 
            // block to ensure file handles and resources are freed.
            using (DataSet dataSet = DataSetBuilder.File()
                // First, the SingleThreadLowMemory configuration template
                // is specified in order to provide initial values for the 
                // cache settings.
                .ConfigureCachesFromTemplate(
                    DataSetBuilder.CacheTemplate.SingleThreadLowMemory)
                // A custom cache implementation is specified to store signatures.
                .SetCacheBuilder(CacheType.SignaturesCache, new CustomCacheBuilder())
                // A null cache is specified for profiles in order to reduce
                // memory usage. This means that profiles will always be
                // loaded from disk when needed.
                .SetCacheBuilder(CacheType.ProfilesCache, null)
                .SetTempFile(false)
                .Build(fileName))
            {
                // Create a provider using the dataset.
                // The provider handles the process of finding a match
                // in the dataset for a given user agent.
                using (Provider provider = new Provider(dataSet))
                {
                    Console.WriteLine("Staring Caching Configuration Example.");

                    // Used to store and access detection results.
                    Match match;

                    // Contains detection result for the IsMobile property.
                    string IsMobile;

                    // User-Agent string of an iPhone mobile device.
                    string mobileUserAgent = ("Mozilla/5.0 (iPhone; CPU iPhone " +
                        "OS 7_1 like Mac OS X) AppleWebKit/537.51.2 (KHTML, like " +
                        "Gecko) 'Version/7.0 Mobile/11D167 Safari/9537.53");

                    // Get a match object and display the IsMobile property
                    match = provider.Match(mobileUserAgent);
                    IsMobile = match["IsMobile"].ToString();
                    Console.WriteLine("   IsMobile: " + IsMobile);
                }
            }
        }


											
Full Source File

Summary

In this tutorial you have seen how to use DataSetBuilder to create a dataset with a custom cache configuration.

The example uses the .NET MemoryCache but the same principle could be applied to any 3rd party cache implementation.

The 51 Degrees API has been tested extensively to determine the best caching strategies and parameters for a wide range of environments and use cases. Care should be taken when using a custom configuration to ensure that performance is not degraded unintentionally.