.NET Component User Manual
Contents
1. AD ANDORRA AE UNITED ARAB EMIRATES AF AFGHANISTAN AG ANTIGUA AND BARBUDA AI ANGUILLA AL ALBANIA AM ARMENIA AO ANGOLA AQ ANTARCTICA AR ARGENTINA AS AMERICAN SAMOA AT AUSTRIA AU AUSTRALIA AW ARUBA AX ALAND ISLANDS AZ AZERBAIJAN BA BOSNIA AND HERZEGOWINA BB BARBADOS BD BANGLADESH BE BELGIUM BF BURKINA FASO BG BULGARIA BH BAHRAIN BI BURUNDI BJ BENIN BL SAINT BARTH LEMY BM BERMUDA BN BRUNEI DARUSSALAM BO BOLIVIA BQ BONAIRE SINT EUSTATIUS AND SABA BR BRAZIL BS BAHAMAS BT BHUTAN BV BOUVET ISLAND BW BOTSWANA BY BELARUS BZ BELIZE CA CANADA CC COCOS KEELING ISLANDS CD CONGO THE DEMOCRATIC REPUBLIC OF THE CF CENTRAL AFRICAN REPUBLIC CG CONGO Country Code Country Name CH SWITZERLAND CI C TE D IVOIRE CK COOK ISLANDS CL CHILE CM CAMEROON CN CHINA CO COLOMBIA CR COSTA RICA CU CUBA CV CAPE VERDE CW CURACAO CX CHRISTMAS ISLAND CY CYPRUS CZ CZECH REPUBLIC DE GERMANY DJ DJIBOUTI DK DENMARK DM DOMINICA DO DOMINICAN REPUBLIC DZ ALGERIA EC ECUADOR EE ESTONIA EG EGYPT EH WESTERN SAHARA ER ERITREA ES SPAIN ET ETHIOPIA FI FINLAND FJ FIJI FK FALKLAND ISLANDS MALVINAS FM MICRONESIA FEDERATED STATES OF FO FAROE ISLAND2. Minimum Requirements Supported Platforms Framework 4 0 or later Microsoft Windows XP Home or Professional Microsoft Windows Server 2003 family Microsoft Windows Vista Microsoft Windows 7 Microsoft Windows 8 Microsoft Windows Server 2008 family Microsoft Windows Server 2012 family Quick Start Guide In this document you will go through these basic steps to use IP2Location NET component Download and installing IP2Location NET Component Test your NET Component installation Start using IP2Location in your projects Purchase license to remove random 5 second delay in demo version Update IP2Location Component database NN Note For demo version you will have a random 5 second delay Registered version has unlimited real time query without delay 1 DOWNLOAD AND INSTALLING IP2LOCATION NET COMPONENT 1 1 Download ZIP File Please use the following URL to download the latest IP2Location NET Component together with sample database http www ip2location com downloads ip2location dot net component dotnet4 zip 1 2 Component Installation Installing the IP2Location NET component system is very easy General steps in installing IP2Location component Unzip the ip2location dot net component dotnet4 zip into a temporary directory Just copy the IP2Location dll file into your bin folder of your NET project In your NET project add a reference to that IP2Lo
3. Reference Object IP2Location Component Parameter Description IPDatabasePath Set IP2Location IPv4 database path The component will use the database in the component directory by default IPLicensePath Set license file path for component registration The component will use the license key in the component directory by default UseMemoryMappedFile Method IPQuery ByVal IPAddress As String Set to True to enable memory mapped file feature This will increase query speed but require more memory It is set to False by default Description Query IP address This method returns results in IP2Location IPResult object IsRegistered Returns True if license key registered Returns False if license key not registered Object IP2Location IPResult Parameter Description IPAddress IP Address IPNumber IP Address in decimal format CountryShort Two character country code based on ISO 3166 CountryLong Country name based on ISO 3166 Region Region or state name City City name Latitude City latitude Longitude City longitude ZIPCode United States ZIP code TimeZone Time zone in UTC Coordinated Universal Time InternetServiceProvider Internet Service Provider ISP name DomainName Internet domain name associated to IP address range NetSpeed Internet Connection Speed DIAL DIAL UP DSL DSL CABLE or COMP COMPANY IDDCod
4. for each machine the product is installed on including development or staging machines Please refer to the end of this document for the complete license agreement 4 2 Purchase Instruction Proceed to our order page Fill out the online form and choose the correct number of licenses Once your order has been approved you will receive your license file License Key immediately through email Save the license file to the same directory of IP2Location dll in WinForm or bin directory for WebForm the remove the random 5 second query delay Please visit http www ip2location com for online order 5 UPDATE COMPONENT DATABSE 5 1 Update Component Internal Database The IP2Location NET Component depends on an internal database for lookup purpose All users with valid license will be allowed to download the monthly updates from the IP2Location download area during subscription period To update users need to replace the BIN database with the latest one from the download area The component will use the latest database once the local copy has been updated Please refer to the welcome email for more information regarding download updates and account information APPENDIX I 1503166 COUNTRY CODE This table lists all valid ISO3166 two characters country codes that returns from IP2Location NET component and explain the full country names for these country codes
5. shall Hexasoft nor anyone else who has been involved in the creation production or delivery of the SOFTWARE PRODUCT be liable for any damages whatsoever including without limitation damages for loss of business profits business interruption loss of business information or any other pecuniary loss arising out of the use of or inability to use this Hexasoft product even if Hexasoft has been advised of the possibility of such damages Because some states and jurisdictions do not allow the exclusion or limitation of liability for consequential or incidental damages the above limitation may not apply to you MISCELLANEOUS IP2Location is a trademark of Hexasoft Development Sdn Bhd Microsoft is a registered trademark of Microsoft Corporation Windows is a registered trademark of Microsoft Corporation All other trademarks are the property of their respective owners Copyright 2014 Hexasoft Development Sdn Bhd All Rights Reserved Hexasoft Development Sdn Bhd 1 2 15 Mayang Mall Kompleks Jalan Mayang Pasir 1 11950 Bayan Baru Pulau Pinang Malaysia Tel 6 04 640 2380 Fax 6 04 640 2381 Email sales ip2location com
6. LIA MO MACAU MP NORTHERN MARIANA ISLANDS MQ MARTINIQUE MR MAURITANIA MS MONTSERRAT MT MALTA MAURITIUS MALDIVES MALAWI MEXICO MALAYSIA MOZAMBIQUE NAMIBIA NEW CALEDONIA NIGER NORFOLK ISLAND NIGERIA NICARAGUA NETHERLANDS NORWAY NEPAL NAURU NIVE NEW ZEALAND OMAN PANAMA PERU FRENCH POLYNESIA PAPUA NEW GUINEA PHILIPPINES PAKISTAN POLAND SAINT PIERRE AND MIQUELON PITCAIRN PUERTO RICO PALESTINIAN STATE OF PORTUGAL PALAU PARAGUAY QATAR REUNION ROMANIA SERBIA IP2LOCATIO RU RUSSIAN FEDERATION RW RWANDA SA SAUDI ARABIA SB SOLOMON ISLANDS SC SEYCHELLES SD SUDAN SE SWEDEN SG SINGAPORE SH SAINT HELENA ASCENSION AND TRISTAN DA CUNHA SI SLOVENIA SJ SVALBARD AND JAN MAYEN SK SLOVAKIA SL SIERRA LEONE SM SAN MARINO SN SENEGAL SO SOMALIA SR SURINAME SS SOUTH SUDAN ST SAO TOME AND PRINCIPE SV EL SALVADOR SX SINT MAARTEN DUTCH PART SY SYRIAN ARAB REPUBLIC SZ SWAZILAND TE TURKS AND CAICOS ISLANDS TD CHAD TF FRENCH SOUTHERN TERRITORIES TG TOGO TH THAILAND TJ TAJIKISTAN TK T
7. OKELAU TL TIMOR LESTE TM TURKMENISTAN TN TUNISIA TO TONGA TR TURKEY TT TRINIDAD AND TOBAGO TV TUVALU TW TAIWAN PROVINCE OF CHINA TZ TANZANIA UNITED REPUBLIC OF UA UKRAINE UG UGANDA UK UNITED KINGDOM UM UNITED STATES MINOR OUTLYING ISLANDS US UNITED STATES UY URUGUAY UZ UZBEKISTAN VA HOLY SEE VATICAN CITY STATE SAINT VINCENT AND THE GRENADINES VE VENEZUELA User Manual VG VIRGIN ISLANDS BRITISH VI VIRGIN ISLANDS U S VN VIET NAM VU VANUATU WE WALLIS AND FUTUNA WS SAMOA YE YEMEN XT MAYOTTE ZA SOUTH AFRICA ZW ZIMBABWE IPOLOCATION IP2LOCATION NET COMPONENT LICENSE AGREEMENT IMPORTANT READ CAREFULLY This License Agreement is a legal agreement between you either an individual or a single entity and Hexasoft Development Sdn Bhd owner of IP2Location trademark Hexasoft or we for the Hexasoft developed IP2Location Component hereafter referred to as the SOFTWARE PRODUCT accompanying this License Agreement which includes web service routines and data result s By exercising your rights to make and use copies of the SOFTWARE PRODUCT you agree to be bound by the terms of this License Agreement If you do not agree to the terms of this License Agreement you may not use the SOFTWARE PRODUCT GRANT OF LICENSE This License Agreement grants the following rights You are granted the righ
8. S FR FRANCE GA GABON GB GREAT BRITAIN GD GRENADA GE GEORGIA GF FRENCH GUIANA GG GUERNSEY GH GHANA GI GIBRALTAR GL GREENLAND GM GAMBIA GN GUINEA GP GUADELOUPE GQ EQUATORIAL GUINEA GR GREECE Country Code Country Name GS SOUTH GEORGIA amp SOUTH SANDWICH ISLANDS GT GUATEMALA GU GUAM GW GUINEA BISSAU GY GUYANA HK HONG KONG HM HEARD ISLAND AND MCDONALD ISLANDS HN HONDURAS HR CROATIA HT HAITI HU HUNGARY D INDONESIA IE IRELAND ISRAEL IM ISLE OF MAN N INDIA BRITISH INDIAN OCEAN TERRITORY Q IRAQ R IRAN ISLAMIC REPUBLIC OF S ICELAND TT ITALY JE JERSEY JM JAMAICA JO JORDAN JP JAPAN KE KENYA KG KYRGYZSTAN KH CAMBODIA KI KIRIBATI KM COMOROS KN SAINT KITTS AND NEVIS KP KOREA DEMOCRATIC PEOPLE S REPUBLIC OF KR KOREA REPUBLIC OF KW KUWAIT KY CAYMAN ISLANDS KZ KAZAKSTAN LA LAO PEOPLE S DEMOCRATIC REPUBLIC LB LEBANON LG SAINT LUCIA LI LIECHTENSTEIN LK SRI LANKA LR LIBERIA LS LESOTHO LT LITHUANIA LU LUXEMBOURG LV LATVIA LY LIBYA MA MOROCCO MC MONACO MD MOLDOVA REPUBLIC OF Country Code Country Name ME MONTENEGRO MF SAINT MARTIN FRENCH PART MG MADAGASCAR MH MARSHALL ISLANDS MK MACEDONIA THE FORMER YUGOSLAV ML MALI MM MYANMAR MN MONGO
9. cation dll in your bin folder There is a strong named version of the IP2Location dll in the Strongnamed folder if you need it M 2 TESTING IP2LOCATION NET COMPONENT 2 1 Folders and Files Structure The unzipped folder should look like below IP2Location dll ip2location dotnet4 0 component user manual pdf IP2LOCATION_LICENSE_AGREEMENT PDF Database IP2LOCATION LITE DB1 BIN Database IP2LOCATION LITE DB1 IPV6 BIN SampleCodes dotNET4 0 WebForm C SampleCodes dotNET4 0 WebForm VBnet SampleCodes dotNET4 0 WinForm C SampleCodes dotNET4 0 WinForm VBnet Strongnamed IP2Location dll 2 2 Component Testing using WinForm For desktop based sample applications please open the project or solution file to rebuild and execute the application Sample WinForm Written in VB NET SampleCodes dotNET4 0 WinForm VBnet Sample WinForm Written in C SampleCodes dotNET4 0 WinForm C 2 3 Component Testing using WebForm For web based sample applications please copy the sample to a web directory that has been configured to run web scripts Then run these samples using your browser from local web server Please make sure you have copied the IP2Location dll and sample database to the web application directory bin Sample WebForm Written in VB NET SampleCodes dotNET4 0 WebForm VBnet Sample WebForm Written in C SampleCodes dotNET4 0 WebForm C 3 IMPLEMENTING IP2LOCATION NET COMPONENT 3 1 IP2Location Objects
10. e The IDD prefix to call the city from another country AreaCode A varying length number assigned to geographic areas for call between cities WeatherStationCode Special code to identify the nearest weather observation station WeatherStationName Name of the nearest weather observation station MCC Mobile country code MNC Mobile network code MobileBrand Mobile brand Status Status code of query Elevation Average height of city above sea level in meters m UsageType Usage type classification of ISP or company COM Commercial ORG Organization GOV Government MIL Military EDU University College School LIB Library CDN Content Delivery Network ISP Fixed Line ISP MOB Mobile ISP DCH Data Center Web Hosting Transit SES Search Engine Spider amp RSV Reserved Note The result will return a not supported field message if the field of the result is not supported by the current database Possible Status Code returned from a query OK The query has been successfully performed EMPTY IP ADDRESS The IP address is empty INVALID IP ADDRESS The format of the IP address is wrong MISSING FILE The BIN file path is wrong or the BIN file is unreadable IP ADDRESS NOT FOUND The IP address does not exists in the BIN file IPV6 NOT SUPPORTED The BIN file does not contain IPv6 data 4 Purchase IP2LOCATION NET COMPONENT 4 1 License Agreement A license is required
11. t to use the SOFTWARE PRODUCT files on one computer in the Internet or Local Area Network LAN You may not use the SOFTWARE PRODUCT files on multiple computers without matching number of licenses DESCRIPTION OF LIMITATIONS You may not reverse engineer except and only to the extent that such activity is expressly permitted by applicable law notwithstanding this limitation Without prejudice to any other rights Hexasoft may terminate this License Agreement if you fail to comply with the terms and conditions of this License Agreement In such event you must destroy all copies of the SOFTWARE PRODUCT and all of its parts COPYRIGHT All title and copyrights in and to the SOFTWARE PRODUCT and any copies of the SOFTWARE PRODUCT are owned by Hexasoft The SOFTWARE PRODUCT is protected by copyright laws and international treaty provisions NO WARRANTIES Hexasoft expressly disclaims any warranty for the SOFTWARE PRODUCT The SOFTWARE PRODUCT and any related documentation is provided as is without warranty of any kind either express or implied including without limitation the implied warranties of merchantability or fitness for a particular purpose The entire risk arising out of use or performance of the SOFTWARE PRODUCT remains with you LIMITATION OF LIABILITY Hexasoft s entire liability and your exclusive remedy under this Agreement shall not exceed fifteen dollars US 15 00 NO LIABILITY FOR CONSEQUENTIAL DAMAGES In no event
12. x lP2LOCATION x NET Component User Manual Developed by Hexasoft Development Sdn Bhd Copyright 2001 2014 IP2Location com All Rights Reserved Visit our Web site at http www ip2location com Bringing Geography to the Internet a INTRODUCTION IP2Location is the solution for identifying the country origin region city latitude longitude ZIP code ISP and domain name of your site visitors in real time by using IP address This documentation provides detailed information to help you quickly get up to speed with our products and master it in no time at all Developers use this NET component for projects related to Display native language and currency Redirect based on country Digital rights management Prevent password sharing and abuse of service Reduce credit card fraud Web log stats and analysis Auto selection of country on forms Filter access from countries you do not do business with Geo targeting for increased sales and click through IP2Location component is written for NET Framework and optimized for Windows operating system performance SYSTEM REQUIREMENT IP2Location Component has been developed to run exclusively under Windows based machines with support for both WinForm and ASP NET for web form This component required a local IP2Location database for lookup purpose No Internet connection is required to execute this component
Download Pdf Manuals
Related Search