La version 4 (V4) du AWS SDK for .NET est en avant-première ! Pour obtenir des informations sur cette nouvelle version en avant-première, consultez le guide du développeur AWS SDK for .NET (version 4).
Veuillez noter que la version V4 du SDK est en cours de prévisualisation, son contenu est donc sujet à modification.
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Migration vers la version 3 du AWS SDK for .NET
Cette rubrique décrit les modifications apportées à la version 3 du SDK AWS SDK for .NET et explique comment migrer votre code vers cette version du SDK.
À propos des AWS SDK for .NET versions
Le AWS SDK for .NET, initialement publié en novembre 2009, a été conçu pour .NET Framework 2.0. Depuis cette version, .NET s'est amélioré avec .NET Framework 4.0 et .NET Framework 4.5, ciblant de nouvelles plateformes : WinRT et Windows Phone.
AWS SDK for .NET la version 2 a été mise à jour pour tirer parti des nouvelles fonctionnalités de la plateforme .NET et pour cibler WinRT et Windows Phone.
AWS SDK for .NET la version 3 a été mise à jour pour rendre les assemblages modulaires.
Refonte de l'architecture du kit SDK
L'ensemble de la version 3 du AWS SDK for .NET est repensé pour être modulaire. Chaque service est désormais implémenté dans son propre assembly, et non dans un seul et même assembly global. Il n'est plus nécessaire d'ajouter l'intégralité AWS SDK for .NET à votre candidature. Vous pouvez désormais ajouter des assemblages uniquement pour les AWS services utilisés par votre application.
Évolutions
Les sections suivantes décrivent les modifications apportées à la version 3 du AWS SDK for .NET.
AWSClientSupprimé en usine
La classe Amazon.AWSClientFactory a été supprimée. Désormais, pour créer le client d'un service, utilisez le constructeur correspondant. Par exemple, pour créer un AmazonEC2Client :
var ec2Client = new Amazon.EC2.AmazonEC2Client();Amazon Runtime. AssumeRoleAWSCredentials Supprimé
La Amazon.Runtime.AssumeRoleAWSCredentials classe a été supprimée car elle se trouvait dans un espace de noms principal mais dépendait du AWS Security Token Service, et parce qu'elle est obsolète dans le SDK depuis un certain temps. Utilisez plutôt la classe Amazon.SecurityToken.AssumeRoleAWSCredentials.
Suppression de la méthode SetACL de S3Link
La S3Link classe fait partie du Amazon.DynamoDBv2 package et est utilisée pour stocker des objets dans Amazon S3 qui sont des références dans un élément DynamoDB. Cette fonctionnalité est utile, mais nous ne voulions pas créer de dépendance de compilation sur le Amazon.S3 package pour DynamoDB. C'est pourquoi nous avons simplifié les méthodes Amazon.S3 exposées de la classe S3Link, remplaçant la méthode SetACL par la méthode MakeS3ObjectPublic. Pour exercer un plus grand contrôle sur la liste de contrôle d'accès (ACL) de l'objet, utilisez directement le package Amazon.S3.
Suppression de classes de résultat obsolètes
Pour la plupart des services du AWS SDK for .NET, les opérations renvoient un objet de réponse contenant les métadonnées de l'opération, telles que l'ID de demande et un objet de résultat. La présence à la fois d'une classe de réponse et d'une classe de résultat était redondante et exigeait plus de saisies des développeurs. Dans la version 2 du AWS SDK for .NET, nous avons placé toutes les informations de la classe de résultat dans la classe de réponse. De même, nous avons marqué les classes de résultat comme étant obsolètes pour dissuader leur utilisation. Dans la version 3 du AWS SDK for .NET, nous avons supprimé ces classes de résultats obsolètes afin de réduire la taille du SDK.
AWS Modifications apportées à la section Config
Il est possible d'effectuer une configuration avancée du fichier AWS SDK for .NET via le Web.config fichier App.config or. Cette opération s'effectue via une section de configuration <aws> telle que celle illustrée ci-dessous, qui fait référence au nom d'assembly du SDK.
<configuration> <configSections> <section name="aws" type="Amazon.AWSSection, AWSSDK"/> </configSections> <aws region="us-west-2"> <logging logTo="Log4Net"/> </aws> </configuration>
Dans la version 3 du AWS SDK for .NET, l'AWSSDKassemblage n'existe plus. Nous avons intégré le code commun dans l'assembly AWSSDK.Core. De ce fait, vous devrez remplacer les références à l'assembly AWSSDK dans votre fichier App.config ou Web.config par des références à l'assembly AWSSDK.Core, comme suit.
<configuration> <configSections> <section name="aws" type="Amazon.AWSSection, AWSSDK.Core"/> </configSections> <aws region="us-west-2"> <logging logTo="Log4Net"/> </aws> </configuration>
Vous pouvez également manipuler les paramètres de configuration à l'aide de la classe Amazon.AWSConfigs. Dans la version 3 du AWS SDK for .NET, nous avons déplacé les paramètres de configuration de DynamoDB de Amazon.AWSConfigs la classe vers la classe. Amazon.AWSConfigsDynamoDB
