.NET 6 中已變更的參數名稱

  • 發行項

某些參數名稱已變更，以在參考與實作組件之間保持一致。 大部分的變更都位於參考組件，但少數變更位於實作組件。

先前的行為

有些參考組件參數名稱與其實作組件中對應的參數不同。 這個現象會在使用具名引數和反映時造成問題。

新的行為

在 .NET 6 中，已更新這些不相符的參數名稱，以跨參考和實作組件保持一致。

下表顯示變更的 API 和參數名稱。 此外，Stream衍生類型上的某些參數名稱已變更。

API 舊的參數名稱 新的參數名稱 變更位置
Attribute.GetCustomAttributes(MemberInfo, Type) type attributeType 參考和實作組件
Attribute.GetCustomAttributes(MemberInfo, Type, Boolean) type attributeType 參考和實作組件
Strings.InStr(Int32, String, String, CompareMethod) StartPos Start 參考組件
SortedList<TKey,TValue>.ICollection.CopyTo(Array, Int32) arrayIndex index 參考組件
Vector.Narrow source1、source2 low、high 參考組件
Vector.Widen dest1、dest2 low、high 參考組件
StreamWriter.WriteLine(ReadOnlySpan<Char>) value buffer 實作組件
FileStream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) array、numBytes buffer、count 實作組件
FileStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) array、numBytes buffer、count 實作組件
MemoryStream.Read(Span<Byte>) destination buffer 參考組件
MemoryStream.ReadAsync(Memory<Byte>, CancellationToken) destination buffer 參考組件
MemoryStream.Write(ReadOnlySpan<Byte>) source buffer 參考組件
MemoryStream.WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) source buffer 參考組件
UnmanagedMemoryStream.Read(Span<Byte>) destination buffer 參考組件
UnmanagedMemoryStream.Write(ReadOnlySpan<Byte>) source buffer 參考組件
SignerInfo.AddUnsignedAttribute(AsnEncodedData) asnEncodedData unsignedAttribute 參考組件
SignerInfo.RemoveUnsignedAttribute(AsnEncodedData) asnEncodedData unsignedAttribute 參考組件
Rfc3161TimestampRequest.ProcessResponse(ReadOnlyMemory<Byte>, Int32) source responseBytes 實作組件
Rfc3161TimestampToken.TryDecode(ReadOnlyMemory<Byte>, Rfc3161TimestampToken, Int32) source encodedBytes 實作組件
Rfc3161TimestampTokenInfo.Rfc3161TimestampTokenInfo(Oid, Oid, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, DateTimeOffset, Nullable<Int64>, Boolean, Nullable<ReadOnlyMemory<Byte>>, Nullable<ReadOnlyMemory<Byte>>, X509ExtensionCollection) tsaName timestampAuthorityName 實作組件
Rfc3161TimestampTokenInfo.TryDecode(ReadOnlyMemory<Byte>, Rfc3161TimestampTokenInfo, Int32) |
PrincipalPermission.Equals(Object) o obj 參考組件
UrlMembershipCondition.Equals(Object) o obj 參考組件
DBDataPermission(DBDataPermission) dataPermission permission 實作組件
DBDataPermission(DBDataPermissionAttribute) attribute permissionAttribute 實作組件
DBDataPermission(PermissionState, Boolean) blankPassword allowBlankPassword 實作組件
DBDataPermission.FromXml(SecurityElement) elem securityElement 實作組件
DBDataPermission.Union(IPermission) other target 實作組件

變更原因

  • 如果參考組件參數名稱已變更，則會將新名稱視為更適當或更容易閱讀，而且中斷會減到最低。
  • 如果執行階段參數的名稱已變更為取得跨平台或利用參考組件的一致性，則執行階段實作現在會符合方法的公用 API 和文件。

導入的版本

.NET 6

如果您因參數名稱改變而遭遇編譯器錯誤，請據此更新參數名稱。

如果您使用執行階段反映來檢查方法，並且相依於參數名稱，則請更新程式碼以使用新的參數名稱。

受影響的 API

另請參閱