懒人服务器 - 教程三、了解如何应用（DotNet客户端）

懒人服务器的客户端开发包是有DotNet版本的，
且支持 DotNet4.0（XP适用）和 DotNet4.5（Win7/Win8/Metro适用）；
同时也兼容 Mono，所以可用于跨平台开发（结合Xamarin可用于手机开发）。

DotNet版本与Java版本的客户端开发包，在使用上是非常类似的，
主要也是使用核心类 TcpDataClient 进行连接、发送和断开等操作。
不过在DotNet版本的例子中，我们将会使用WindowsForm作为程序的界面，
因此，在流程安排上会有点不同。
比如说，我们会在WinForm的Load事件中连接服务器；
而在WinForm的FormClosed事件中断开与服务器的连接。

客户端例子的完整代码如下：

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;

using Lazyboots.Network.Common;
using Lazyboots.Network.Client;

namespace SimpleLazybootsClient
{
    public partial class Form1 : Form
    {
        public const int STRING_ACTION  = 1002;
        public const int UPPERCASE_FUNC = 1;

        public Form1()
        {
            InitializeComponent();

            // 初始化界面控件的状态
            button1.Enabled = false;
            textBox1.Enabled = false;
            progressBar1.Visible = false;
            progressBar1.Style = ProgressBarStyle.Marquee;
            progressBar1.MarqueeAnimationSpeed = 10;

        }

        private async void Form1_Load(object sender, EventArgs e)
        {
            // 创建一个 TcpDataClient，用于连接服务器
            TcpDataClient client = new TcpDataClient();

            // 连接服务器
            await client.Connect("127.0.0.1", 9090);

            if (client.Code == 0)  // 如果连接成功，就让按钮可以点击
            {
                button1.Enabled = true;
                textBox1.Enabled = true;
            }
            else label1.Text = client.Message; // 如果连接失败，则显示错误信息
            
        }

        private async void button1_Click(object sender, EventArgs e)
        {
            string str = textBox1.Text;
            if (str.Length <= 0) return;

            // 参数中的“STRING_ACTION（1002）”表示“请求字串转换指令”, 
            // 参数中的“UPPERCASE_FUNC（1）”则表示“请求大写转换功能”
            TcpDataClient client = new TcpDataClient(STRING_ACTION, UPPERCASE_FUNC);

            // 设置显示进度条
            progressBar1.Visible = true;

            // 获取并显示结果
            label1.Text = await client.GetString(str);

            // 隐藏进度条
            progressBar1.Visible = false;
        }

        private void Form1_FormClosed(object sender, FormClosedEventArgs e)
        {
            // 创建一个 TcpDataClient，用于关闭连接
            TcpDataClient client = new TcpDataClient();

            // 关闭连接
            client.Disconnect();
        }

        
    }
}

在DotNet的客户端例子中，我们要注意的是DotNet的一对关键字 async/await 。
这两个关键字所修饰的函数都是异步执行的。

这表示，TcpDataClient在这里被调用到的函数都是异步执行的。
而实际上，不管是Java版的TcpDataClient还是DotNet版本的TcpDataClient，
它所有与网络相关的函数操作都是异步执行的。

在DotNet里面，async/await 这对关键字非常神奇，
它让所有异步操作的代码，写起来就跟写同步操作的代码一样，
具有便于阅读和理解的连贯性，但同时又不会在执行过程中形成阻塞。