DatasetDestination 组件示例

DatasetDestination 示例示范了如何实现集成到 Business Intelligence Development Studio 并且可以添加到数据流任务的自定义目标组件。该组件将执行期间接收到的行存储在一个数据集中。在执行结束时，将根据组件的配置，把数据集分配给运行时变量或者同时保存到 XML 文件。从数据集创建的 XML 文件不能用作 XML 源的 XML 源。这样的设计允许在外部保存数据流的执行结果并将结果用作另一个组件的源。基于 Itanium 的操作系统不支持该示例。

重要提示：
Integration Services 数据流编程代码示例旨在阐释创建自定义数据流组件需要实现的核心功能。该示例不包括对“高级编辑器”中的自定义功能的完整支持。例如，您不能使用“高级编辑器”添加或删除输入和输出或者配置列。 提供的示例仅供教学使用。这些示例不是针对生产环境设计的，也没有在生产环境中进行测试。对于这些示例，Microsoft 不提供相关的技术支持。

运行示例

如果已经知道如何查找、生成和安装代码示例，则可以直接转到 测试示例部分，阅读有关如何配置和运行代码示例的信息。

必备组件

此示例要求安装下列组件：

• Microsoft Visual Studio 2005
• Microsoft SQL Server 2005 Integration Services

位置

如果代码示例安装到默认位置，则该示例将位于以下目录中：

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Data Flow\ DataSetDestination Component Sample\

代码示例的 C# 解决方案位于 CS 目录，而 Visual Basic 解决方案位于 VB 目录。

有关安装示例所需的两个步骤的信息，请参阅 安装示例。若要获取示例的最新版本，包括在最初发布 SQL Server 2005 之后发布的新示例，请参阅 SQL Server 2005 示例和示例数据库（2006 年 4 月）。

生成示例

如果尚未在 Samples 文件夹中生成强名称密钥文件，则请使用以下过程生成此密钥文件。将示例项目配置为在生成时使用此密钥文件对程序集进行签名。可以在**“项目属性”对话框的“签名”**选项卡中查看签名属性。

生成强名称密钥文件

1. 若要打开 Microsoft Visual Studio 2005 命令提示，请单击“开始”，依次指向“所有程序”、Microsoft Visual Studio 2005 和“Visual Studio 工具”，然后单击“Visual Studio 2005 命令提示”。

   - 或 -

   若要打开 Microsoft .NET Framework 命令提示，请单击“开始”，依次指向“所有程序”和 Microsoft .NET Framework SDK 2.0，然后单击“SDK 命令提示”。

2. 在命令提示符下，使用更改目录 (CD) 命令将命令提示符窗口的当前文件夹更改为 Samples 文件夹。在此文件夹中创建的密钥文件将由所有 SQL Server 2005 代码示例使用。

   注意：
   若要确定示例所在的文件夹，请单击“开始”，依次指向“所有程序”、Microsoft SQL Server 2005、“文档和教程”，然后单击“示例目录”。如果使用了默认安装位置，则示例将位于 <system_drive>:\Program Files\Microsoft SQL Server\90\Samples 中。

3. 在命令提示符下，运行以下命令以生成密钥文件：

   sn -k SampleKey.snk
   

4. 重要提示 有关强名称密钥对的详细信息，请参阅 MSDN 上 .NET 开发中心中的“安全简讯：.NET Framework 中的强名称和安全性”。

在 Microsoft Visual Studio 2005 中生成示例

1. 从**“文件”|“打开”菜单中，单击“项目”**，然后用首选编程语言打开 DataSetDestination.sln。

2. 在**“生成”菜单上，单击“生成 DatasetDestination”**以生成项目。

安装示例

同时提供此示例的 Visual Basic 和 C# 版本。为了区分每个示例版本的程序集，在输出程序集的名称中追加有 CS 或 VB。成功生成组件后，在 Business Intelligence Development Studio 中按照以下步骤将其添加至数据流任务中。

将组件复制到 PipelineComponents 文件夹

1. 打开 Windows 资源管理器或要在文件系统中使用的首选应用程序。

2. 将程序集（DatasetDestinationCS.dll 或 DatasetDestinationVB.dll）复制到 PipelineComponents 文件夹，该文件夹位于 %system%\Program Files\Microsoft SQL Server\90\DTS。

通过拖放程序集的方式将组件安装到全局程序集缓存 (GAC) 中

1. 打开 Windows 资源管理器或要在文件系统中使用的首选应用程序。

2. 将程序集从 PipelineComponents 文件夹拖放到全局程序集缓存 (GAC) 所在的文件夹，该文件夹位于 %system%\assembly。

使用 gacutil.exe 将组件安装到全局程序集缓存 (GAC) 中

1. 打开命令提示符窗口。

2. 键入以下命令以运行 gacutil.exe，并将 C# 版本的组件安装到 GAC 中：

   gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\DataSetDestinationCS.dll "

   - or -

   键入以下命令以运行 gacutil.exe，并将 Visual Basic 版本的组件安装到 GAC 中： ****

   gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\DataSetDestinationVB.dll "

向工具箱中添加组件

1. 打开 Business Intelligence Development Studio。

2. 右键单击工具箱，然后单击**“选择项”**。

3. 在**“选择工具箱项”对话框中，单击“SSIS 数据流项”**选项卡。

4. 单击组件旁边的复选框，然后单击**“确定”**。

5. 注意 如果组件未显示在列表中，则可以单击**“浏览”**亲自定位组件。但在此情况下，该组件可能未正确安装。

完成这些步骤后，组件将出现在**“工具箱”的“数据流项”**选项卡中，并且可以添加到 SSIS 设计器中的数据流任务。

测试示例

将示例组件添加至包内的数据流任务中后，可以在 SSIS 设计器中配置示例组件。DataSet Destination 组件有三个控制其执行行为的自定义属性。如果保留这些属性的默认值，则该组件将成功执行。这种情况下，在执行结束时不会保存数据集。