Network
=======

**Energy.Core.Network** provides high-level networking helpers built on top of `Energy.Base.Network`.

Host resolution
---------------

```csharp
string address = Energy.Core.Network.GetHostAddress("localhost");
string address6 = Energy.Core.Network.GetHostAddress("example.com", System.Net.Sockets.AddressFamily.InterNetworkV6);
```

Address family and socket type
------------------------------

```csharp
System.Net.Sockets.AddressFamily family = Energy.Core.Network.GetAddressFamily("192.168.1.1");
System.Net.Sockets.SocketType type = Energy.Core.Network.GetSocketType(
    System.Net.Sockets.ProtocolType.Tcp, family);
```

Socket helpers
--------------

```csharp
System.Net.Sockets.Socket socket = new System.Net.Sockets.Socket(...);

bool connected = Energy.Core.Network.IsConnected(socket);
Energy.Core.Network.Shutdown(socket);
```

Host name
---------

```csharp
string host = Energy.Core.Network.GetHostName();
```

Settings
--------

```csharp
Energy.Core.Network.Settings.AddressFamily = System.Net.Sockets.AddressFamily.InterNetwork;
```

Summary
-------

| Method | Description |
|--------|-------------|
| `GetHostAddress(string)` | Resolve a host to an IP address. |
| `GetHostAddress(string, AddressFamily)` | Resolve with a preferred address family. |
| `GetAddressFamily(string)` | Determine the address family. |
| `GetSocketType(ProtocolType, AddressFamily)` | Determine the socket type. |
| `Shutdown(Socket)` | Gracefully shutdown and close a socket. |
| `GetHostName()` | Get the machine host name. |
| `IsConnected(Socket)` | Check if a socket is connected. |

See also
--------

- `base-network`
- `core-web`