ReadOnlyArrayAttribute 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
Windows 런타임 구성 요소의 배열 매개 변수에 적용할 때 해당 매개 변수에 전달되는 배열의 콘텐츠가 입력에만 사용되도록 지정합니다. 호출자는 호출로 배열이 변경되지 않도록 합니다.
public ref class ReadOnlyArrayAttribute sealed : Attribute[System.AttributeUsage(System.AttributeTargets.Parameter, AllowMultiple=false, Inherited=false)]
public sealed class ReadOnlyArrayAttribute : Attribute[<System.AttributeUsage(System.AttributeTargets.Parameter, AllowMultiple=false, Inherited=false)>]
type ReadOnlyArrayAttribute = class
inherit AttributePublic NotInheritable Class ReadOnlyArrayAttribute
Inherits Attribute- 상속
- 특성
설명
Windows 런타임 구성 요소의 배열 매개 변수가 값으로 전달 되는 경우 ( ByVal Visual Basic) 다음 특성 중 하나를 적용 해야 합니다.
ReadOnlyArrayAttribute배열의 내용을 입력 전용으로 사용 하려는 경우에는 특성을 적용 합니다.
WriteOnlyArrayAttribute배열의 콘텐츠가 출력에만 사용 되도록 하려면 특성을 적용 합니다. 즉, 메서드에서 배열의 내용을 설정 하지만 읽을 수는 없습니다.
두 특성을 매개 변수에 적용 하면 오류가 발생 합니다. 배열을 변경 하기 위한 표준 패턴을 비롯 한 자세한 내용은 Windows 개발자 센터의 Windows 런타임 구성 요소에 배열 전달 을 참조 하세요.
중요
특성이 있는 매개 변수는 ReadOnlyArrayAttribute 호출자가 네이티브 코드 또는 관리 코드로 작성 되었는지 여부에 따라 다르게 동작 합니다. 호출자가 네이티브 코드 (JavaScript 또는 Visual c + + 구성 요소 확장), 애플리케이션 이진 인터페이스 (ABI) 경계를 넘을 때 배열이 복사 됩니다. 필요한 경우 요소를 변환 합니다. 따라서 메서드가 입력 전용 배열에 대해 수행 하는 실수로 인 한 변경 내용은 호출자에 게 표시 되지 않습니다.
호출자가 관리 코드 이면 배열이 복사 되지 않습니다. 호출 된 메서드에서는 .NET Framework의 모든 메서드 호출에서와 같이 원래 배열을 사용할 수 있습니다. 배열 콘텐츠는 .NET Framework 코드에서 변경 될 수 있으므로 메서드가 배열에 대해 수행 하는 모든 변경 내용이 호출자에 게 표시 됩니다. 이는 Windows 런타임 구성 요소에 대해 작성 된 단위 테스트에 영향을 주므로 기억해 야 합니다. 테스트를 관리 코드로 작성 하는 경우 테스트 중에 배열의 내용이 변경 가능 하 게 표시 됩니다.
이 특성을 또는 특성이 있는 매개 변수에 적용 InAttribute OutAttribute 하면 모듈을 내보낼 때 오류가 발생 합니다. 특성을 out 매개 변수에 적용 하면 오류가 발생 합니다.
생성자
| ReadOnlyArrayAttribute() |
ReadOnlyArrayAttribute 클래스의 새 인스턴스를 초기화합니다. |
속성
| TypeId |
파생 클래스에서 구현된 경우 이 Attribute에 대한 고유 식별자를 가져옵니다. (다음에서 상속됨 Attribute) |
메서드
| Equals(Object) |
이 인스턴스가 지정된 개체와 같은지를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute) |
| GetHashCode() |
이 인스턴스의 해시 코드를 반환합니다. (다음에서 상속됨 Attribute) |
| GetType() |
현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object) |
| IsDefaultAttribute() |
파생 클래스에서 재정의된 경우 이 인스턴스 값이 파생 클래스에 대한 기본값인지 여부를 표시합니다. (다음에서 상속됨 Attribute) |
| Match(Object) |
파생 클래스에서 재정의된 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute) |
| MemberwiseClone() |
현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
| ToString() |
현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object) |
명시적 인터페이스 구현
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
이름 집합을 해당하는 디스패치 식별자 집합에 매핑합니다. (다음에서 상속됨 Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
인터페이스의 형식 정보를 가져오는 데 사용할 수 있는 개체의 형식 정보를 검색합니다. (다음에서 상속됨 Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
개체에서 제공하는 형식 정보 인터페이스의 수를 검색합니다(0 또는 1). (다음에서 상속됨 Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
개체에서 노출하는 메서드와 속성에 대한 액세스를 제공합니다. (다음에서 상속됨 Attribute) |