NET如何快速入门？

为快速开始使用 .NET SDK，请按照如下步骤进行。

步骤 1 创建阿里云账号


为了访问阿里云日志服务，您需要有一个阿里云账号。如果没有，可首先按照如下步骤创建阿里云账号：

1. 访问阿里云 官方网站，单击页面上的 [backcolor=transparent]注册有礼 按钮。
2. 按照屏幕提示完成注册流程并进行实名认证。

为了更好地使用阿里云服务，建议尽快完成实名认证，否则部分阿里云服务将无法使用。具体实名认证流程，请参考 这里。

步骤 2 获取阿里云访问密钥


为了使用 Log Service Java SDK，您必须申请阿里云的 访问密钥。
登录阿里云 密钥管理页面。选择一对用于 SDK 的访问密钥对。如果没有，请创建一对新访问密钥，且保证它处于“启用”状态。有关如何创建访问密钥，参见 创建访问密钥。
该密钥对会在下面的步骤使用，且需要保管好，不能对外泄露。另外，您可以参考 SDK 配置 了解更多 SDK 如何使用访问密钥的信息。

步骤 3 创建一个日志服务项目和日志库


目前，Log Service Java SDK 还无法管理日志项目（project）和日志库（logstore），所以您需要在控制台上创建好日志库后才能使用 SDK 进行操作。
有关如何创建项目和日志库，参见 创建项目 和 创建日志库。

[backcolor=transparent]注意：

• 请确保使用同一阿里云账号获取阿里云访问密钥和创建日志项目及日志库。
• 关于日志的项目、日志库等概念请参考 Log 核心概念。
• Log 的 project 名称为日志服务全局唯一，而 logstore 名称在一个 project 下面唯一。
• Log 的 project 一旦创建则无法更改它的所属区域。目前也不支持在不同阿里云 Region 间迁移 Log project。

步骤 4 安装 .NET 开发环境


目前，日志服务 SDK 支持 .NET 3.5 和 .NET 4.0/4.5 运行环境。为支持日志服务 SDK 开发，建议安装：

• Microsoft .NET Framework 3.5/4.0/4.5 （具体版本依赖于您的程序需要运行的目标环境）
• Visual Studio 2010 及其以后版本

步骤 5 下载并安装日志服务 .NET SDK


搭建好 .NET 开发环境后，您需要安装日志服务的 .NET SDK。具体如下：

1. 下载
   • 通过 Github 下载：https://github.com/aliyun/aliyun-log-csharp-sdk
   • 历史版本下载：从 这里 下载最新的日志服务 .NET SDK 包

解压完整下载的包到指定的目录即可。日志服务 .NET SDK 是一个软件开发包，不需要额外的安装操作。您可以按照下面的步骤直接在自己的 Visual Studio 项目中使用

步骤 6 开始一个新的日志服务 .NET 项目


安装好 .NET 开发环境及日志服务 .NET SDK 后，您就可以开始创建日志服务的 .NET 项目。这里以一个 C# 的 Console 程序（netsdksample45）为例说明整个过程（其他 .NET 语言和程序类型的使用方式类似）：

1. 
   启动 Visual Studio 并创建一个 C# 的 Console 应用程序。命名为 netsdksample45。
2. 
   右键单击新创建的项目，选择 [backcolor=transparent]项目属性(Properties) 菜单项进入项目属性页。然后选择 [backcolor=transparent]应用程序(Application) 标签页，单击 [backcolor=transparent]目标框架（Target Framework） 的下拉框，选中合适的 .NET Framework 目标版本（如下图）。目前日志服务 SDK 仅支持 .NET Framework 3.5/4.0/4.5 三个版本，所以请选择这三个版本中的一个。这里假设选择 .NET Framework 4.5。
   
3. 
   右键单击新建项目的 [backcolor=transparent]依赖模块（References）子目录，选择 [backcolor=transparent]添加依赖（Add Reference…）并添加下载 SDK 中的SLSSDK.dll 文件（如下图）为项目依赖。需要注意的是您必须选择正确版本的 SLSSDK.dll 文件。如果您的程序目标平台为 .NET Framework 4.0/4.5，请选择 SDK 下载包中 net40 子目录下的文件。如果您的程序目标平台为 .NET Framework 3.5，请选择 SDK 下载包中 net35 子目录下的文件。
   
4. 
   如前进入 [backcolor=transparent]项目属性（Properties） 页，添加编译事件（Build Events）来拷贝 .NET SDK 自身所依赖的模块到程序输出路径，如下图所示：
   

   
   [backcolor=transparent]注意：

   • 日志服务 .NET SDK 需要依赖 zlib 库进行压缩处理，为了保证您的程序能够在 32 或者 64 位平台运行，请确保上图中的两个文件都被拷贝到您的程序输出路径，且它们要随您的最终应用程序发布。
   • 具体拷贝的 zlib 库源路径需要依你机器上的路径，请参考上图命令进行适当修改。

利用日志服务 SDK 接口访问阿里云日志服务。运行如下示例即可与日志服务端交互并得到相应输出。