MarshalAsAttributeとは? わかりやすく解説

MarshalAsAttribute クラス

マネージ コードとアンマネージ コード間でデータをマーシャリングする方法を示します。

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

<AttributeUsageAttribute(AttributeTargets.Field Or AttributeTargets.Parameter
 Or AttributeTargets.ReturnValue, Inherited:=False)> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class
 MarshalAsAttribute
    Inherits Attribute
Dim instance As MarshalAsAttribute
[AttributeUsageAttribute(AttributeTargets.Field|AttributeTargets.Parameter|AttributeTargets.ReturnValue,
 Inherited=false)] 
[ComVisibleAttribute(true)] 
public sealed class MarshalAsAttribute : Attribute
[AttributeUsageAttribute(AttributeTargets::Field|AttributeTargets::Parameter|AttributeTargets::ReturnValue,
 Inherited=false)] 
[ComVisibleAttribute(true)] 
public ref class MarshalAsAttribute sealed
 : public Attribute
/** @attribute AttributeUsageAttribute(AttributeTargets.Field|AttributeTargets.Parameter|AttributeTargets.ReturnValue,
 Inherited=false) */ 
/** @attribute ComVisibleAttribute(true) */ 
public final class MarshalAsAttribute extends
 Attribute
AttributeUsageAttribute(AttributeTargets.Field|AttributeTargets.Parameter|AttributeTargets.ReturnValue,
 Inherited=false) 
ComVisibleAttribute(true) 
public final class MarshalAsAttribute extends
 Attribute
解説解説

この属性は、パラメータ、フィールド、または戻り値に適用できます。

各データ型には既定のマーシャリング動作があるため、この属性は省略できます。この属性は、特定の型を複数の型にマーシャリングできる場合にだけ必要です。たとえば、LPStr、LPWStr、LPTStr、または BStr のいずれかとして、文字列をアンマネージ コードにマーシャリングできます。既定では、共通言語ランタイムは BStr として COM メソッドに文字列パラメータをマーシャリングします。MarshalAsAttribute 属性を個別のフィールドまたはパラメータに適用して、その特定の文字列を BStr ではなく、LPStr としてマーシャリングできます。タイプ ライブラリ エクスポータ (Tlbexp.exe) は、指定したマーシャリングの基本設定を共通言語ランタイムに渡します。

一部のパラメータと戻り値では、COM 相互運用またはプラットフォーム呼び出しで使用された場合に、異なる既定のマーシャリング動作が適用されます。既定では、文字列パラメータ (および値型内のフィールド) は、プラットフォーム呼び出しのメソッドまたは関数に対する LPStr としてマーシャリングされます。詳細については、既定のマーシャリングの動作 のトピックを参照してください。

ほとんどの場合、次に示す C# シグネチャのように、この属性は単に UnmanagedType 列挙体を使用して、アンマネージ データの書式を識別します。

void
    MyMethod([MarshalAs(LPStr)] String s);

一部の UnmanagedType 列挙体メンバには、追加の情報が必要です。たとえば、UnmanagedType が LPArray の場合に、追加の情報が必要になります。配列でのこの属性の使い方の詳細については、「配列に対する既定のマーシャリング」を参照してください。

タイプ ライブラリ インポータ (Tlbimp.exe) でも、この属性をパラメータ、フィールド、および戻り値に適用し、入力のタイプ ライブラリのデータ型が対応するマネージ データ型の既定の型ではないことを示します。Tlbimp.exe は、紛らわしいことがないよう、入力のタイプ ライブラリに指定された型に関係なく、常に MarshalAsAttribute を String 型と Object 型に適用します。

メモメモ

MarshalAsAttribute では、ジェネリック型のマーシャリングはサポートしていません。

使用例使用例

パラメータ、フィールド、および戻り値に適用される MarshalAsAttribute をマネージ ソース コードに記述した例を次に示します。

Imports System.Runtime.InteropServices

Module Program
    'Applied to a parameter.
    Public Sub M1(<MarshalAs(UnmanagedType.LPWStr)>
 ByVal msg As String)
    End Sub

    'Applied to a field within a class.
    Class MsgText
        <MarshalAs(UnmanagedType.LPWStr)> Public msg As
 String
    End Class

    'Applied to a a return value.
    Public Function M2() As
 <MarshalAs(UnmanagedType.LPWStr)> String
    End Function
End Module

//Applied to a parameter.
public void M1 ([MarshalAs(UnmanagedType.LPWStr)]String msg);

//Applied to a field within a class.
class MsgText {
    [MarshalAs(UnmanagedType.LPWStr)] public String
 msg;
}

//Applied to a return value.
[return: MarshalAs(UnmanagedType.LPWStr)]
public String GetMessage();
継承階層継承階層
System.Object
   System.Attribute
    System.Runtime.InteropServices.MarshalAsAttribute
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
MarshalAsAttribute メンバ
System.Runtime.InteropServices 名前空間
UnmanagedType
その他の技術情報
タイプ ライブラリ エクスポータ (Tlbexp.exe)
タイプ ライブラリ インポータ (Tlbimp.exe)

MarshalAsAttribute コンストラクタ (UnmanagedType)

指定した UnmanagedType 列挙体メンバを使用して、MarshalAsAttribute クラスの新しいインスタンスを初期化します。

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Public Sub New ( _
    unmanagedType As UnmanagedType _
)
Dim unmanagedType As UnmanagedType

Dim instance As New MarshalAsAttribute(unmanagedType)
public MarshalAsAttribute (
    UnmanagedType unmanagedType
)
public:
MarshalAsAttribute (
    UnmanagedType unmanagedType
)
public MarshalAsAttribute (
    UnmanagedType unmanagedType
)
public function MarshalAsAttribute (
    unmanagedType : UnmanagedType
)

パラメータ

unmanagedType

マーシャリング後のデータの UnmanagedType 値。

解説解説

エラーを招きにくく、読みやすいコードにするためには、常にこのコンストラクタを使用してください。

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
MarshalAsAttribute クラス
MarshalAsAttribute メンバ
System.Runtime.InteropServices 名前空間
UnmanagedType

MarshalAsAttribute コンストラクタ (Int16)

指定した UnmanagedType 値を使用して、MarshalAsAttribute クラスの新しいインスタンスを初期化します。

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Public Sub New ( _
    unmanagedType As Short _
)
Dim unmanagedType As Short

Dim instance As New MarshalAsAttribute(unmanagedType)
public MarshalAsAttribute (
    short unmanagedType
)
public:
MarshalAsAttribute (
    short unmanagedType
)
public MarshalAsAttribute (
    short unmanagedType
)
public function MarshalAsAttribute (
    unmanagedType : short
)

パラメータ

unmanagedType

マーシャリング後のデータの UnmanagedType 値。

解説解説

このコンストラクタは、UnmanagedType 列挙体の各メンバを表す、基になる 16 ビット符号付き整数値を受け取ります。タイプ ライブラリ インポータ (Tlbimp.exe) は、このコンストラクタを使用します。

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
MarshalAsAttribute クラス
MarshalAsAttribute メンバ
System.Runtime.InteropServices 名前空間
UnmanagedType
その他の技術情報
タイプ ライブラリ インポータ (Tlbimp.exe)

MarshalAsAttribute コンストラクタ

MarshalAsAttribute クラスの新しいインスタンスを初期化します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
MarshalAsAttribute (Int16) 指定した UnmanagedType 値を使用して、MarshalAsAttribute クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

MarshalAsAttribute (UnmanagedType) 指定した UnmanagedType 列挙体メンバを使用して、MarshalAsAttribute クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

参照参照

関連項目

MarshalAsAttribute クラス
MarshalAsAttribute メンバ
System.Runtime.InteropServices 名前空間
UnmanagedType

その他の技術情報

タイプ ライブラリ インポータ (Tlbimp.exe)

MarshalAsAttribute フィールド


パブリック フィールドパブリック フィールド

  名前 説明
パブリック フィールド SizeParamIndex COM の size_is のように、0 から始まる配列要素のカウントを格納しているパラメータを示します。
参照参照

関連項目

MarshalAsAttribute クラス
System.Runtime.InteropServices 名前空間
UnmanagedType

その他の技術情報

タイプ ライブラリ エクスポータ (Tlbexp.exe)
タイプ ライブラリ インポータ (Tlbimp.exe)

MarshalAsAttribute プロパティ


パブリック プロパティパブリック プロパティ

  名前 説明
パブリック プロパティ TypeId  派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。 ( Attribute から継承されます。)
パブリック プロパティ Value マーシャリング後データの UnmanagedType 値を取得します。
参照参照

関連項目

MarshalAsAttribute クラス
System.Runtime.InteropServices 名前空間
UnmanagedType

その他の技術情報

タイプ ライブラリ エクスポータ (Tlbexp.exe)
タイプ ライブラリ インポータ (Tlbimp.exe)

MarshalAsAttribute メソッド


パブリック メソッドパブリック メソッド

  名前 説明
パブリック メソッド Equals  オーバーロードされます。 ( Attribute から継承されます。)
パブリック メソッド GetCustomAttribute  オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 ( Attribute から継承されます。)
パブリック メソッド GetCustomAttributes  オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 ( Attribute から継承されます。)
パブリック メソッド GetHashCode  このインスタンスのハッシュ コードを返します。 ( Attribute から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド IsDefaultAttribute  派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 ( Attribute から継承されます。)
パブリック メソッド IsDefined  オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 ( Attribute から継承されます。)
パブリック メソッド Match  派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 ( Attribute から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String を返します。 ( Object から継承されます。)
参照参照

関連項目

MarshalAsAttribute クラス
System.Runtime.InteropServices 名前空間
UnmanagedType

その他の技術情報

タイプ ライブラリ エクスポータ (Tlbexp.exe)
タイプ ライブラリ インポータ (Tlbimp.exe)

MarshalAsAttribute メンバ

マネージ コードとアンマネージ コード間でデータをマーシャリングする方法を示します。

MarshalAsAttribute データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド MarshalAsAttribute オーバーロードされます。 MarshalAsAttribute クラスの新しいインスタンスを初期化します。
パブリック フィールドパブリック フィールド
  名前 説明
パブリック フィールド SizeParamIndex COM の size_is のように、0 から始まる配列要素のカウントを格納しているパラメータを示します。
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ TypeId  派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。(Attribute から継承されます。)
パブリック プロパティ Value マーシャリング後データの UnmanagedType 値を取得します。
パブリック メソッドパブリック メソッド
  名前 説明
パブリック メソッド Equals  オーバーロードされます。 ( Attribute から継承されます。)
パブリック メソッド GetCustomAttribute  オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 (Attribute から継承されます。)
パブリック メソッド GetCustomAttributes  オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 (Attribute から継承されます。)
パブリック メソッド GetHashCode  このインスタンスのハッシュ コードを返します。 (Attribute から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド IsDefaultAttribute  派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 (Attribute から継承されます。)
パブリック メソッド IsDefined  オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 (Attribute から継承されます。)
パブリック メソッド Match  派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (Attribute から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String を返します。 (Object から継承されます。)
参照参照

関連項目

MarshalAsAttribute クラス
System.Runtime.InteropServices 名前空間
UnmanagedType

その他の技術情報

タイプ ライブラリ エクスポータ (Tlbexp.exe)
タイプ ライブラリ インポータ (Tlbimp.exe)



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「MarshalAsAttribute」の関連用語

MarshalAsAttributeのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



MarshalAsAttributeのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS