InAttribute クラス

定義

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)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class InAttribute : Attribute

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

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

Public NotInheritable Class InAttribute
Inherits Attribute

継承

Object

Attribute

InAttribute

属性

AttributeUsageAttribute ComVisibleAttribute

例

次の例では、配列をパラメーターとして渡すプラットフォーム呼び出しプロトタイプに InAttribute と OutAttribute を適用する方法を示します。 方向属性の組み合わせにより、呼び出し元は呼び出し先によって行われた変更を確認できます。

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 相互運用機能とプラットフォーム呼び出しでのみサポートされています。 明示的な設定がない場合、相互運用マーシャラーは、パラメーターの型、パラメーターが参照渡しまたは値渡しかどうか、および型が blittable か非 blittable かに基づく規則を前提としています。 たとえば、 StringBuilder クラスは常に In/Out と見なされ、値によって渡される文字列の配列は In と見なされます。

C# スタイルの out キーワードで変更されたパラメーターにInAttributeを適用することはできません。 Visual Basic の In キーワードと InAttribute -Attribute を混同しないようにするには、属性を角かっこで囲んで <[In]> フォームを使用します。

InAttributeとOutAttributeの組み合わせは、配列や書式設定された非 blittable 型に適用する場合に特に便利です。 呼び出し元は、両方の属性を適用した場合にのみ、呼び出し先がこれらの型に加える変更を確認します。 これらの型はマーシャリング中にコピーを必要とするため、 InAttribute と OutAttribute を使用して不要なコピーを減らすことができます。

こちらもご覧ください

• OutAttribute
• StringBuilder
• Blittable 型と非 Blittable 型