windows-desktop-csharp.md

platform	device	language
windows	desktop	csharp

Run a simple Csharp sample on desktop running Windows

---

Table of Contents

• Introduction
• Step 1: Prerequisites
• Step 2: Prepare your Device
• Step 3: Build and Run the Sample

Introduction

About this document

This document describes how to build and run the Device Client AMQP Sample application on the Windows platform. This multi-step process includes:

• Configuring Azure IoT Hub
• Registering your IoT device
• Build and deploy Azure IoT SDK on device

Step 1: Prerequisites

You should have the following items ready before beginning the process:

• Computer with Git client installed and access to the azure-iot-sdks GitHub public repository.
• Windows Desktop
• Prepare your development environment.
• Setup your IoT hub
• Provision your device and get its credentials

Step 2: Prepare your Device

• Make sure desktop is ready as per instructions given onPrepare your development environment.

Step 3: Build and Run the sample

• Download the Azure IoT SDK and the sample programs and save them to your local repository.

• Start a new instance of Visual Studio 2015.

• Open the iothub_csharp_client.sln solution in the csharp\device folder in your local copy of the repository.

• In Visual Studio, from Solution Explorer, navigate to the samples folder.

• In the DeviceClientAmqpSample project, open the Program.cs file.

• Locate the following code in the file:

  private const string DeviceConnectionString = "<replace>";
  

• Replace <replace> with the connection string for your device.

• In Solution Explorer, right-click the DeviceClientAmqpSample project, click Debug, and then click Start new instance to build and run the sample. The console displays messages as the application sends device-to-cloud messages to IoT Hub.

• See Manage IoT Hub to learn how to observe the messages IoT Hub receives from the application and how to send cloud-to-device messages to the application.