のバージョン 4 (V4) SDK for .NET はプレビュー中です。プレビューでこの新しいバージョンに関する情報を確認するには、 AWS SDK for .NET (バージョン 4 プレビュー) デベロッパーガイドを参照してください。
SDK の V4 はプレビュー中であるため、コンテンツは変更される可能性があることに注意してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
のバージョン 3 への移行 AWS SDK for .NET
このトピックでは、 のバージョン 3 の変更 AWS SDK for .NET と、コードをこのバージョンの SDK に移行する方法について説明します。
AWS SDK for .NET バージョンについて
2009 年 11 月に AWS SDK for .NETリリースされた は、.NET Framework 2.0 用に設計されています。このリリース以降、.NET は .NET Framework 4.0 および .NET Framework 4.5 で改善され、新しい対象プラットフォームとして WinRT と Windows Phone が追加されています。
AWS SDK for .NET バージョン 2 が更新され、.NET プラットフォームの新機能を活用し、WinRT と Windows Phone をターゲットにしました。
AWS SDK for .NET バージョン 3 が更新され、アセンブリがモジュール化されました。
SDK のアーキテクチャの再設計
のバージョン 3 全体がモジュール式に再設計 AWS SDK for .NET されました。1 つの大きなアセンブリとしてではなく、各サービスが個別のアセンブリとして実装されます。アプリケーション全体に を追加する必要はありません AWS SDK for .NET 。アプリケーションが使用する AWS サービスに対してのみアセンブリを追加できるようになりました。
重要な変更
以下のセクションでは、バージョン 3 の AWS SDK for .NETへの変更点について説明します。
AWSClientFactory の削除
Amazon.AWSClientFactory
クラスは削除されました。現在、サービスクライアントを作成するには、サービスクライアントのコンストラクタを使用します。たとえば、AmazonEC2Client
を作成するには:
var ec2Client = new Amazon.EC2.AmazonEC2Client();
Amazon.Runtime.AssumeRoleAWSCredentials の削除
Amazon.Runtime.AssumeRoleAWSCredentials
クラスは、コア名前空間にあったが に依存していたこと AWS Security Token Service、および SDK でしばらく古くなっているため、削除されました。代わりに、Amazon.SecurityToken.AssumeRoleAWSCredentials
クラスを使用してください。
S3Link からの SetACL メソッドの削除
S3Link
クラスは Amazon.DynamoDBv2
パッケージの一部であり、DynamoDB 項目内の参照であるオブジェクトを Amazon S3 に保存するために使用されています。これは便利な機能ですが、Amazon.S3
パッケージに DynamoDB に対するコンパイル依存関係を作成するのは好ましくありませんでした。結果として、S3Link
クラスで公開されている Amazon.S3
メソッドを簡素化し、SetACL
メソッドを MakeS3ObjectPublic
メソッドに置き換えました。オブジェクトでアクセスコントロールリスト (ACL) を細かく制御する場合は、Amazon.S3
パッケージを使用します。
サポートされなくなった結果クラスの削除
のほとんどのサービスでは AWS SDK for .NET、 オペレーションは、リクエスト ID や結果オブジェクトなど、オペレーションのメタデータを含むレスポンスオブジェクトを返します。応答クラスと結果クラスを分けておくと、冗長であり、開発者は余分な入力が必要でした。のバージョン 2 では AWS SDK for .NET、結果クラス内のすべての情報をレスポンスクラスに配置します。また、結果クラスをサポート対象外として、その使用を非推奨にしました。のバージョン 3 では AWS SDK for .NET、SDK のサイズを小さくするために、これらの古い結果クラスを削除しました。
AWS Config セクションの変更
App.config
または Web.config
ファイル AWS SDK for .NET を使用して、 の高度な設定を行うことができます。これは、SDK アセンブリ名を参照する、次のような <aws>
config セクションを通じて行います。
<configuration> <configSections> <section name="aws" type="Amazon.AWSSection, AWSSDK"/> </configSections> <aws region="us-west-2"> <logging logTo="Log4Net"/> </aws> </configuration>
のバージョン 3 では AWS SDK for .NET、AWSSDK
アセンブリは存在しなくなりました。共通コードは AWSSDK.Core
に格納しました。そのため、App.config
ファイルまたは Web.config
ファイルでの AWSSDK
アセンブリへの参照を、次のように AWSSDK.Core
アセンブリを参照するように変更する必要があります。
<configuration> <configSections> <section name="aws" type="Amazon.AWSSection, AWSSDK.Core"/> </configSections> <aws region="us-west-2"> <logging logTo="Log4Net"/> </aws> </configuration>
また、Amazon.AWSConfigs
クラスで構成設定を操作できます。のバージョン 3 では AWS SDK for .NET、DynamoDB の設定を Amazon.AWSConfigs
クラスから Amazon.AWSConfigsDynamoDB
クラスに移動しました。