Comme décrit précédemment, toutes les informations de configuration de l'application WCF qui sont normalement contenues dans le fichier web.config ont été encapsulées dans le contrôle WcfConfig. Toutefois, quasiment la totalité de ces propriétés sont exposées de manière à ce qu'elles puissent être modifiées en fonction des besoins de votre implémentation. Deux exceptions importantes sont la version de sécurité du message, qui est toujours MessageSecurityVersion.WSSecurity11WSTrust13WSSecureConversation13WSSecurityPolicy12BasicSecurityProfile10, et le transport, qui est toujours HTTPS, et non HTTP. Sinon, le contrôle comporte un certain nombre de propriétés qui peuvent être utiles à un peu mieux connaître dans le cadre de votre implémentation (malgré, qu'en règle générale, vous n'avez pas besoin de les modifier).

En premier lieu, il existe cinq propriétés en lecture seule pour exposer les objets de configuration de niveau supérieur utilisés dans la configuration. Par « lecture seule », je veux dire que les objets eux-mêmes sont en lecture seule, mais que vous pouvez définir leurs propriétés individuelles si vous manipulez le contrôle par programmation. Ces cinq propriétés sont :

SecurityBindingElement SecurityBinding

BinaryMessageEncodingBindingElement BinaryMessage

HttpsTransportBindingElement SecureTransport

WS2007FederationHttpBinding FedBinding

EndpointAddress WcfEndpointAddress

Les autres propriétés peuvent toutes être configurées dans la balise de contrôle qui est ajoutée à la page de dispositions aspx. Pour ces propriétés, j'ai utilisé une convention de nommage qui, je l'espérais, aurait un sens pour les valeurs de propriétés composées. Par exemple, la propriété SecurityBinding a une propriété appelée LocalClient, qui a elle-même une propriété booléenne appelée CacheCookies. Pour rendre tout cela le plus facile à comprendre et à utiliser que possible, j'ai juste créé une propriété appelée SecurityBindingLocalClientCacheCookies. Vous verrez plusieurs propriétés comme ça, et c'est également une piste pour vous aider à trouver la propriété adéquate si vous êtes en train d'examiner le SDK du framework .NET et que vous vous demandez comment vous pouvez modifier certaines de ces valeurs de propriétés dans l'implémentation de la classe de base. Voici la liste complète des propriétés :

SecurityAlgorithmSuite SecurityBindingDefaultAlgorithmSuite

SecurityHeaderLayout SecurityBindingSecurityHeaderLayout

SecurityKeyEntropyMode SecurityBindingKeyEntropyMode

bool SecurityBindingIncludeTimestamp

bool SecurityBindingLocalClientCacheCookies

bool SecurityBindingLocalClientDetectReplays

int SecurityBindingLocalClientReplayCacheSize

int SecurityBindingLocalClientMaxClockSkew

int SecurityBindingLocalClientMaxCookieCachingTime

int SecurityBindingLocalClientReplayWindow

int SecurityBindingLocalClientSessionKeyRenewalInterval

int SecurityBindingLocalClientSessionKeyRolloverInterval

bool SecurityBindingLocalClientReconnectTransportOnFailure

int SecurityBindingLocalClientTimestampValidityDuration

int SecurityBindingLocalClientCookieRenewalThresholdPercentage

bool SecurityBindingLocalServiceDetectReplays

int SecurityBindingLocalServiceIssuedCookieLifetime

int SecurityBindingLocalServiceMaxStatefulNegotiations

int SecurityBindingLocalServiceReplayCacheSize

int SecurityBindingLocalServiceMaxClockSkew

int SecurityBindingLocalServiceNegotiationTimeout

int SecurityBindingLocalServiceReplayWindow

int SecurityBindingLocalServiceInactivityTimeout

int SecurityBindingLocalServiceSessionKeyRenewalInterval

int SecurityBindingLocalServiceSessionKeyRolloverInterval

bool SecurityBindingLocalServiceReconnectTransportOnFailure

int SecurityBindingLocalServiceMaxPendingSessions

int SecurityBindingLocalServiceMaxCachedCookies

int SecurityBindingLocalServiceTimestampValidityDuration

int BinaryMessageMaxReadPoolSize

int BinaryMessageMaxWritePoolSize

int BinaryMessageMaxSessionSize

int BinaryMessageReaderQuotasMaxDepth

int BinaryMessageReaderQuotasMaxStringContentLength

int BinaryMessageReaderQuotasMaxArrayLength

int BinaryMessageReaderQuotasMaxBytesPerRead

int BinaryMessageReaderQuotasMaxNameTableCharCount

System.Net.AuthenticationSchemes SecureTransportAuthenticationScheme

System.ServiceModel.HostNameComparisonMode SecureTransportHostNameComparisonMode

System.Net.AuthenticationSchemes SecureTransportProxyAuthenticationScheme

System.ServiceModel.TransferMode SecureTransportTransferMode

bool SecureTransportManualAddressing

long SecureTransportMaxBufferPoolSize

long SecureTransportMaxReceivedMessageSize

bool SecureTransportAllowCookies

bool SecureTransportBypassProxyOnLocal

bool SecureTransportKeepAliveEnabled

int SecureTransportMaxBufferSize

string SecureTransportRealm

bool SecureTransportUnsafeConnectionNtlmAuthentication

bool SecureTransportUseDefaultWebProxy

bool SecureTransportRequireClientCertificate

HostNameComparisonMode FedBindingHostNameComparisonMode

WSMessageEncoding FedBindingMessageEncoding

Encoding FedBindingTextEncoding

SecurityAlgorithmSuite FedBindingSecurityMessageAlgorithmSuite

SecurityKeyType FedBindingSecurityMessageIssuedKeyType

bool FedBindingSecurityMessageNegotiateServiceCredential

int FedBindingCloseTimeout

int FedBindingOpenTimeout

int FedBindingReceiveTimeout

int FedBindingSendTimeout

bool FedBindingBypassProxyOnLocal

bool FedBindingTransactionFlow

long FedBindingMaxBufferPoolSize

long FedBindingMaxReceivedMessageSize

bool FedBindingUseDefaultWebProxy

int FedBindingReaderQuotasMaxDepth

int FedBindingReaderQuotasMaxStringContentLength

int FedBindingReaderQuotasMaxArrayLength

int FedBindingReaderQuotasMaxBytesPerRead

int FedBindingReaderQuotasMaxNameTableCharCount

bool FedBindingReliableSessionOrdered

int FedBindingReliableSessionInactivityTimeout

bool FedBindingReliableSessionEnabled

Une fois encore, ces propriétés ont toutes été créées de manière à pouvoir être modifiées directement dans la balise de contrôle de la page de dispositions aspx. Par exemple, voici comment vous auriez défini la propriété FedBindingUseDefaultWebProxy :

<AzWcf:WcfDataControl runat="server" id="wcf" WcfUrl="https://azurewcf.vbtoys.com/Customers.svc" OutputType="Page" MethodName="GetAllCustomersHtml" FedBindingUseDefaultWebProxy="true" />

Les autres propriétés du contrôle sont conçues afin de contrôler comment il est utilisé. Bien qu'il y ait une liste des propriétés qui soit plutôt longue, notez qu'elles sont principalement dans le cadre d'une certaine souplesse d'utilisation - dans un cas de figure simple, vous n'aurez qu'une ou deux propriétés à définir, ou encore, simplement les définir dans le web part qui sera décrit dans la quatrième partie de cette série. Voici une liste de chaque propriété avec une courte description de chacune.

string WcfUrl - c'est l'URL du point de terminaison de service WCF, c'est-à-dire https://azurewcf.vbtoys.com/Customers.svc.

string MethodName - c'est le nom de la méthode qui doit être appelée lorsque la page est demandée. Vous pouvez affecter cette propriété la méthode qui sera appelée par défaut à cette propriété. Par ailleurs, vous pouvez également affecter la valeur false à la propriété AllowQueryStringOverride, ce qui limitera la page à utiliser uniquement la propriété MethodName que vous définissez dans la balise de contrôle. Cette propriété peut être définie via une chaîne de requête en utilisant le web part du CASI Kit.

string MethodParams - c'est la liste de valeurs de paramètre séparées par des points-virgules et qui doivent être passées à l'appel de méthode. Elles doivent être dans le même ordre qu'elles apparaissent dans la signature de méthode. Comme expliqué dans la deuxième partie de la série, les valeurs de paramètre ne prennent en charge que les types de données simples, tels que string, bool, int et datetime. Si vous souhaitez passer davantage d'objets plus complexes en tant que paramètres de méthode, il vous faut alors définir le paramètre en tant que chaîne, et dé-sérialiser votre objet en XML avant d'appeler la méthode, ensuite dans votre application WCF, vous pouvez ré-sérialiser la chaîne en instance d'objet. Toutefois, si vous passez cela en tant que paramètre de chaîne de requête, vous serez limité par la longueur maximale de chaîne de requête prise en charge par votre navigateur et IIS. Cette propriété peut être définie via une chaîne de requête en utilisant le web part du CASI Kit.

object WcfClientProxy - la propriété WcfClientProxy est ce qui sert en fait à effectuer l'appel à l'application WCF. Elle doit être configurée pour prendre en charge le passage du jeton d'utilisateur avec l'appel, c'est la raison pour laquelle la dernière partie du code de configuration que vous écrivez dans votre contrôle personnalisé dans le cadre de la substitution d'ExecuteRequest doit affecter à cet objet proxy le proxy d'application de service que vous avez créé et configuré pour utiliser les informations d'identification du client actuel.

string QueryResultsString - cette propriété contient une représentation sous forme de chaîne des résultats renvoyés à partir de l'appel de méthode. Si votre méthode WCF renvoie un type de données simple tel que bool, int, string ou datetime, alors la valeur de cette propriété correspondra à la valeur de retour ToString(). Si votre méthode WCF renvoie une classe personnalisée ça passe aussi - lorsque la classe de base reçoit la valeur de retour, elle la dé-sérialise en une chaîne de sorte que vous ayez une représentation XML des données.

object QueryResultsObject - cette propriété contient une représentation sous forme d'objet des résultats renvoyés à partir de l'appel de méthode. Elle est utile lorsque vous utilisez le contrôle par programmation. Par exemple, si vous utilisez le contrôle pour récupérer des données à stocker dans le cache ASP.NET, ou à être utilisées dans un travail du minuteur SharePoint, la propriété QueryResultsObject dispose exactement de ce que l'appel de méthode WCF a renvoyé. S'il s'agit d'une classe personnalisée, il vous suffit alors d'effectuer un transtypage des résultats de cette propriété vers le type de classe approprié afin de pouvoir l'utiliser.

DataOutputType OutputType - la propriété OutputType est une énumération qui peut avoir l'une des quatre valeurs suivantes : Page, ServerCache, Both ou None. Si vous utilisez le contrôle dans la page de dispositions et que vous allez effectuer le rendu des résultats avec le web part, alors OutputType doit avoir la valeur Page ou Both. Si vous souhaitez récupérer les données et les stocker dans le cache ASP.NET, alors vous devriez utiliser la valeur ServerCache ou Both. Il est à noter que lors du stockage des résultats dans le cache, seul QueryResultsObject est stocké. Évidemment, la valeur Both va effectuer le rendu des données et stocker ces dernières dans le cache ASP.NET. Si vous utilisez simplement le contrôle par programmation dans quelque chose comme un travail du minuteur SharePoint, alors vous pouvez affecter la valeur None à cette propriété, car vous allez simplement lire QueryResultsString ou QueryResultsObject après l'appel de la méthode ExecuteRequest. Cette propriété peut être définie via une chaîne de requête en utilisant le web part du CASI Kit.

string ServerCacheName - si vous choisissez une valeur ServerCache ou Both pour OutputType, il vous faut alors affecter une valeur de chaîne non vide à la propriété ServerCacheName, sinon une exception sera levée. C'est la clé qui sera utilisée pour stocker les résultats dans le cache ASP.NET. Par exemple, si vous affectez « MyFooProperty » à la propriété ServerCacheName, alors après l'appel de la méthode ExecuteRequest, vous pouvez récupérer l'objet qui a été renvoyé à partir de l'application WCF en faisant référence à HttpContext.Current.Cache["MyFooProperty"]. Cette propriété peut être définie via une chaîne de requête en utilisant le web part du CASI Kit.

int ServerCacheTime - c'est le temps, en minutes, qu'un élément ajouté au cache ASP.NET doit être conservé. Si vous affectez la valeur ServerCache ou Both à la propriété OutputType, alors vous devez également affecter une valeur non zéro à cette propriété, sinon une exception sera levée. Cette propriété peut être définie via une chaîne de requête en utilisant le web part du CASI Kit.

bool DecodeResults - cette propriété est fournie au cas où votre application WCF renverrait des résultats HtmlEncoded. Si vous affectez la valeur true à cette propriété, alors HtmlDecoding sera appliqué aux résultats. Dans la plupart des cas, cela n'est pas nécessaire. Cette propriété peut être définie via une chaîne de requête en utilisant le web part du CASI Kit.

string SharePointClaimsSiteUrl - cette propriété est fournie principalement pour les scénarios où vous êtes en train de créer le contrôle par programmation en dehors d'une requête Http, telle que dans le cas d'un travail du minuteur SharePoint. Par défaut, lorsqu'une requête est effectuée via le web part, la classe de base va utiliser l'URL du site actuel pour se connecter au point de terminaison du Security Token Service de SharePoint afin de fournir le jeton d'utilisateur à l'appel WCF. Toutefois, si vous avez créé le contrôle par programmation et que vous n'avez aucun contexte Http, vous pouvez affecter à cette propriété l'URL d'un site SharePoint sécurisé prenant en charge les revendications, et ce site sera utilisé pour accéder au Security Token Service de SharePoint. Ainsi, par exemple, vous ne devriez jamais avoir à définir cette propriété dans la balise de contrôle de la page de dispositions parce que vous disposerez toujours d'un contexte Http en appelant cette page.

bool AllowQueryStringOverride - cette propriété permet aux administrateurs de verrouiller efficacement une balise de contrôle dans la page de dispositions. Si AllowQueryStringOverride est affectée la valeur false, alors toutes les valeurs de substitution de chaîne de requête qui sont passées à partir du web part du CASI Kit seront ignorées.

string AccessDeniedMessage - il s'agit du message d'erreur « Access Denied » qui devrait être affiché dans le web part du CASI Kit si l'accès est refusé à l'utilisateur pour une méthode particulière. À titre d'exemple, comme expliqué dans la deuxième partie de cette série, si nous passons le jeton de l'utilisateur avec l'appel WCF, nous pouvons « décorer » les méthodes avec une demande PrincipalPermission, telle que « Cet utilisateur doit faire partie du groupe des responsables des ventes ». Si un utilisateur ne répond pas aux exigences d'une demande PrincipalPermission, alors l'appel WCF échouera avec une erreur de refus d'accès. Dans ce cas, le web part affichera quel que soit sera l'AccessDeniedMessage. Notez que vous pouvez utiliser une mise en forme enrichie dans ce message, pour effectuer des choses telles que définir la police en gras ou en rouge en utilisant des balises HTML (c'est-à-dire, <font color='red'>Accès refusé : veuillez contacter votre administrateur</font>). Cette propriété peut être définie via une chaîne de requête en utilisant le web part du CASI Kit.

string TimeoutMessage - c'est le message qui sera affiché dans le web part du CASI Kit, s'il y une erreur de délai d'attente lors de la tentative d'exécution de l'appel de méthode WCF. Elle prend également en charge la mise en forme enrichie, telle que la définition d'une police en gras, en rouge, etc. Cette propriété peut être définie via une chaîne de requête en utilisant le web part du CASI Kit.

L'ensemble des propriétés suivantes a été ajouté afin de vous aider à faire du débogage à partir du web part proprement dit.

bool ReturnDiagnosticsInformation - cette propriété contrôle si des informations de diagnostic seront renvoyées à l'appelant. Puisqu'elle pourrait contenir des informations qui pourraient être considérées comme étant sensibles - telles que le nom du serveur sur lequel la demande fut exécutée - vous pouvez lui affecter une valeur false pour empêcher un retour des informations dans le web part.

string ExecutionServerName - c'est le nom du serveur sur lequel la demande a été exécutée. Si vous avez des soucis avec la demande, vous pouvez alors utilisez ces informations pour savoir sur quel serveur vous voudrez peut-être consulter les journaux du service ULS.

string ExecutionErrorMessage - contient tous les messages d'erreurs qui sont survenus pendant l'exécution de l'appel de méthode WCF.

string TraceInfoMessage - cette propriété inclut les informations de traçage à propos de la demande qui a été effectuée. Par exemple, elle inclut le nom de la méthode, les paramètres de méthode, l'URL WCF qui a été utilisée, etc.