IDScan.net

    Show / Hide Table of Contents

    ID Parsing Library for .NET

    DL/ID Parsing Library

    DL/ID cards are widely used for storing personal information such as first name, last name, birth date, address, etc. They also contain special information related to driving activity including DL number, class and restrictions. Because of the utility of this data, there is a high demand for systems that can scan and process DL/ID information.

    As a solution, IDScan.net developed a DL/ID Parsing library for multiple development environments. The whole list can be found on our download page. We collected 10+ years of ID formats from the US, Canada, and many other countries and tested each one to ensure every DL/ID card is parsed with precision.

    Implementation Instructions Using Microsoft Visual Studio

    for .NET languages

    1. Download dlplib from the link below and extract files.
    2. With your project open, go to Project -> Add Reference and browse path to dlplib.dll.

    SC1 SC2

    Example projects can found below or on our SDK downloads here

    .NET ID Parsing Library – Download

    C# Example Project for SDK Lite (Hardware ID and Registration Key) – Download

    VB.NET Example Project for SDK Lite (Hardware ID and Registration Key) – Download

    .NET Library Properties, Methods, Events

    DriverLicense Class

    Object that enables access to parsed information from an ID.

    Constructors

    Name Description
    DriverLicense() Initializes an instance of the DriverLicense class

    Fields

    Field Name Description
    Address1 First line of address of cardholder
    Address2 Second line of address of cardholder
    Birthdate Birth date of cardholder
    CardRevisionDate DHS required field that indicates date of the most recent version change or modification to the visible format of the DL/ID (MMDDCCYY for U.S., CCYYMMDD for Canada)
    City City of cardholder address
    ClassificationCode Driver License classification code as defined by Federal Highway regulations and by AAMVA; others are defined by DL Classification Code Standards
    ComplianceType DHS required field that indicates compliance:“M” = materially compliant; “F” = fully compliant; and, “N” = non-compliant.
    ComputerID Hardware ID
    Country Country of cardholder
    DocumentType Can be a driver’s license or ID ID – Identity Card DL – Driver License CC – Bank Card HC – Health Card TD – Machine Readable Travel Document CAC – Department of Defense and Common Access Card
    Document Discriminator Number must uniquely identify a particular document issued to that customer from others that may have been issued in the past. This number may serve multiple purposes of document discrimination, audit information number, and/or inventory control.
    EndorsementCodeDescription Description of Endorsements Code
    EndorsementsCode Any endorsements on a driver's license which authorize the operation of specified types of vehicles or the operation of vehicles carrying specified loads. Endorsements shall be specific to classification of a driver's license.
    ExpirationDate Date on which the driving and identification privileges granted by the document are no longer valid (MMDDCCYY for U.S.)
    EyeColor Color of cardholder’s eyes, as defined in ANSI D-20 codes
    FirstName First name of cardholder
    FullName Full name of cardholder
    Gender Gender of cardholder
    HairColor Hair color of cardholder. Brown, black, blonde, gray, red/auburn, sandy, white
    HAZMATExpDate Date on which the hazardous material endorsement granted by the document is no longer valid. (MMDDCCYY for U.S., CCYYMMDD for Canada)
    Height Height of cardholder, followed by “in” or “cm”
    IIN Issuer Identification Number – the full 6-digit IIN should be encoded
    IssueDate Issue date of DL/ID
    IssuedBy Code of the country or a state where the document was issued
    JurisdictionCode State of cardholder address
    LastName Last name of cardholder
    LicenseNumber License number of cardholder
    LimitedDurationDocument DHS required field that indicates that the cardholder has temporary lawful status = “1”
    MiddleName Middle Name of card holder
    NamePrefix NamePrefix of cardholder
    NameSuffix NameSuffix of cardholder
    OrganDonor Organ Donor
    PostalCode Postal code of cardholder address, if unknown, zeroes will be used
    Race Race or ethnicity of cardholder as defined in ANSI D20
    RealId This document is real ID
    RestrictionCode Jurisdiction-specific codes that represent restrictions to driving privileges (such as airbrakes, automatic transmission, daylight only,etc.)
    RestrictionCodeDescription Description of RestrictionCode
    Specification Standard of scanned document
    VehicleClassCode Jurisdiction-specific vehicle class / group code, designating the type of vehicle the cardholder has privilege to drive.
    VehicleClassCodeDescription Description of VehicleClassCode
    Veteran Field that indicates that the cardholder is a veteran
    WeightKG Physical weight or weight range in KG ex. 77 up to 31 32 – 45 46 – 59
    WeightLBS Physical weight or weight range in pounds ex. 138 up to 70 71 – 100 101 – 130

    DriverLicenseEx Class

    This class is similar to DriverLicense but also provides support for data types such as date, boolean, string, etc and does not contain an ExtractInfo() method.

    Name Description
    DriverLicenseEx() Initializes an instance of the DriverLicenseEx class

    Fields are the same as DriverLicense.

    Methods

    Method Name Description Return Value
    ParseText(System.String) Parses scanned text of ID. Returns a DriverLicense object on success and null on error
    ParseText(System.String, [System.String = ""]) Parses scanned text of ID. The first parameter is a string to parse. The second optional parameter is the folder where the license file is located Returns a DriverLicense object on success and null on error
    Back to top IDScan.net