InAttribute 클래스

정의

네임스페이스:

System.Runtime.InteropServices

어셈블리:

System.Runtime.dll

Source:

InAttribute.cs

데이터가 호출자에서 피호출자로 마샬링되어야 하고, 호출자에게는 다시 마샬링되지 않아도 됨을 나타냅니다.

public ref class InAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Parameter, Inherited=false)]
public sealed class InAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Parameter, Inherited=false)>]
type InAttribute = class
    inherit Attribute

Public NotInheritable Class InAttribute
Inherits Attribute

상속

Object

Attribute

InAttribute

특성

AttributeUsageAttribute

예제

다음 예제에서는 및 를 매개 변수로 배열을 전달하는 플랫폼 호출 프로토타입에 적용 InAttributeOutAttribute 하는 방법을 보여 줍니다. 방향 특성의 조합을 사용하면 호출자가 호출 수신자가 변경한 내용을 볼 수 있습니다.

using namespace System;
using namespace System::Runtime::InteropServices;

// Declare a class member for each structure element.

[StructLayout(LayoutKind::Sequential, CharSet = CharSet::Unicode)]
public ref class OpenFileName
{
public:
    int structSize;
    String^ filter;
    String^ file;
    // ...
};

private ref class NativeMethods
{
public:

    // Declare a managed prototype for the unmanaged function.

    [DllImport("Comdlg32.dll", CharSet = CharSet::Unicode)]
    static bool GetOpenFileName([In, Out]OpenFileName^ ofn);
};

void main() {}

using System.Runtime.InteropServices;
using System;

// Declare a class member for each structure element.
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public class OpenFileName
{
    public int structSize = 0;
    public string filter = null;
    public string file = null;
    // ...
}

internal static class NativeMethods
{
    // Declare a managed prototype for the unmanaged function.
    [DllImport("Comdlg32.dll", CharSet = CharSet.Unicode)]
    internal static extern bool GetOpenFileName([In, Out] OpenFileName ofn);
}

public class MainMethod
{
    static void Main()
    { }
}

Imports System.Runtime.InteropServices

' Declare a class member for each structure element.
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Class OpenFileName

    Public structSize As Integer = 0
    Public filter As String = Nothing
    Public file As String = Nothing
    ' ...

End Class

Friend Class NativeMethods
    ' Declare managed prototype for the unmanaged function.
    Friend Declare Unicode Function GetOpenFileName Lib "Comdlg32.dll" (
       <[In](), Out()> ByVal ofn As OpenFileName) As Boolean
End Class

Public Class App
    Public Shared Sub Main()

    End Sub
End Class

설명

매개 변수에 이 특성을 적용할 수 있습니다.

는 InAttribute 선택 사항입니다. 특성은 COM interop 및 플랫폼 호출에 대해서만 지원됩니다. 명시적 설정이 없는 경우 interop 마샬러는 매개 변수 형식, 매개 변수가 참조 또는 값으로 전달되는지 여부, 형식이 blittable인지 아니면 비 Blittable인지에 따라 규칙을 가정합니다. 예를 들어 클래스는 StringBuilder 항상 In/Out으로 간주되고 값으로 전달된 문자열 배열은 In으로 간주됩니다.

C#스타일 out 키워드를 사용하여 수정된 매개 변수에는 를 적용 InAttribute 할 수 없습니다. Visual Basic의 In 키워드와 InAttribute, 빼기 특성을 혼동하지 않도록 하려면 특성 주위에 대괄호가 있는 양식을 사용합니다 <[In]> .

및 OutAttribute 를 InAttribute 결합하는 것은 배열 및 blittable이 아닌 형식으로 서식이 지정된 경우에 특히 유용합니다. 호출자는 두 특성을 모두 적용할 때만 호출 수신자가 이러한 형식에 대해 변경한 내용을 확인합니다. 이러한 형식은 마샬링하는 동안 복사해야 하므로 및 OutAttribute 를 사용하여 InAttribute 불필요한 복사본을 줄일 수 있습니다.

마샬링 동작의 InAttribute 영향에 대한 자세한 내용은 방향 특성을 참조하세요.

생성자

InAttribute()

InAttribute 클래스의 새 인스턴스를 초기화합니다.

속성

TypeId

파생 클래스에서 구현된 경우 이 Attribute에 대한 고유 식별자를 가져옵니다. (다음에서 상속됨 Attribute)

메서드

Equals(Object)	이 인스턴스가 지정된 개체와 같은지를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
GetHashCode()	이 인스턴스의 해시 코드를 반환합니다. (다음에서 상속됨 Attribute)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
IsDefaultAttribute()	파생 클래스에서 재정의된 경우 이 인스턴스 값이 파생 클래스에 대한 기본값인지 여부를 표시합니다. (다음에서 상속됨 Attribute)
Match(Object)	파생 클래스에서 재정의된 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

추가 정보

• OutAttribute
• StringBuilder
• Blittable 형식 및 비 Blittable 형식