다음을 통해 공유

스트림 파생 형식의 일부 매개 변수 이름이 변경됨

  • 아티클

.NET 6에서는 System.IO.Stream에서 파생된 형식에 대한 메서드의 일부 매개 변수 이름이 기본 클래스와 일치하도록 변경되었습니다.

변경 내용 설명

이전 .NET 버전에서는 Stream에서 파생된 여러 가지 형식이 메서드를 재정의하지만 기본 형식에서 사용되는 이름과는 다른 매개 변수 이름을 사용합니다. 예를 들어, DeflateStream.Read(Byte[], Int32, Int32)의 바이트 배열 매개 변수 이름은 array로 지정되지만 기본 클래스 메서드의 해당 인수 이름은 buffer로 지정됩니다.

.NET 6에서 일치하지 않는 매개 변수 이름을 사용한 System.IO.Stream에서 파생되는 모든 형식은 기본 형식과 동일한 매개 변수 이름을 사용하여 기본 형식을 준수하게 되었습니다.

도입된 버전

.NET 6

변경 이유

변경에는 여러 가지 이유가 있습니다.

  • 잘못된 인수가 전달되고 예외가 throw된 경우 해당 예외에는 구현에 따라 기본 매개 변수의 이름 또는 파생 매개 변수 이름이 포함되었을 수 있습니다. 호출자가 기본 형식 또는 파생 형식으로 형식화된 참조를 사용했을 수 있으므로 예외의 인수 이름이 항상 올바를 수는 없습니다.
  • 서로 다른 매개 변수 이름을 사용하면 모든 Stream 구현에서 동작의 유효성을 일관되게 검사하기가 더 어렵습니다.
  • .NET 6은 인수의 유효성을 검사하기 위해 Stream에 퍼블릭 메서드를 추가하고 해당 메서드에는 사용할 일관된 매개 변수 이름이 있어야 합니다.

이 호환성이 손상되는 변경의 효과는 최소화됩니다.

  • 기존 이진의 경우 변경의 영향은 영향을 받는 파생 형식에서 매개 변수 이름을 검사하는 데 리플렉션을 사용하는 코드로 제한됩니다.
  • 소스 코드의 경우 변경의 영향은 파생 형식으로 형식화된 변수를 사용하여 파생 스트림 형식에서 메서드를 호출하는 데 명명된 매개 변수를 사용하는 코드로 제한됩니다.

두 경우에 모두 기본 매개 변수 이름을 일관되게 사용하는 것이 좋습니다.

영향을 받는 API

참고 항목