DtsTaskAttribute.IconResource Propriedade

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Obtém ou define o ícone associado ao objeto de tarefa.

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

Valor da propriedade

String

Uma cadeia de caracteres que identifica o recurso de ícone da tarefa.

Exemplos

O exemplo a seguir mostra uma classe de tarefa que fornece um recurso de ícone. Neste exemplo, o arquivo de ícone é chamado MyTaskIcon.icoe o nome do assembly é 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  

Comentários

Quando especificada, essa propriedade identifica os ícones mostrados na Caixa de Ferramentas Itens de Fluxo de Controle e na superfície do designer fluxo de controle do pacote quando a tarefa é adicionada a um pacote.

A Caixa de Ferramentas Itens de Fluxo de Controle usa o tipo de imagem 16x16, 16 cores e a superfície do designer de fluxo de dados usa o tipo de imagem 32x32, 16 cores que são os tipos de imagem padrão de ícones criados usando o Visual Studio .NET.

O formato da cadeia de caracteres que identifica o recurso de ícone é uma notação pontilhada que consiste no nome do assembly e no nome do arquivo de ícone, separado por um ponto (.).

Para inserir um arquivo de ícone como um recurso em um assembly usando o .NET do Visual Studio, crie um novo ícone e defina o atributo de Ação de Build do arquivo de ícone como Recurso Inserido na janela Propriedades do Visual Studio.