http://bbs.bccn.net/thread-158657-1-1.html
網上很不錯的一篇文章．介紹了Ｐ２Ｐ通信的原理，包括內外網打洞的原理。不光在ＵＤＰ上可以使用，在ＴＣＰ的兩個內網間通信或Ｐ２Ｐ也有很大的參考價值。現轉載文章並附上根據文章產生的源碼。
值得提醒的是，在序列化與反序列化過程中需要明白程序集的概念。服務器端及客戶端要求使用相同的程序集名，否則會出現unable to assembly ....的錯誤。
nat(network address translators)，網絡地址轉換：網絡地址轉換是在ip地址日益缺乏的情況下產生的，它的主要目的就是爲了能夠地址重用。nat分爲兩大類，基本的nat和napt(network address/port translator)。
最開始nat是運行在路由器上的一個功能模塊。
最先提出的是基本的nat，它的產生基於如下事實：一個私有網絡（域）中的節點中只有很少的節點需要與外網連接（呵呵，這是在上世紀90年代中期提出的）。那麼這個子網中其實只有少數的節點需要全球唯一的ip地址，其他的節點的ip地址應該是可以重用的。
因此，基本的nat實現的功能很簡單，在子網內使用一個保留的ip子網段，這些ip對外是不可見的。子網內只有少數一些ip地址可以對應到真正全球唯一的ip地址。如果這些節點需要訪問外部網絡，那麼基本nat就負責將這個節點的子網內ip轉化爲一個全球唯一的ip然後發送出去。(基本的nat會改變ip包中的原ip地址，但是不會改變ip包中的端口)
關於基本的nat可以參看rfc 1631
另外一種nat叫做napt，從名稱上我們也可以看得出，napt不但會改變經過這個nat設備的ip數據報的ip地址，還會改變ip數據報的tcp/udp端口。基本nat的設備可能我們見的不多（呵呵，我沒有見到過），napt纔是我們真正討論的主角。看下圖：
有一個私有網絡10.*.*.*，client a是其中的一臺計算機，這個網絡的網關（一個nat設備）的外網ip是155.99.25.11(應該還有一個內網的ip地址，比如10.0.0.10)。如果client a中的某個進程（這個進程創建了一個udp socket,這個socket綁定1234端口）想訪問外網主機18.181.0.31的1235端口，那麼當數據包通過nat時會發生什麼事情呢？
先nat會改變這個數據包的原ip地址，改爲155.99.25.11。接着nat會爲這個傳輸創建一個session（session是一個抽象的概念，如果是tcp，也許session是由一個syn包開始，以一個fin包結束。而udp呢，以這個ip的這個端口的第一個udp開始，結束呢，呵呵，也許是幾分鐘，也許是幾小時，這要看具體的實現了）並且給這個session分配一個端口，比如62000，然後改變這個數據包的源端口爲62000。所以本來是（10.0.0.1:1234->18.181.0.31:1235）的數據包到了互聯網上變爲了（155.99.25.11:62000->18.181.0.31:1235）。一旦nat創建了一個session後，nat會記住62000端口對應的是10.0.0.1的1234端口，以後從18.181.0.31發送到62000端口的數據會被nat自動的轉發到10.0.0.1上。（注意：這裏是說18.181.0.31發送到62000端口的數據會被轉發，其他的ip發送到這個端口的數據將被nat拋棄）這樣client a就與server s1建立以了一個連接。
呵呵，上面的基礎知識可能很多人都知道了，那麼下面是關鍵的部分了。
看看下面的情況：
接上面的例子，如果client a的原來那個socket(綁定了1234端口的那個udp socket)又接着向另外一個server s2發送了一個udp包，那麼這個udp包在通過nat時會怎麼樣呢？
這時可能會有兩種情況發生，一種是nat再次創建一個session，並且再次爲這個session分配一個端口號（比如：62001）。另外一種是nat再次創建一個session，但是不會新分配一個端口號，而是用原來分配的端口號62000。前一種nat叫做symmetric nat，後一種叫做cone nat。我們期望我們的nat是第二種，呵呵，如果你的nat剛好是第一種，那麼很可能會有很多p2p軟件失靈。（可以慶幸的是，現在絕大多數的nat屬於後者，即cone nat）
好了，我們看到，通過nat,子網內的計算機向外連結是很容易的（nat相當於透明的，子網內的和外網的計算機不用知道nat的情況）。
但是如果外部的計算機想訪問子網內的計算機就比較困難了（而這正是p2p所需要的）。
那麼我們如果想從外部發送一個數據報給內網的計算機有什麼辦法呢？首先，我們必須在內網的nat上打上一個“洞”（也就是前面我們說的在nat上建立一個session），這個洞不能由外部來打，只能由內網內的主機來打。而且這個洞是有方向的，比如從內部某臺主機（比如：192.168.0.10）向外部的某個ip(比如：219.237.60.1)發送一個udp包，那麼就在這個內網的nat設備上打了一個方向爲219.237.60.1的“洞”，（這就是稱爲udp hole punching的技術）以後219.237.60.1就可以通過這個洞與內網的192.168.0.10聯繫了。（但是其他的ip不能利用這個洞）。
呵呵，現在該輪到我們的正題p2p了。有了上面的理論，實現兩個內網的主機通訊就差最後一步了：那就是雞生蛋還是蛋生雞的問題了，兩邊都無法主動發出連接請求，誰也不知道誰的公網地址，那我們如何來打這個洞呢？我們需要一箇中間人來聯繫這兩個內網主機。
現在我們來看看一個p2p軟件的流程，以下圖爲例：
首先，client a登錄服務器，nat a爲這次的session分配了一個端口60000，那麼server s收到的client a的地址是202.187.45.3:60000，這就是client a的外網地址了。同樣，client b登錄server s，nat b給此次session分配的端口是40000，那麼server s收到的b的地址是187.34.1.56:40000。此時，client a與client b都可以與server s通信了。如果client a此時想直接發送信息給client b，那麼他可以從server s那兒獲得b的公網地址187.34.1.56:40000，是不是client a向這個地址發送信息client b就能收到了呢？答案是不行，因爲如果這樣發送信息，nat b會將這個信息丟棄（因爲這樣的信息是不請自來的，爲了安全，大多數nat都會執行丟棄動作）。現在我們需要的是在nat b上打一個方向爲202.187.45.3（即client a的外網地址）的洞，那麼client a發送到187.34.1.56:40000的信息,client b就能收到了。這個打洞命令由誰來發呢，呵呵，當然是server s。
總結一下這個過程：如果client a想向client b發送信息，那麼client a發送命令給server s，請求server s命令client b向client a方向打洞。呵呵，是不是很繞口，不過沒關係，想一想就很清楚了，何況還有源代碼呢（侯老師說過：在源代碼面前沒有祕密 8）），然後client a就可以通過client b的外網地址與client b通信了。
注意：以上過程只適合於cone nat的情況，如果是symmetric nat，那麼當client b向client a打洞的端口已經重新分配了，client b將無法知道這個端口（如果symmetric nat的端口是順序分配的，那麼我們或許可以猜測這個端口號，可是由於可能導致失敗的因素太多，我們不推薦這種猜測端口的方法）。
下面是一個模擬p2p聊天的過程的源代碼，過程很簡單，p2pserver運行在一個擁有公網ip的計算機上，p2pclient運行在兩個不同的nat後（注意，如果兩個客戶端運行在一個nat後，本程序很可能不能運行正常，這取決於你的nat是否支持loopback translation，詳見http://midcom-p2p.sourceforge.net/draft-ford-midcom-p2p-01.txt，當然，此問題可以通過雙方先嚐試連接對方的內網ip來解決，但是這個代碼只是爲了驗證原理，並沒有處理這些問題），後登錄的計算機可以獲得先登錄計算機的用戶名，後登錄的計算機通過send username message的格式來發送消息。如果發送成功，說明你已取得了直接與對方連接的成功。
1.公共庫：WellKnown
using System;
using System.IO;
using System.Runtime.Serialization.Formatters.Binary;
using System.Net;
using System.Net.Sockets;
using System.Collections;
namespace WellKnown
{
/// <summary>
/// P2PConsts 的摘要說明。
/// </summary>
public class P2PConsts
{
/// <summary>
/// 服務器偵聽端口號
/// </summary>
public const int SRV_PORT = 2280;
}
/// <summary>
/// User 的摘要說明。
/// </summary>
[Serializable]
public class User
{
protected string userName;
protected IPEndPoint netPoint;
public User(string UserName, IPEndPoint NetPoint)
{
this.userName = UserName;
this.netPoint = NetPoint;
}
public string UserName
{
get { return userName;}
set { userName = value;}
}
public IPEndPoint NetPoint
{
get { return netPoint; }
set { netPoint = value;}
}
}
/// <summary>
/// UserCollection 的摘要說明。
/// </summary>
[Serializable]
public class UserCollection : CollectionBase
{
public void Add(User user)
{
InnerList.Add(user);
}
public void Remove(User user)
{
InnerList.Remove(user);
}
public User this[int index]
{
get { return (User)InnerList[index]; }
}
public User Find(string userName)
{
foreach(User user in this)
{
if (string.Compare(userName, user.UserName, true) == 0)
{
return user;
}
}
return null;
}
}
/// <summary>
/// FormatterHelper 序列化，反序列化消息的幫助類
/// </summary>
///
[Serializable]
public class FormatterHelper
{
public static byte[] Serialize(object obj)
{
BinaryFormatter binaryF = new BinaryFormatter();
MemoryStream ms = new MemoryStream(1024*10);
binaryF.Serialize(ms, obj);
ms.Seek(0, SeekOrigin.Begin);
byte[] buffer = new byte[(int)ms.Length];
ms.Read(buffer, 0, buffer.Length);
ms.Close();
return buffer;
}
public static object Deserialize(byte[] buffer)
{
BinaryFormatter binaryF = new BinaryFormatter();
MemoryStream ms = new MemoryStream(buffer, 0, buffer.Length, false);
object obj = binaryF.Deserialize(ms);
ms.Close();
return obj;
}
}
/// <summary>
/// Message base class
/// </summary>
[System.Serializable]
public abstract class MessageBase
{
}
// Message from Client to Server
namespace C2S
{
/// <summary>
/// 客戶端發送到服務器的消息基類
/// </summary>
[Serializable]
public abstract class CSMessage : MessageBase
{
private string userName;
protected CSMessage(string anUserName)
{
userName = anUserName;
}
public string UserName
{
get { return userName; }
}
}
/// <summary>
/// 用戶登錄消息
/// </summary>
///
[Serializable]
public class LoginMessage : CSMessage
{
private string password;
public LoginMessage(string userName, string password) : base(userName)
{
this.password = password;
}
public string Password
{
get { return password; }
}
}
/// <summary>
/// 用戶登出消息
/// </summary>
[Serializable]
public class LogoutMessage : CSMessage
{
public LogoutMessage(string userName) : base(userName)
{}
}
/// <summary>
/// 請求用戶列表消息
/// </summary>
[Serializable]
public class GetUsersMessage : CSMessage
{
public GetUsersMessage(string userName) : base(userName)
{}
}
/// <summary>
/// 請求Purch Hole消息
/// </summary>
[Serializable]
public class TranslateMessage : CSMessage
{
protected string toUserName;
public TranslateMessage(string userName, string toUserName) : base(userName)
{
this.toUserName = toUserName;
}
public string ToUserName
{
get { return this.toUserName; }
}
}
}
// Message from server to the client
namespace S2C
{
/// <summary>
/// 服務器發送到客戶端消息基類
/// </summary>
[Serializable]
public abstract class SCMessage : MessageBase
{}
/// <summary>
/// 請求用戶列表應答消息
/// </summary>
[Serializable]
public class GetUsersResponseMessage : SCMessage
{
private UserCollection userList;
public GetUsersResponseMessage(UserCollection users)
{
this.userList = users;
}
public UserCollection UserList
{
get { return userList; }
}
}
/// <summary>
/// 轉發請求Purch Hole消息
/// </summary>
[Serializable]
public class SomeOneCallYouMessage : SCMessage
{
protected System.Net.IPEndPoint remotePoint;
public SomeOneCallYouMessage(System.Net.IPEndPoint point)
{
this.remotePoint = point;
}
public System.Net.IPEndPoint RemotePoint
{
get { return remotePoint; }
}
}
}
// Message from peer to the peer
namespace P2P
{
/// <summary>
/// 點對點消息基類
/// </summary>
[Serializable]
public abstract class PPMessage : MessageBase
{}
/// <summary>
/// 測試消息
/// </summary>
[Serializable]
public class WorkMessage : PPMessage
{
private string message;
public WorkMessage(string msg)
{
message = msg;
}
public string Message
{
get { return message; }
}
}
/// <summary>
/// 測試應答消息
/// </summary>
[Serializable]
public class ACKMessage : PPMessage
{
}
/// <summary>
/// P2P Purch Hole Message
/// </summary>
public class TrashMessage : PPMessage
{}
}
}
2. Server
using System;
using System.Net;
using System.Net.Sockets;
using System.Threading;
using WellKnown;
namespace P2PServer
{
/// <summary>
/// Class1 的摘要說明。
/// </summary>
class Class1
{
/// <summary>
/// 應用程序的主入口點。
/// </summary>
[STAThread]
static void Main(string[] args)
{
Server server = new Server();
try
{
server.Start();
Console.ReadLine();
server.Stop();
}
catch
{}
}
}
/// <summary>
/// Server 的摘要說明。
/// </summary>
public class Server
{
private UdpClient server;
private UserCollection userList;
private Thread serverThread;
private IPEndPoint remotePoint;
public Server()
{
userList = new UserCollection();
remotePoint = new IPEndPoint(IPAddress.Any, 0);
serverThread = new Thread(new ThreadStart(Run));
}
public void Start()
{
try
{
server = new UdpClient(P2PConsts.SRV_PORT);
serverThread.Start();
Console.WriteLine("P2P Server started, waiting client connect...");
}
catch(Exception exp)
{
Console.WriteLine("Start P2P Server error: " + exp.Message);
throw exp;
}
}
public void Stop()
{
Console.WriteLine("P2P Server stopping...");
try
{
serverThread.Abort();
server.Close();
Console.WriteLine("Stop OK.");
}
catch(Exception exp)
{
Console.WriteLine("Stop error: " + exp.Message);
throw exp;
}
}
private void Run()
{
byte[] buffer = null;
while (true)
{
byte[] msgBuffer = server.Receive(ref remotePoint);
try
{
object msgObj = FormatterHelper.Deserialize(msgBuffer);
Type msgType = msgObj.GetType();
if (msgType == typeof(WellKnown.C2S.LoginMessage))
{
// 轉換接受的消息
WellKnown.C2S.LoginMessage lginMsg = (WellKnown.C2S.LoginMessage)msgObj;
Console.WriteLine("has an user login: {0}", lginMsg.UserName);
// 添加用戶到列表
IPEndPoint userEndPoint = new IPEndPoint(remotePoint.Address, remotePoint.Port);
User user = new User(lginMsg.UserName, userEndPoint);
userList.Add(user);
// 發送應答消息
WellKnown.S2C.GetUsersResponseMessage usersMsg = new WellKnown.S2C.GetUsersResponseMessage(userList);
buffer = FormatterHelper.Serialize(usersMsg);
server.Send(buffer, buffer.Length, remotePoint);
}
else if (msgType == typeof(WellKnown.C2S.LogoutMessage))
{
// 轉換接受的消息
WellKnown.C2S.LogoutMessage lgoutMsg = (WellKnown.C2S.LogoutMessage)msgObj;
Console.WriteLine("has an user logout: {0}", lgoutMsg.UserName);
// 從列表中刪除用戶
User lgoutUser = userList.Find(lgoutMsg.UserName);
if (lgoutUser != null)
{
userList.Remove(lgoutUser);
}
}
else if (msgType == typeof(WellKnown.C2S.TranslateMessage))
{
// 轉換接受的消息
WellKnown.C2S.TranslateMessage transMsg = (WellKnown.C2S.TranslateMessage)msgObj;
Console.WriteLine("{0}(1) wants to p2p {2}", remotePoint.Address.ToString(), transMsg.UserName, transMsg.ToUserName);
// 獲取目標用戶
User toUser = userList.Find(transMsg.ToUserName);
// 轉發Purch Hole請求消息
if (toUser == null)
{
Console.WriteLine("Remote host {0} cannot be found at index server", transMsg.ToUserName);
}
else
{
WellKnown.S2C.SomeOneCallYouMessage transMsg2 = new WellKnown.S2C.SomeOneCallYouMessage(remotePoint);
buffer = FormatterHelper.Serialize(transMsg);
server.Send(buffer, buffer.Length, toUser.NetPoint);
}
}
else if (msgType == typeof(WellKnown.C2S.GetUsersMessage))
{
// 發送當前用戶信息到所有登錄客戶
WellKnown.S2C.GetUsersResponseMessage srvResMsg = new WellKnown.S2C.GetUsersResponseMessage(userList);
buffer = FormatterHelper.Serialize(srvResMsg);
foreach(User user in userList)
{
server.Send(buffer, buffer.Length, user.NetPoint);
}
}
Thread.Sleep(500);
}
catch(Exception exp)
{
Console.WriteLine("error: " + exp.Message);
throw exp;
}
}
}
}
}
//////////////////////////
3. Client
using System;
using System.Net;
using System.Net.Sockets;
using System.Threading;
using WellKnown;
namespace P2PClient
{
/// <summary>
/// Class1 的摘要說明。
/// </summary>
class Class1
{
/// <summary>
/// 應用程序的主入口點。
/// </summary>
[STAThread]
static void Main(string[] args)
{
Client client = new Client("192.168.1.141");
client.ConnectToServer("myname2", "mypassword");
client.Start();
Console.WriteLine("test arguments");
while (true)
{
string str = Console.ReadLine();
client.PaserCommand(str);
}
}
}
/// <summary>
/// Client 的摘要說明。
/// </summary>
public class Client : IDisposable
{
private const int MAXRETRY = 10;
// private UdpClient client;
private UdpClient client;
private IPEndPoint hostPoint;
private IPEndPoint remotePoint;
private UserCollection userList;
private string myName;
private bool ReceivedACK;
private Thread listenThread;
public Client(string serverIP)
{
ReceivedACK = false;
remotePoint = new IPEndPoint(IPAddress.Any, 0);
hostPoint = new IPEndPoint(IPAddress.Parse(serverIP), P2PConsts.SRV_PORT);
client = new UdpClient();
userList = new UserCollection();
listenThread = new Thread(new ThreadStart(Run));
}
public void Start()
{
if (this.listenThread.ThreadState==ThreadState.Unstarted)
{
this.listenThread.Start();
Console.WriteLine("You can input you command:\n");
Console.WriteLine("Command Type:\"send\",\"exit\",\"getu\"");
Console.WriteLine("Example : send Username Message");
Console.WriteLine(" exit");
Console.WriteLine(" getu");
}
}
public void ConnectToServer(string userName, string password)
{
myName = userName;
// 發送登錄消息到服務器
WellKnown.C2S.LoginMessage lginMsg = new WellKnown.C2S.LoginMessage(userName, password);
byte[] buffer = FormatterHelper.Serialize(lginMsg);
client.Send(buffer, buffer.Length, hostPoint);
// 接受服務器的登錄應答消息
buffer = client.Receive(ref remotePoint);
WellKnown.S2C.GetUsersResponseMessage srvResMsg = (WellKnown.S2C.GetUsersResponseMessage)FormatterHelper.Deserialize(buffer);
// 更新用戶列表
userList.Clear();
foreach(User user in srvResMsg.UserList)
{
userList.Add(user);
}
this.DisplayUsers(userList);
}
/// <summary>
/// 這是主要的函數：發送一個消息給某個用戶(C)
/// 流程：直接向某個用戶的外網IP發送消息，如果此前沒有聯繫過
/// 那麼此消息將無法發送，發送端等待超時。
/// 超時後，發送端將發送一個請求信息到服務端，要求服務端發送
/// 給客戶C一個請求，請求C給本機發送打洞消息
/// *以上流程將重複MAXRETRY次
/// </summary>
/// <param name="toUserName">對方用戶名</param>
/// <param name="message">待發送的消息</param>
/// <returns></returns>
private bool SendMessageTo(string toUserName, string message)
{
User toUser = userList.Find(toUserName);
if (toUser == null)
{
return false;
}
for (int i=0; i<MAXRETRY; i++)
{
WellKnown.P2P.WorkMessage workMsg = new WellKnown.P2P.WorkMessage(message);
byte[] buffer = FormatterHelper.Serialize(workMsg);
client.Send(buffer, buffer.Length, toUser.NetPoint);
// 等待接收線程將標記修改
for (int j=0; j<10; j++)
{
if (this.ReceivedACK)
{
this.ReceivedACK = false;
return true;
}
else
{
Thread.Sleep(300);
}
}
// 沒有接收到目標主機的迴應，認爲目標主機的端口映射沒有
// 打開，那麼發送請求信息給服務器，要服務器告訴目標主機
// 打開映射端口（UDP打洞）
WellKnown.C2S.TranslateMessage transMsg = new WellKnown.C2S.TranslateMessage(myName, toUserName);
buffer = FormatterHelper.Serialize(transMsg);
client.Send(buffer, buffer.Length, hostPoint);
// 等待對方先發送信息
Thread.Sleep(100);
}
return false;
}
public void PaserCommand(string cmdstring)
{
cmdstring = cmdstring.Trim();
string[] args = cmdstring.Split(new char[]{' '});
if (args.Length > 0)
{
if (string.Compare(args[0], "exit", true) == 0)
{
WellKnown.C2S.LogoutMessage lgoutMsg = new WellKnown.C2S.LogoutMessage(myName);
byte[] buffer = FormatterHelper.Serialize(lgoutMsg);
client.Send(buffer, buffer.Length, hostPoint);
// do clear something here
Dispose();
System.Environment.Exit(0);
}
else if (string.Compare(args[0], "send", true) == 0)
{
if (args.Length > 2)
{
string toUserName = args[1];
string message = "";
for(int i=2; i<args.Length; i++)
{
if (args[i] == "") message += " ";
else message += args[i];
}
if (this.SendMessageTo(toUserName, message))
{
Console.WriteLine("Send OK!");
}
else
Console.WriteLine("Send Failed!");
}
}
else if (string.Compare(args[0], "getu", true) == 0)
{
WellKnown.C2S.GetUsersMessage getUserMsg = new WellKnown.C2S.GetUsersMessage(myName);
byte[] buffer = FormatterHelper.Serialize(getUserMsg);
client.Send(buffer, buffer.Length, hostPoint);
}
else
{
Console.WriteLine("Unknown command {0}", cmdstring);
}
}
}
private void DisplayUsers(UserCollection users)
{
foreach (User user in users)
{
Console.WriteLine("Username: {0}, IP:{1}, Port:{2}", user.UserName, user.NetPoint.Address.ToString(), user.NetPoint.Port);
}
}
private void Run()
{
byte[] buffer;
while (true)
{
buffer = client.Receive(ref remotePoint);
object msgObj = FormatterHelper.Deserialize(buffer);
Type msgType = msgObj.GetType();
if (msgType == typeof(WellKnown.S2C.GetUsersResponseMessage))
{
// 轉換消息
WellKnown.S2C.GetUsersResponseMessage usersMsg = (WellKnown.S2C.GetUsersResponseMessage)msgObj;
// 更新用戶列表
userList.Clear();
foreach(User user in usersMsg.UserList)
{
userList.Add(user);
}
this.DisplayUsers(userList);
}
else if (msgType == typeof(WellKnown.S2C.SomeOneCallYouMessage))
{
// 轉換消息
WellKnown.S2C.SomeOneCallYouMessage purchReqMsg = (WellKnown.S2C.SomeOneCallYouMessage)msgObj;
// 發送打洞消息到遠程主機
WellKnown.P2P.TrashMessage trashMsg = new WellKnown.P2P.TrashMessage();
buffer = FormatterHelper.Serialize(trashMsg);
client.Send(buffer, buffer.Length, purchReqMsg.RemotePoint);
}
else if (msgType == typeof(WellKnown.P2P.WorkMessage))
{
// 轉換消息
WellKnown.P2P.WorkMessage workMsg = (WellKnown.P2P.WorkMessage)msgObj;
Console.WriteLine("Receive a message: {0}", workMsg.Message);
// 發送應答消息
WellKnown.P2P.ACKMessage ackMsg = new WellKnown.P2P.ACKMessage();
buffer = FormatterHelper.Serialize(ackMsg);
client.Send(buffer, buffer.Length, remotePoint);
}
else if (msgType == typeof(WellKnown.P2P.ACKMessage))
{
this.ReceivedACK = true;
}
else if (msgType == typeof(WellKnown.P2P.TrashMessage))
{
Console.WriteLine("Recieve a trash message");
}
Thread.Sleep(100);
}
}
#region IDisposable 成員
public void Dispose()
{
try
{
this.listenThread.Abort();
this.client.Close();
}
catch
{}
}
#endregion
}
}