DtsForEachEnumeratorAttribute Classe

Définition

public ref class DtsForEachEnumeratorAttribute sealed : Microsoft::SqlServer::Dts::Runtime::Localization::DtsLocalizableAttribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=false)]
public sealed class DtsForEachEnumeratorAttribute : Microsoft.SqlServer.Dts.Runtime.Localization.DtsLocalizableAttribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=false)>]
type DtsForEachEnumeratorAttribute = class
    inherit DtsLocalizableAttribute

Public NotInheritable Class DtsForEachEnumeratorAttribute
Inherits DtsLocalizableAttribute

Héritage

Attribute

DtsLocalizableAttribute

DtsForEachEnumeratorAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple de code suivant montre l’attribut appliqué à une nouvelle classe, avec plusieurs propriétés définies, notamment les DisplayName, Description, ForEachEnumeratorContact, et UITypeName.

using System;  
using Microsoft.SqlServer.Dts.Runtime;  

namespace Microsoft.Samples.SqlServer.Dts  
{  
// This attribute marks the class as a managed ForEachEnumerator.  
    [DtsForEachEnumerator(DisplayName = "MyEnumerator",  
      Description="A managed enumerator",  
      UITypeName="<FullyQualifiedTypeName>",  
      ForEachEnumeratorContact="Name of company to contact")]  
    public class MyEnumerator : ForEachEnumerator  
    {  
        // Insert your enumerator code here.  
    }  
}  

Imports System  
Imports Microsoft.SqlServer.Dts.Runtime  

Namespace Microsoft.Samples.SqlServer.Dts  
  ' This attribute marks the class as a managed ForEachEnumerator.  
  <DtsForEachEnumerator(DisplayName:="MyEnumerator", _  
    Description:="A managed enumerator", _  
    UITypeName:="<FullyQualifiedTypeName>", _  
    ForEachEnumeratorContact:="Name of company to contact")> _  
  Public Class MyEnumerator  
    Inherits ForEachEnumerator  
    ' Insert your enumerator code here.  
  End Class  
End Namespace  

Remarques

Cet attribut s’applique à toutes les classes d’énumérateur managé Foreach et identifie la classe comme un énumérateur managé Foreach dans le moteur d’exécution SQL Server (SSIS). Cet attribut fournit des informations grâce à ses propriétés pour contrôler la manière dont le concepteur affiche et interagit avec l’objet. Comme tous les énumérateurs gérés dérivent de la ForEachEnumerator classe de base, la première étape lors de la création d’un énumérateur personnalisé est de créer un projet de bibliothèque de classes et d’hériter de la classe de base. Ensuite, appliquez-le DtsForEachEnumeratorAttribute à la classe. Cet attribut fournit au concepteur le nom, la description et les informations sur le moment de conception de l’interface utilisateur. La UITypeName propriété identifie ce Type qui implémente l’interface utilisateur de l’énumérateur affichée dans l’éditeur ForEachLoop . La DisplayName propriété est affichée dans la boîte à outils dans le SQL Server SQL Server Data Tools (SSDT).

Pour plus d'informations sur l'application d'attributs à une classe, consultez « Application des attributs » dans le Guide du développeur du cadre .NET.

L’attribut est formaté comme une chaîne délimitée par des virgules, qui peut contenir les éléments suivants de la Attributes classe, en plus des autres attributs déclarés sur le DtsForEachEnumeratorAttribute, tels que le UITypeName et le ForEachEnumeratorContact:

• Nom de type

• Nom de l'assemblage

• Version de fichier

• Culture

• Jeton clé publique

La chaîne suivante donne un exemple de la façon dont la chaîne est formatée.

[DtsForEachEnumerator(DisplayName="MyEnumerator",UITypeName="MyNamespace.MyEnumeratorClassName,MyAssemblyName",Version="1.00.000.00",Culture="neutral",PublicKeyToken="")]

Vous pouvez trouver les valeurs des Culture paramètres et PublicKeyToken dans votre assemblage en examinant les propriétés de l’assembleur dans le cache global d’assemblage (GAC).