A versão 4 (V4) do SDK para .NET está em pré-visualização! Para ver informações sobre essa nova versão na versão prévia, consulte o Guia do desenvolvedor AWS SDK para .NET (versão 4).
Observe que a V4 do SDK está em versão prévia, portanto, seu conteúdo está sujeito a alterações.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Migrando para a versão 3 do AWS SDK para .NET
Este tópico descreve as alterações na versão 3 do AWS SDK para .NET e como migrar seu código para essa versão do SDK.
Sobre as AWS SDK para .NET versões
O AWS SDK para .NET, lançado originalmente em novembro de 2009, foi projetado para o.NET Framework 2.0. Desde o lançamento, o .NET foi aperfeiçoado com o .NET Framework 4.0 e o .NET Framework 4.5, e adicionou novas plataformas de destino: WinRT e Windows Phone.
AWS SDK para .NET a versão 2 foi atualizada para aproveitar os novos recursos da plataforma do.NET e ter como alvo o WinRT e o Windows Phone.
AWS SDK para .NET a versão 3 foi atualizada para tornar as montagens modulares.
Redefinição da arquitetura para o SDK
Toda a versão 3 do AWS SDK para .NET foi redesenhada para ser modular. Agora, cada serviço está implementado em seu próprio conjunto, em vez de um único conjunto global. Você não precisa mais adicionar o todo AWS SDK para .NET ao seu aplicativo. Agora você pode adicionar assemblies somente para os AWS serviços que seu aplicativo usa.
Alterações significativas
As seções a seguir descrevem as alterações na versão 3 do AWS SDK para .NET.
AWSClientRemovido de fábrica
A classe Amazon.AWSClientFactory
foi removida. Agora, para criar um cliente de serviço, use o construtor do cliente de serviço. Por exemplo, para criar um AmazonEC2Client
:
var ec2Client = new Amazon.EC2.AmazonEC2Client();
Amazon.Runtime. AssumeRoleAWSCredentials Removido
A Amazon.Runtime.AssumeRoleAWSCredentials
classe foi removida porque estava em um namespace principal, mas dependia do AWS Security Token Service, e porque está obsoleta no SDK há algum tempo. No lugar, use a classe Amazon.SecurityToken.AssumeRoleAWSCredentials
.
Método SetACL removido da S3Link
A classe S3Link
faz parte do pacote Amazon.DynamoDBv2
e é usada para armazenar objetos no Amazon S3 que são referências em um item do DynamoDB. Este é um atributo útil, mas não queríamos criar uma dependência de compilação no pacote Amazon.S3
para o DynamoDB. Consequentemente, simplificamos os métodos Amazon.S3
expostos da classe S3Link
, substituindo o método SetACL
pelo método MakeS3ObjectPublic
. Para obter mais controle sobre a lista de controle de acesso (ACL) no objeto, use o pacote Amazon.S3
diretamente.
Remoção de classes de resultados obsoletas
Para a maioria dos serviços no AWS SDK para .NET, as operações retornam um objeto de resposta que contém metadados para a operação, como o ID da solicitação e um objeto de resultado. Ter classes de resultados e respostas separadas era redundante e gerava linhas extras para os desenvolvedores. Na versão 2 do AWS SDK para .NET, colocamos todas as informações da classe de resultados na classe de resposta. Também marcamos as classes de resultados como obsoletas para desencorajar o seu uso. Na versão 3 do AWS SDK para .NET, removemos essas classes de resultados obsoletas para ajudar a reduzir o tamanho do SDK.
AWS Alterações na seção Config
É possível fazer a configuração avançada do AWS SDK para .NET por meio do Web.config
arquivo App.config
ou. Faça isso por meio de uma seção de configuração da <aws>
como a seguinte, que faz referência ao nome do conjunto do SDK.
<configuration> <configSections> <section name="aws" type="Amazon.AWSSection, AWSSDK"/> </configSections> <aws region="us-west-2"> <logging logTo="Log4Net"/> </aws> </configuration>
Na versão 3 do AWS SDK para .NET, a AWSSDK
montagem não existe mais. Colocamos o código comum no conjunto AWSSDK.Core
. Como resultado, será necessário alterar as referências ao conjunto AWSSDK
nos arquivos App.config
ou Web.config
para o conjunto AWSSDK.Core
, como mostrado a seguir.
<configuration> <configSections> <section name="aws" type="Amazon.AWSSection, AWSSDK.Core"/> </configSections> <aws region="us-west-2"> <logging logTo="Log4Net"/> </aws> </configuration>
Também é possível manipular as definições de configuração com a classe Amazon.AWSConfigs
. Na versão 3 do AWS SDK para .NET, movemos as configurações do DynamoDB da classe para Amazon.AWSConfigs
a classe. Amazon.AWSConfigsDynamoDB