Check out the latest documentation.

What's Covered

51Degrees device detector returns all detection results as a string. This tutorial demonstrates how to return results for the IsMobile property value as a boolean.

Code and Explanation

Strongly typed example of using 51Degrees device detection. The example shows how to:

  1. Set the data set for the 51Degrees detector

    												
    string fileName = args[0];
    DataSet dataSet = StreamFactory.Create(fileName, false);
    
    												

  • Instantiate the 51Degrees device detection provider with these settings

    									
    Provider provider = new Provider(dataSet);
    
    									
  • Produce a match for a single HTTP User-Agent

    									
    match = provider.Match(userAgent);
    
    									
  • Extract the boolean value of the IsMobile property

    									
    if (match["IsMobile"] == "True")
        return true;
    else
        return false;
    
    									
    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.
                // StreamFactory creates Dataset with pool of binary readers to 
                // perform device lookup using file on disk.
                DataSet dataSet = StreamFactory.Create(fileName, false);
    
                // Provides access to device detection functions.
                Provider provider = new Provider(dataSet);
    
                // Used to store and access detection results.
                Match match;
    
                // Contains boolean detection result for the IsMobile property.
                bool IsMobileBool;
    
                // 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");
    
                // User-Agent string of Firefox Web browser version 41 on desktop.
                string desktopUserAgent = ("Mozilla/5.0 (Windows NT 6.3; " +
                    "WOW64; rv:41.0) Gecko/20100101 Firefox/41.0");
    
                // User-Agent string of a MediaHub device.
                string mediaHubUserAgent = ("Mozilla/5.0 (Linux; Android " +
                    "4.4.2; X7 Quad Core Build/KOT49H) AppleWebKit/537.36 " +
                    "(KHTML, like Gecko) Version/4.0 Chrome/30.0.0.0 " +
                    "Safari/537.36");
    
                Console.WriteLine("Starting Strongly Typed Example.");
    
                // Carries out a match for a mobile User-Agent.
                Console.WriteLine("\nMobile User-Agent: " + mobileUserAgent);
                match = provider.Match(mobileUserAgent);
                IsMobileBool = getIsMobileBool(match);
                if (IsMobileBool) 
                {
                    Console.WriteLine("   Mobile");
                }
                else
                {
                    Console.WriteLine("   Non-Mobile");
                }
    
                // Carries out a match for a desktop User-Agent.
                Console.WriteLine("\nDesktop User-Agent: " + desktopUserAgent);
                match = provider.Match(desktopUserAgent);
                IsMobileBool = getIsMobileBool(match);
                if (IsMobileBool)
                {
                    Console.WriteLine("   Mobile");
                }
                else
                {
                    Console.WriteLine("   Non-Mobile");
                }
    
                // Carries out a match for a MediaHub User-Agent.
                Console.WriteLine("\nMediaHub User-Agent: " + mediaHubUserAgent);
                match = provider.Match(mediaHubUserAgent);
                IsMobileBool = getIsMobileBool(match);
                if (IsMobileBool) {
                    Console.WriteLine("   Mobile");
                }
                else
                {
                    Console.WriteLine("   Non-Mobile");
                }
    
                // Finally close the dataset, releasing resources and file locks.
                dataSet.Dispose();
            }
    
            /// <summary>
            /// Returns a boolean representation of the value associated with the 
            /// IsMobile property.
            /// </summary>
            /// <param name="match">a Match object</param>
            /// <returns>
            /// A boolean representation of the value for IsMobile
            /// </returns>        
            public static bool getIsMobileBool(Match match)
            {
                if (match["IsMobile"].ToString() == "True")
                    return true;
                else
                    return false;
            }
    
    
    
    												
    Full Source File

  • Summary

    In this tutorial you have seen how to use the detector to retrieve the IsMobile property for a pre-defined User-Agent string. It sets a boolean value to true or false from the original string value of "True" or "False", making if statements simpler to test.