ReadOnlyArrayAttribute 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
Windows Runtime 구성 요소의 배열 매개 변수에 적용되는 경우 해당 매개 변수에 전달되는 배열의 내용이 입력에만 사용되도록 지정합니다. 호출자는 호출에 의해 배열이 변경되지 않을 것으로 예상합니다.
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 Runtime 구성 요소의 배열 매개 변수가 값(Visual Basic ByVal)으로 전달되는 경우 다음 특성 중 하나를 적용해야 합니다.
배열의 ReadOnlyArrayAttribute 내용을 입력에만 사용하려는 경우 특성을 적용합니다.
WriteOnlyArrayAttribute 배열의 내용을 출력에만 사용하려는 경우(즉, 메서드가 배열의 내용을 설정하지만 읽지 않음) 특성을 적용합니다.
매개 변수에 두 특성을 모두 적용하면 오류가 발생합니다.
중요합니다
특성이 있는 매개 변수는 ReadOnlyArrayAttribute 호출자가 네이티브 코드 또는 관리 코드로 작성되었는지 여부에 따라 다르게 동작합니다. 호출자가 네이티브 코드(JavaScript 또는 Visual C++ 구성 요소 확장)인 경우 호출이 ABI(애플리케이션 이진 인터페이스) 경계를 넘을 때 배열이 복사됩니다. 필요한 경우 요소가 변환됩니다. 따라서 메서드가 입력 전용 배열에 실수로 변경한 내용은 호출자에게 표시되지 않습니다.
호출자가 관리 코드인 경우 배열이 복사되지 않습니다. 원래 배열은 .NET Framework의 모든 메서드 호출에서와 마찬가지로 호출된 메서드에서 사용할 수 있습니다. 배열 콘텐츠는 .NET Framework 코드에서 변경할 수 있으므로 메서드가 배열에 적용한 변경 내용은 호출자에게 표시됩니다. 이는 Windows Runtime 구성 요소에 대해 작성된 단위 테스트에 영향을 주므로 기억해야 합니다. 테스트가 관리 코드로 작성된 경우 테스트 중에 배열의 내용이 변경 가능한 것처럼 보입니다.
이 특성을 또는 InAttribute 특성이 있는 매개 변수에 OutAttribute 적용하면 모듈을 내보낼 때 오류가 발생합니다. 매개 변수에 특성을 적용하면 out 오류가 발생합니다.
생성자
| Name | Description |
|---|---|
| ReadOnlyArrayAttribute() |
ReadOnlyArrayAttribute 클래스의 새 인스턴스를 초기화합니다. |
속성
| Name | Description |
|---|---|
| TypeId |
파생 클래스에서 구현되는 경우 이 Attribute대한 고유 식별자를 가져옵니다. (다음에서 상속됨 Attribute) |
메서드
| Name | Description |
|---|---|
| Equals(Object) |
이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute) |
| GetHashCode() |
이 인스턴스의 해시 코드를 반환합니다. (다음에서 상속됨 Attribute) |
| GetType() |
현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object) |
| IsDefaultAttribute() |
파생 클래스에서 재정의되는 경우 이 인스턴스의 값이 파생 클래스의 기본값인지 여부를 나타냅니다. (다음에서 상속됨 Attribute) |
| Match(Object) |
파생 클래스에서 재정의되는 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute) |
| MemberwiseClone() |
현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
| ToString() |
현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object) |
명시적 인터페이스 구현
| Name | Description |
|---|---|
| _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) |
