null 許容参照型の注釈の変更

ASP.NET Core 5.0 以降では、コードの一部に null 許容注釈が適用されています。 この作業の最初から、これらの注釈に 誤りが予想され 、修正が必要になります。 ASP.NET Core 6.0 では、以前に適用された注釈の一部が更新されています。 これらの変更の一部は、ソース破壊的変更と見なされます。 この変更により、API に互換性がない、または制限が厳しくなっています。 更新された API は、null 許容参照型が有効になっているプロジェクトで使用すると、ビルド時の警告が発生する可能性があります。

詳細については、GitHub の 問題 dotnet/aspnetcore#27564 を参照してください。

導入されたバージョン

ASP.NET Core 6.0

以前の動作

影響を受けている API は、null 許容参照型の注釈に誤りがあります。 ビルド警告が存在しないか、誤っています。

新しい動作

新しいビルド警告が生成されます。 影響を受ける API に対して正しくないビルド警告が生成されなくなりました。

変更の理由

フィードバックとさらなるテストにより、影響を受ける API の null 許容注釈は不正確であると判断されました。 更新された注釈は、API の null 許容コントラクトを正しく表すようになりました。

推奨されるアクション

変更された null 許容コントラクトを反映するように、これらの API を呼び出すコードを更新します。

影響を受ける API

• ParameterView.FromDictionary
• Renderer.DispatchEventAsync
• RenderTreeEdit.RemovedAttributeName
• AuthenticationSchemeOptions.ForwardDefaultSelector
• RangeConditionHeaderValue.RangeConditionHeaderValue
• IConnectionListener.AcceptAsync
• IApplicationDiscriminator.Discriminator
• DataProtectionOptions.ApplicationDiscriminator
• AuthenticatedEncryptorFactory.CreateEncryptorInstance
• CngCbcAuthenticatedEncryptorFactory.CreateEncryptorInstance
• CngGcmAuthenticatedEncryptorFactory.CreateEncryptorInstance
• IAuthenticatedEncryptorFactory.CreateEncryptorInstance
• ManagedAuthenticatedEncryptorFactory.CreateEncryptorInstance
• IKey.CreateEncryptor
• KeyManagementOptions.AuthenticatedEncryptorConfiguration
• KeyManagementOptions.XmlEncryptor
• KeyManagementOptions.XmlRepository
• ICertificateResolver.ResolveCertificate
• DataProtectionUtilityExtensions.GetApplicationUniqueIdentifier
• FileSystemXmlRepository.DefaultKeyStorageDirectory
• RegistryXmlRepository.DefaultRegistryKey
• CertificateResolver.ResolveCertificate
• Endpoint.Endpoint
• Endpoint.RequestDelegate
• RouteValueDictionary.TryAdd
• LinkGenerator.GetUriByAddress
• IFeatureCollection.Set
• FeatureCollection.Set
• IFeatureCollection.Get
• ITicketStore.RetrieveAsync
• IFeatureCollection.Get<TFeature>()
• IFeatureCollection.Set<TFeature>(TFeature)
• FeatureCollection.Set<TFeature>(TFeature)
• ModelStateDictionary.SetModelValue(String, Object, String)
• ModelStateDictionary.Item[String]
• ClientValidatorItem.ClientValidatorItem
• ClientValidatorItem.Validator
• Endpoint.Endpoint
• RouteValueDictionary.TryAdd(String, Object)>
• LinkGenerator.GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)
• IApplicationDiscriminator.Discriminator
• DataProtectionOptions.ApplicationDiscriminator
• AuthenticatedEncryptorFactory.CreateEncryptorInstance(IKey)
• CngCbcAuthenticatedEncryptorFactory.CreateEncryptorInstance(IKey)
• CngGcmAuthenticatedEncryptorFactory.CreateEncryptorInstance(IKey)
• IAuthenticatedEncryptorFactory.CreateEncryptorInstance(IKey)
• ManagedAuthenticatedEncryptorFactory.CreateEncryptorInstance(IKey)
• IKey.CreateEncryptor()
• KeyManagementOptions.AuthenticatedEncryptorConfiguration
• KeyManagementOptions.XmlEncryptor
• KeyManagementOptions.XmlRepository
• ICertificateResolver.ResolveCertificate(String)
• DataProtectionUtilityExtensions.GetApplicationUniqueIdentifier(IServiceProvider)
• FileSystemXmlRepository.DefaultKeyStorageDirectory
• RegistryXmlRepository.DefaultRegistryKey
• CertificateResolver.ResolveCertificate(String)
• IConnectionListener.AcceptAsync(CancellationToken)
• AuthenticationSchemeOptions.ForwardDefaultSelector
• RangeConditionHeaderValue.RangeConditionHeaderValue(EntityTagHeaderValue)
• IHttpContextFeature.HttpContext
• CompletionMessage.WithError
• CompletionMessage.WithResult
• HubMethodInvocationMessage.Arguments
• HubMethodInvocationMessage.HubMethodInvocationMessage(String, String, Object[])
• HubMethodInvocationMessage.HubMethodInvocationMessage(String, String, Object[], String[])
• InvocationMessage.InvocationMessage(String, Object[])
• InvocationMessage.InvocationMessage(String, String, Object[])
• InvocationMessage.InvocationMessage(String, String, Object[], String[])
• StreamInvocationMessage.StreamInvocationMessage(String, String, Object[])
• StreamInvocationMessage.StreamInvocationMessage(String, String, Object[], String[])
• IHubProtocol.TryParseMessage(ReadOnlySequence<Byte>, IInvocationBinder, HubMessage)
• DefaultHubLifetimeManager<THub>.SendAllAsync(String, Object[], CancellationToken)
• DefaultHubLifetimeManager<THub>.SendAllExceptAsync(String, Object[], IReadOnlyList<String>, CancellationToken)
• DefaultHubLifetimeManager<THub>.SendConnectionAsync(String, String, Object[], CancellationToken)
• DefaultHubLifetimeManager<THub>.SendConnectionsAsync(IReadOnlyList<String>, String, Object[], CancellationToken)
• DefaultHubLifetimeManager<THub>.SendGroupAsync(String, String, Object[], CancellationToken)
• DefaultHubLifetimeManager<THub>.SendGroupExceptAsync(String, String, Object[], IReadOnlyList<String>, CancellationToken)
• DefaultHubLifetimeManager<THub>.SendGroupsAsync(IReadOnlyList<String>, String, Object[], CancellationToken)
• DefaultHubLifetimeManager<THub>.SendUserAsync(String, String, Object[], CancellationToken)
• DefaultHubLifetimeManager<THub>.SendUsersAsync(IReadOnlyList<String>, String, Object[], CancellationToken)
• DefaultHubLifetimeManager<THub>.SendAllAsync(String, Object[], CancellationToken)
• DefaultHubLifetimeManager<THub>.SendAllExceptAsync(String, Object[], IReadOnlyList<String>, CancellationToken)
• DefaultHubLifetimeManager<THub>.SendConnectionAsync(String, String, Object[], CancellationToken)
• DefaultHubLifetimeManager<THub>.SendConnectionsAsync(IReadOnlyList<String>, String, Object[], CancellationToken)
• DefaultHubLifetimeManager<THub>.SendGroupAsync(String, String, Object[], CancellationToken)
• DefaultHubLifetimeManager<THub>.SendGroupExceptAsync(String, String, Object[], IReadOnlyList<String>, CancellationToken)
• DefaultHubLifetimeManager<THub>.SendGroupsAsync(IReadOnlyList<String>, String, Object[], CancellationToken)
• DefaultHubLifetimeManager<THub>.SendUserAsync(String, String, Object[], CancellationToken)
• DefaultHubLifetimeManager<THub>.SendUsersAsync(IReadOnlyList<String>, String, Object[], CancellationToken)
• IClientProxy.SendCoreAsync
• HubConnectionContext.User
• QueryHelpers.ParseNullableQuery(String)
• QueryHelpers.ParseQuery(String)

こちらも参照ください

• .NET コア ライブラリにおける Nullable 参照型の注釈変更