Click here to Skip to main content
15,123,029 members
Articles / Mobile Apps / Android
Posted 5 Mar 2012


273 bookmarked

Android: How to communicate with .NET application via TCP

Rate me:
Please Sign up or sign in to vote.
4.89/5 (89 votes)
13 Mar 2016CPOL4 min read
Simple example showing how to communicate between Android and .NET application.

Related articles:


The example bellow implements a simple request-response communication between Android and .NET application. The Android application is a simple client using the .NET application as a service to calculate length of the text message.

The example bellow uses Eneter Messaging Framework making the whole communication very simple. (The framework is free for noncommercial use and can be downloaded from You need to download Eneter for.NET and Eneter for Android. More detailed technical info can be found at technical info.)


To Run Example

If you use Android Studio:

  1. Download the example for Android Studio (It contains the client project for Android Studio and the service project for Visual Studio).
  2. Open NetService solution in Visual Studio.
  3. If your Visual Stusio supports NuGet packages then just try to build the solution and the Eneter library will be downloaded automatically from server.
    If your Visual Studio does not support NuGet packages then you need to download Eneter Messaging Framework for .NET and unzip it. Then add the reference to the Eneter library. (Right click on 'References' then choose 'Add Reference ...' and navigate to the path where you have unzipped Eneter for .NET and choose the library for .NET 4.0)
  4. Open AndroidNetCommunicationClientActivity in Android Studio.
  5. Download Eneter Messaging Framework for Java and unzip it.
  6. Copy eneter-messaging-android library to AndroidNetCommunicationClientActivity\app\libs.
  7. Right click on the Eneter library and (from the bottom part of the context menu) choose 'Add As Library...'
  8. Start Netervice from Visual Studio.
  9. Start Android client from in Android Studio.

In addition if you use Android Studio 2.3 or higher you need to turn off the 'Instant Run' feature. (The problem is that this feature "secretly" adds the field with the name $change into classes which then causes problems to XmlSerializer.):

  1. Open the Settings or Preferences dialog.
  2. Navigate to Build, Execution, Deployment > Instant Run.
  3. Uncheck the box next to Enable Instant Run.

If you use Eclipse:

  1. Download the example for Eclipse (It contains the client project for Eclipse and the service project for Visual Studio).
  2. Open NetService solution in Visual Studio.
  3. If your Visual Stusio supports NuGet packages then just try to build the solution and the Eneter library will be downloaded automatically from server.
    If your Visual Studio does not support NuGet packages then you need to download Eneter Messaging Framework for .NET and add the reference to the Eneter library. (Right click on 'References' then choose 'Add Reference ...' and navigate to the path where you have unzipped Eneter for .NET and choose the library for .NET 4.0)
  4. Open AndroidNetCommunicationClient in Eclipse.
  5. Download Eneter Messaging Framework for Java and unzip it.
  6. Right click on 'libs' and choose 'Import...' -> 'General/File System' -> 'Next'.
  7. Then click 'Browser' button for 'From directory' and navigate to directory with the Eneter library.
  8. Select the check box and press 'Finish'.
  9. Start Netervice from Visual Studio.
  10. Start Android client from in Android Studio.

TCP on Android

When you implement the communication via TCP on Android, you must count with two specifics:

If the permission is not set, the application is not allowed to communicate across the network. To set the INTERNET permission you must add the following line to AndroidManifest.xml.

<uses-permission android:name="android.permission.INTERNET"/>

An example of AndroidManifest.xml allowing communication across the network:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android=""
    android:versionName="1.0" >

    <uses-sdk android:minSdkVersion="7" />
    <uses-permission android:name="android.permission.INTERNET"/>

        android:label="@string/app_name" >
            android:label="@string/app_name" >
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />


The emulator acts as a separate device. Therefore, the IP address is the loopback of that device and cannot be used for the communication with other applications running on the same computer as the emulator.

Instead of that you must use a real IP address of the computer or the emulator can use the special address that is routed to (loopback) on the computer. In my example, the Android emulator uses and the .NET service is listening to

  1. You must set INTERNET permission for your Android application!
  2. The IP address (loopback) cannot be set on the Android emulator to communicate with the .NET application!

Android Client Application

The Android client is a very simple application allowing user to put some text message and send the request to the service to get back the length of the text. When the response message is received it must be marshalled to the UI thread to display the result. Also please do not forget to set android.permission.INTERNET.

The whole implementation is very simple with using the Eneter framework:

package net.client;

import eneter.messaging.diagnostic.EneterTrace;
import eneter.messaging.endpoints.typedmessages.*;
import eneter.messaging.messagingsystems.messagingsystembase.*;
import eneter.messaging.messagingsystems.tcpmessagingsystem.TcpMessagingSystemFactory;
import android.os.Bundle;
import android.os.Handler;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.*;

public class AndroidNetCommunicationClientActivity extends Activity
    // Request message type
    // The message must have the same name as declared in the service.
    // Also, if the message is the inner class, then it must be static.
    public static class MyRequest
        public String Text;

    // Response message type
    // The message must have the same name as declared in the service.
    // Also, if the message is the inner class, then it must be static.
    public static class MyResponse
        public int Length;
    // UI controls
    private Handler myRefresh = new Handler();
    private EditText myMessageTextEditText;
    private EditText myResponseEditText;
    private Button mySendRequestBtn;
    // Sender sending MyRequest and as a response receiving MyResponse.
    private IDuplexTypedMessageSender<MyResponse, MyRequest> mySender;
    /** Called when the activity is first created. */
    public void onCreate(Bundle savedInstanceState)
        // Get UI widgets.
        myMessageTextEditText = (EditText) findViewById(;
        myResponseEditText = (EditText) findViewById(;
        mySendRequestBtn = (Button) findViewById(;
        // Subscribe to handle the button click.
        // Open the connection in another thread.
        // Note: From Android 3.1 (Honeycomb) or higher
        //       it is not possible to open TCP connection
        //       from the main thread.
        Thread anOpenConnectionThread = new Thread(new Runnable()
                public void run()
                    catch (Exception err)
                        EneterTrace.error("Open connection failed.", err);
    public void onDestroy()
        // Stop listening to response messages.
    private void openConnection() throws Exception
        // Create sender sending MyRequest and as a response receiving MyResponse
        IDuplexTypedMessagesFactory aSenderFactory =
           new DuplexTypedMessagesFactory();
        mySender = aSenderFactory.createDuplexTypedMessageSender(MyResponse.class, MyRequest.class);
        // Subscribe to receive response messages.
        // Create TCP messaging for the communication.
        // Note: is a special alias to the loopback (
        //       on the development machine
        IMessagingSystemFactory aMessaging = new TcpMessagingSystemFactory();
        IDuplexOutputChannel anOutputChannel = 
        // Attach the output channel to the sender and be able to send
        // messages and receive responses.
    private void onSendRequest(View v)
        // Create the request message.
        MyRequest aRequestMsg = new MyRequest();
        aRequestMsg.Text = myMessageTextEditText.getText().toString();
        // Send the request message.
        catch (Exception err)
            EneterTrace.error("Sending the message failed.", err);
    private void onResponseReceived(Object sender, final TypedResponseReceivedEventArgs<MyResponse> e)
        // Display the result - returned number of characters.
        // Note: Marshal displaying to the correct UI thread. Runnable()
                public void run()
    private EventHandler<TypedResponseReceivedEventArgs<MyResponse>> myOnResponseHandler
         = new EventHandler<TypedResponseReceivedEventArgs<MyResponse>>()
        public void onEvent(Object sender,
                            TypedResponseReceivedEventArgs<MyResponse> e)
            onResponseReceived(sender, e);
    private OnClickListener myOnSendRequestClickHandler = new OnClickListener()
        public void onClick(View v)

.NET Service Application

The .NET service is a simple console application listening to TCP and receiving requests to calculate the length of a given text.

The implementation of the service is very simple:

using System;
using Eneter.Messaging.EndPoints.TypedMessages;
using Eneter.Messaging.MessagingSystems.MessagingSystemBase;
using Eneter.Messaging.MessagingSystems.TcpMessagingSystem;

namespace ServiceExample
    // Request message type
    public class MyRequest
        public string Text { get; set; }

    // Response message type
    public class MyResponse
        public int Length { get; set; }

    class Program
        private static IDuplexTypedMessageReceiver<MyResponse, MyRequest> myReceiver;

        static void Main(string[] args)
            // Create message receiver receiving 'MyRequest' and receiving 'MyResponse'.
            IDuplexTypedMessagesFactory aReceiverFactory = new DuplexTypedMessagesFactory();
            myReceiver = aReceiverFactory.CreateDuplexTypedMessageReceiver<MyResponse, MyRequest>();

            // Subscribe to handle messages.
            myReceiver.MessageReceived += OnMessageReceived;

            // Create TCP messaging.
            IMessagingSystemFactory aMessaging = new TcpMessagingSystemFactory();
            IDuplexInputChannel anInputChannel = 

            // Attach the input channel and start to listen to messages.

            Console.WriteLine("The service is running. To stop press enter.");

            // Detach the input channel and stop listening.
            // It releases the thread listening to messages.

        // It is called when a message is received.
        private static void OnMessageReceived(object sender, 
              TypedRequestReceivedEventArgs<MyRequest> e)
            Console.WriteLine("Received: " + e.RequestMessage.Text);

            // Create the response message.
            MyResponse aResponse = new MyResponse();
            aResponse.Length = e.RequestMessage.Text.Length;

            // Send the response message back to the client.
            myReceiver.SendResponseMessage(e.ResponseReceiverId, aResponse);

And here are applications communicating together:



This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Slovakia Slovakia
My programming path started in 1987 when I got my first computer Sharp MZ-800.
It came with 8 bit CPU Z80, 64Kb RAM and the tape recorder. It was a great machine. I think I still have it somewhere.
I was fascinated and I started to write first programs. Eventually I became developer and software architect. I like innovations and clean nice solutions.

Comments and Discussions

QuestionAny way refresh communication if C# app restarted? Pin
patongjs29-Mar-18 21:07
Memberpatongjs29-Mar-18 21:07 
GeneralMy vote of 5 Pin
DrABELL6-Dec-17 23:56
professionalDrABELL6-Dec-17 23:56 
Nice article in both practical and didactic aspects.
WYT Smile5-Oct-17 21:57
MemberWYT Smile5-Oct-17 21:57 
QuestionTransferring files via TCP Pin
ArunHanu15-Jun-17 23:26
MemberArunHanu15-Jun-17 23:26 
QuestionImage transferring by eneter messaging Pin
Hamza Saleem13-May-17 10:50
MemberHamza Saleem13-May-17 10:50 
AnswerRe: Image transferring by eneter messaging Pin
Williams Abiola25-May-18 1:40
MemberWilliams Abiola25-May-18 1:40 
Question.NET as client Pin
Member 1305567613-Mar-17 2:09
MemberMember 1305567613-Mar-17 2:09 
AnswerRe: .NET as client Pin
Ondrej_Uzovic14-Apr-17 7:50
MemberOndrej_Uzovic14-Apr-17 7:50 
GeneralRe: .NET as client Pin
Member 1305567621-Apr-17 2:50
MemberMember 1305567621-Apr-17 2:50 
QuestionCommunication Problem Pin
Refaghatjoo17-Nov-16 16:14
MemberRefaghatjoo17-Nov-16 16:14 
AnswerRe: Communication Problem Pin
Ondrej_Uzovic17-Nov-16 22:40
MemberOndrej_Uzovic17-Nov-16 22:40 
GeneralRe: Communication Problem Pin
Refaghatjoo18-Nov-16 4:32
MemberRefaghatjoo18-Nov-16 4:32 
GeneralRe: Communication Problem Pin
Ondrej_Uzovic18-Nov-16 5:27
MemberOndrej_Uzovic18-Nov-16 5:27 
GeneralRe: Communication Problem Pin
Refaghatjoo18-Nov-16 18:22
MemberRefaghatjoo18-Nov-16 18:22 
GeneralRe: Communication Problem Pin
Ondrej_Uzovic19-Nov-16 3:29
MemberOndrej_Uzovic19-Nov-16 3:29 
GeneralRe: Communication Problem Pin
Refaghatjoo24-Nov-16 6:35
MemberRefaghatjoo24-Nov-16 6:35 
GeneralRe: Communication Problem Pin
Refaghatjoo1-Dec-16 16:59
MemberRefaghatjoo1-Dec-16 16:59 
Questionsend an image rather than a text ? Pin
om.albaraa24-Jun-16 14:26
Memberom.albaraa24-Jun-16 14:26 
AnswerRe: send an image rather than a text ? Pin
Ondrej_Uzovic25-Jun-16 0:26
MemberOndrej_Uzovic25-Jun-16 0:26 
GeneralRe: send an image rather than a text ? Pin
om.albaraa25-Jun-16 18:38
Memberom.albaraa25-Jun-16 18:38 
GeneralRe: send an image rather than a text ? Pin
Ondrej_Uzovic25-Jun-16 22:04
MemberOndrej_Uzovic25-Jun-16 22:04 
QuestionCommunication problem Pin
moimemedede20-Jun-16 2:07
Membermoimemedede20-Jun-16 2:07 
AnswerRe: Communication problem Pin
Ondrej_Uzovic20-Jun-16 3:06
MemberOndrej_Uzovic20-Jun-16 3:06 
GeneralRe: Communication problem Pin
moimemedede20-Jun-16 9:40
Membermoimemedede20-Jun-16 9:40 
GeneralRe: Communication problem Pin
Ondrej_Uzovic21-Jun-16 21:36
MemberOndrej_Uzovic21-Jun-16 21:36 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.