如何开始使用 /n software .NET Core Internet Communications Components

/n software ( www.nsoftware.com ) 提供实现了 Internet 通信功能的组件，可集成到您的桌面、服务器和移动应用程序中。这包括文件和数据传输、消息传递、电子邮件、身份验证、加密、网络管理、业务集成、支付处理以及云存储集成。我们的使命之一是保持开发人员工具包与最新的平台、协议和安全标准保持同步。既然 .NET Standard 和 .NET Core 已经问世，我们的组件也已完全兼容。

本文将帮助您开始使用我们 30 多个工具包中的任何一个。以下是您可以在 .NET Core 和 .NET Standard 应用程序中使用的一些 /n software 产品：

• IP*Works!：文件传输、远程访问、电子邮件、消息传递和安全
• IP*Works! SSH：安全文件传输 (SFTP)、SSH Shell、SCP、SSH Tunnel
• IP*Works! Encrypt：使用主要的加密标准加密和解密文件、电子邮件和其他数据
• E-Payment Integrator：功能齐全的支付处理
• EDI Integrator：AS2/AS4 安全 B2B 通信以及 EDI 读取、写入和转换
• Cloud Storage Integrator：与所有流行的云存储服务（如 Google、Box.com、Dropbox、OneDrive、Amazon 和 Azure）集成

请访问 http://www.nsoftware.com 查看我们产品的完整列表。它们都包含在我们的 Red Carpet Subscription 中，该订阅提供所有组件，并定期更新。这是保持您的应用程序最新状态的好方法。

每个 /n software 产品都可以免费试用，并包含示例和在线支持。本文将为您提供在开发环境中设置我们的组件的简单说明。请按照下面的说明选择并安装一个产品以进行尝试。

下载 .NET 版本试用

我们的产品有多种版本，例如 .NET、Delphi、Java、C++ 和 macOS。所有 .NET 版本都支持 .NET Core 和 .NET Standard。您可以通过 NuGet 或直接从我们的网站下载和安装产品。

NuGet

安装库的最简单方法是通过 NuGet。您可以在 NuGet 库中找到所有 .NET 版本包。例如，您可以搜索 IP*Works!。

直接下载

如果您更愿意直接从我们的网站获取组件，请从我们的 下载页面 选择一个产品。单击一个产品后，您将进入可用版本列表。下载 .NET 版本。

.NET 版本设置

除了 NuGet，在运行 .NET 版本的 Windows 安装程序时也会包含这些库，并将它们放置在安装目录的 lib\netstandard2.0, lib\netstandard1.6 和 lib\netstandard1.4 文件夹中。

支持的平台和版本

该工具包已编译为支持 .NET Standard 2.0、1.6 和 1.4。通过 NuGet 添加包时，将根据您的项目设置自动选择正确的版本。通过支持 .NET Standard 2.0、1.6 和 1.4，可以支持广泛的平台。这包括：

• .NET Core (1.0+)
• ASP.NET Core (1.0+)
• 通用 Windows 平台 (UWP 10.0+)
• Xamarin.iOS (10.0+)
• Xamarin.Android (7.0+)
• Mono (4.6+)

无需特殊步骤即可定位受支持的版本。创建项目后，只需添加 NuGet 包即可开始使用组件。

.NET Core 应用在 Linux 上

虽然在所有支持 .NET Standard 的平台上使用组件的方式相同，但为了更好地说明组件的使用方式，以下示例将在 Linux 上运行的 .NET Core 控制台应用程序中使用这些组件。

首先，按照上述方法添加 nsoftware.IPWorks NuGet 包。添加后，在 main 方法中添加一些简单的代码。例如：

using System;
using nsoftware.IPWorks;

namespace MyNetCoreApp
{
  class Program
  {
    static void Main(string[] args)
    {
      Http http = new Http();
      http.Get("https://www.nsoftware.com");
      string myData = http.TransferredData;
      Console.WriteLine("Transfer OK!");
    }
  }
}

要部署，请右键单击 Visual Studio 解决方案资源管理器中的项目，然后选择 Publish...。按照提示创建部署所需的文件。将 bin\Release\PublishOutput 文件夹中的文件复制到 Linux 机器。

要在 Linux 系统上安装组件的试用许可证，请将文件从 C:\Program Files\nsoftware\IPWorks 2016 .NET Edition\lib\netstandard2.0 复制到部署机器并运行：

dotnet ./install-license.dll 

安装试用许可证后，运行编译后的 .NET Core 应用程序：

dotnet ./MyNetCoreApp.dll 

输出应显示为：

许可说明

无论是从 NuGet 安装还是运行 Windows .NET Edition 设置，许可的处理方式都是相同的。

试用许可

要激活试用许可证，请使用 install-license 应用程序。install-license 应用程序是一个包含在工具包中的 .NET Core 控制台应用程序。

如果库是从 NuGet 包安装的，它将位于包安装目录的 tools 文件夹中。

如果库是作为 .NET Edition 安装程序的一部分安装的，它将位于安装目录的 lib/netstandard1.X 文件夹中。

要使用 install-license 应用程序，请运行命令：dotnet ./install-license.dll

在非桌面环境（如通用 Windows 平台 (UWP)、Xamarin.iOS 和 Xamarin.Android）中使用试用许可证时，无需特殊步骤；只需创建并使用组件即可。

UWP Fall Creator's Update 及更高版本 要求将试用许可证包含为嵌入式资源。在 Visual Studio 的解决方案资源管理器中，将现有项添加到项目中，然后添加 %USERPROFILE%\.nsoftware\XXNXA.lic。将文件的 Build Action 属性设置为 Embedded Resource。

许可证激活

在 NuGet 中，您应该会在安装过程中收到安装许可证的提示。在 Windows .NET Edition 设置中，许可证会自动安装。或者，install-license 应用程序是一个包含在工具包中的 .NET Core 控制台应用程序。

如果库是从 NuGet 包安装的，它将位于包安装目录的 tools 文件夹中。

如果库是作为 .NET Edition 的一部分安装的，它将位于安装目录的 lib/netstandard1.X 文件夹中。

要使用 install-license 应用程序，请运行命令：dotnet ./install-license.dll <key>

其中 key 是您的产品密钥。这将在此特定系统上安装许可证。继续阅读部署说明。

部署

在部署应用程序之前，必须设置 RuntimeLicense 属性。要在已正确许可的开发机器上获取此值，请输出该属性的当前值。例如：

Console.WriteLine(component.RuntimeLicense);

这将输出一个长字符串。保存此值并在您的实际应用程序中使用，如下所示：

component.RuntimeLicense = "value_from_above";

注意：对于工具包中包含的所有组件，相同的 RuntimeLicense 属性值都有效。