DtsTaskAttribute.IconResource プロパティ

定義

名前空間:

Microsoft.SqlServer.Dts.Runtime

アセンブリ:

Microsoft.SqlServer.ManagedDTS.dll

タスク オブジェクトに関連付けられたアイコンを取得します。値の設定も可能です。

public:
 property System::String ^ IconResource { System::String ^ get(); void set(System::String ^ value); };

public string IconResource { get; set; }

member this.IconResource : string with get, set

Public Property IconResource As String

プロパティ値

String

タスクのアイコン リソースを識別する文字列です。

例

次の例は、アイコン リソースを提供するタスク クラスを示します。 この例では、アイコン ファイルの名前が MyTaskIcon.ico で、アセンブリ名が MyTask です。

using System;  
using Microsoft.SqlServer.Dts.Runtime;  
namespace Microsoft.SSIS.Samples  
{  
  [DtsTask  
  (  
   DisplayName = "MyTask",  
   IconResource = "MyTask.MyTaskIcon.ico",  
   UITypeName = "My Custom Task," +  
   "Version=1.0.0.0," +  
   "Culture = Neutral," +  
   "PublicKeyToken = 12345abc6789de01",  
   TaskType = "PackageMaintenance",  
   TaskContact = "MyTask; company name; any other information",  
   RequiredProductLevel = DTSProductLevel.None  
   )]  
  public class MyTask : Task  
  {  
    // Your code here.  
  }  
}  

Imports System  
Imports Microsoft.SqlServer.Dts.Runtime  

<DtsTask(DisplayName:="MyTask", _  
 IconResource:="MyTask.MyTaskIcon.ico", _  
 UITypeName:="My Custom Task," & _  
 "Version=1.0.0.0,Culture=Neutral," & _  
 "PublicKeyToken=12345abc6789de01", _  
 TaskType:="PackageMaintenance", _  
 TaskContact:="MyTask; company name; any other information", _  
 RequiredProductLevel:=DTSProductLevel.None)> _  
Public Class MyTask  
  Inherits Task  

  ' Your code here.  

End Class 'MyTask  

注釈

このプロパティを指定すると、タスクがパッケージに追加されるときに、 コントロール フロー項目ツールボックス およびパッケージ コントロール フロー デザイナー画面に表示されるアイコンが識別されます。

コントロール フロー項目ツールボックスでは、16x16、16 色のイメージの種類が使用され、データ フロー デザイナー画面では、Visual Studio .NET を使用して作成されたアイコンの既定のイメージの種類である 32 x 32、16 色のイメージの種類が使用されます。

アイコン リソースを識別する文字列では、アセンブリ名とアイコン ファイルの名前をピリオド (.) で連結したドット区切りの形式が使用されます。

Visual Studio .NET を使用してアイコン ファイルをリソースとしてアセンブリに埋め込むには、新しいアイコンを作成し、Visual Studio の [プロパティ] ウィンドウでアイコン ファイルの [ビルド アクション] 属性を [埋め込みリソース] に設定します。