Étape 2 : Catégoriser les propriétés de l’adaptateur et de la connexion

Article
10/14/2023

Étape 2 sur 9

Durée d’exécution : 30 minutes

Dans cette étape, vous mettez à jour les classes EchoAdapterBindingElement et EchoAdapterBindingElementExtensionElement pour affecter une catégorie à vos propriétés d’adaptateur et de connexion. Ce faisant, les propriétés sont regroupées logiquement par catégorie dans les outils Add Adapter Reference Service Plug-in plug-in and Consume Adapter Service Add-in. Par exemple, si vous souhaitez que les propriétés Application, EnableAuthentication et Hostname apparaissent sous la catégorie Connexion , comme indiqué ci-dessous, vous devez affecter la catégorie Connexion à chacune des propriétés Application, EnableAuthentication et Hostname.

Capture d’écran montrant l’onglet Propriétés de l’URI.

De même, si vous souhaitez que les propriétés InboundFileFilter et InboundFleSystemWatcherFolder apparaissent sous la catégorie Entrant , comme indiqué ci-dessous, vous devez affecter la catégorie Entrante à chacune d’elles. Si vous souhaitez que Count et EnableConnectionPooling apparaissent sous la catégorie Misc , vous devez affecter la catégorie Divers à chacune d’elles.

Capture d’écran montrant l’onglet Propriétés de liaison.

Gardez à l’esprit que vous pouvez affecter une propriété avec le nom de catégorie que vous choisissez. Dans cet exemple, étant donné que la propriété EnableConnnectionPooling n’appartient à aucune autre catégorie, nous la classons comme Divers (Divers). En ce qui concerne la propriété InboundFileFilter, étant donné qu’elle est utilisée pendant la gestion entrante dans l’exemple, il est plus approprié d’affecter Inbound à la propriété, plutôt que Divers. Voici la catégorisation de propriété personnalisée complète pour l’adaptateur d’écho.

Propriété	Catégorie
InboundFileFilter	Trafic entrant
InboundFileSystemWatcherFolder	Trafic entrant
Count	Divers
EnableConnectionPooling	Divers
Application	Connexion
Activer l’authentification	Connexion
HostName	Connexion
EchoInUpperCase	Format

En plus de ces modifications, vous modifiez également la méthode Dispose de EchoAdapterHandlerBase.

Pour connaître les propriétés de l’adaptateur exposées par l’adaptateur d’écho, consultez la section Propriétés de l’adaptateur du Tutoriel 1 : Développer l’adaptateur Echo.

Prérequis

Avant de commencer cette étape, vous devez effectuer l’étape 1 : Utiliser l’Assistant Développement d’adaptateur métier WCF pour créer le projet d’adaptateur Echo. Vous devez également être familiarisé avec les System.ServiceModel.Configuration.BindingElementExtensionElement classes et .System.ServiceModel.Configuration.StandardBindingElement

Mettre à jour la méthode EchoAdapterHandlerBase Dispose

Dans Explorateur de solutions, double-cliquez sur le fichier EchoAdapterHandlerBase.cs.

Supprimez l’instruction suivante de la méthode Dispose :

throw new NotImplementedException("The method or operation is not implemented.");

La méthode révisée doit ressembler à ce qui suit :

protected virtual void Dispose(bool disposing)  
{  
   //  
   //TODO: Implement Dispose. Override this method in respective Handler classes  
   //  
}

Mettre à jour la classe de propriétés Adapter

Dans Explorateur de solutions, double-cliquez sur le fichier EchoAdapterBindingElement.cs.
Dans l’éditeur Visual Studio, développez la région Propriétés générées personnalisées .

Pour affecter la catégorie Misc à la propriété Count , ajoutez l’instruction unique suivante au début de l’implémentation count .

[System.ComponentModel.Category("")]

L’implémentation count doit maintenant correspondre à ce qui suit :

[System.ComponentModel.Category("")]  
[System.Configuration.ConfigurationProperty("count", DefaultValue = 5)]  
public int Count  
{  
    get  
    {  
        return ((int)(base["Count"]));  
    }  
    set  
    {  
        base["Count"] = value;  
    }  
}

Pour affecter la catégorie Divers à la propriété EnableConnectionPooling , ajoutez l’instruction unique suivante au début de l’implémentation EnableConnectionPooling .
```
[System.ComponentModel.Category("")]  
```
Pour affecter la catégorie entrante à la propriété InboundFileFilter , ajoutez l’instruction unique suivante au début de l’implémentation InboundFileFilter .
```
[System.ComponentModel.Category("Inbound")]  
```
Pour affecter la catégorie entrante à la propriété inboundFleSystemWatcherFolder , ajoutez l’instruction unique suivante au début de l’implémentation inboundFleSystemWatcherFolder .
```
[System.ComponentModel.Category("Inbound")]  
```

Vérifiez que le code de la région Propriétés générées personnalisées correspond aux éléments suivants :

[System.ComponentModel.Category("")]  
[System.Configuration.ConfigurationProperty("count", DefaultValue = 5)]  
public int Count  
{  
    get  
    {  
        return ((int)(base["Count"]));  
    }  
    set  
    {  
        base["Count"] = value;  
    }  
}  

[System.ComponentModel.Category("")]  
[System.Configuration.ConfigurationProperty("enableConnectionPooling", DefaultValue = true)]  
public bool EnableConnectionPooling  
{  
    get  
    {  
        return ((bool)(base["EnableConnectionPooling"]));  
    }  
    set  
    {  
        base["EnableConnectionPooling"] = value;  
    }  
}  

[System.ComponentModel.Category("Inbound")]  
[System.Configuration.ConfigurationProperty("inboundFileFilter", DefaultValue = "*.txt")]  
public string InboundFileFilter  
{  
    get  
    {  
        return ((string)(base["InboundFileFilter"]));  
    }  
    set  
    {  
        base["InboundFileFilter"] = value;  
    }  
}  

[System.ComponentModel.Category("Inbound")]  
[System.Configuration.ConfigurationProperty("inboundFileSystemWatcherFolder", DefaultValue = "{InboundFileSystemWatcherFolder}")]  
public string InboundFileSystemWatcherFolder  
{  
    get  
    {  
        return ((string)(base["InboundFileSystemWatcherFolder"]));  
    }  
    set  
    {  
        base["InboundFileSystemWatcherFolder"] = value;  
    }  
}  

#endregion Custom Generated Properties

Mettre à jour les propriétés de connexion

Dans Explorateur de solutions, double-cliquez sur le fichier EchoAdapterConnectionUri.cs.
Dans l’éditeur Visual Studio, développez la région Propriétés générées personnalisées .
Pour affecter la catégorie Format à la propriété EchoInUpperCase , ajoutez l’instruction unique suivante au début de l’implémentation d’EchoInUpperCase .
```
[System.ComponentModel.Category("Format")]  
```
Pour affecter la catégorie Connection à la propriété Hostname , ajoutez l’instruction unique suivante au début de l’implémentation du nom d’hôte .
```
[System.ComponentModel.Category("Connection")]  
```
Pour affecter la catégorie Connection à la propriété Application , ajoutez l’instruction unique suivante au début de l’implémentation de l’application .
```
[System.ComponentModel.Category("Connection")]  
```
Pour affecter la catégorie Connexion à la propriété EnableAuthentication , ajoutez l’instruction unique suivante au début de l’implémentation EnableAuthentication .
```
[System.ComponentModel.Category("Connection")]  
```

Vérifiez que le code de la région Propriétés générées personnalisées correspond aux éléments suivants :

#region Custom Generated Properties  
        [System.ComponentModel.Category("Format")]  
        public bool EchoInUpperCase  
        {  
            get  
            {  
                return this.echoInUpperCase;  
            }  
            set  
            {  
                this.echoInUpperCase = value;  
            }  
        }  

        [System.ComponentModel.Category("Connection")]  
        public string Hostname  
        {  
            get  
            {  
                return this.hostname;  
            }  
            set  
            {  
                this.hostname = value;  
            }  
        }  

        [System.ComponentModel.Category("Connection")]  
        public string Application  
        {  
            get  
            {  
                return this.application;  
            }  
            set  
            {  
                this.application = value;  
            }  
        }  

        [System.ComponentModel.Category("Connection")]  
        public bool EnableAuthentication  
        {  
            get  
            {  
                return this.enableAuthentication;  
            }  
            set  
            {  
                this.enableAuthentication = value;  
            }  
        }  
        #endregion Custom Generated Properties

Dans Visual Studio, dans le menu Fichier , cliquez sur Enregistrer tout.

Notes

Vous avez enregistré votre travail. Vous pouvez fermer Visual Studio en toute sécurité à ce stade ou passer à l’étape suivante, Étape 3 : Implémenter la connexion pour l’adaptateur Echo.

Qu’est-ce que je viens de faire ?

Vous venez de mettre à jour des classes pour affecter une catégorie à chaque carte et propriété de connexion exposées par l’adaptateur d’écho.

Étapes suivantes

Vous implémentez des fonctionnalités de connexion, de navigation des métadonnées, de recherche et de résolution, ainsi que l’échange de messages sortants. Enfin, vous générez et déployez l’adaptateur d’écho.

Voir aussi

Étape 3 : Implémenter la connexion pour l’adaptateur Echo
Didacticiel 1 : Développer l’adaptateur Echo

Partager via