UnmanagedType 枚举 - 指定如何将参数或字段封送到非托管代码

	成员名称	说明
	AnsiBStr	长度前缀为单字节的 ANSI 字符串。可以在 String 数据类型上使用此成员。
	AsAny	一个动态类型，将在运行时确定对象的类型，并将该对象作为所确定的类型进行封送处理。仅对平台调用方法有效。
	Bool	4 字节布尔值（true != 0、false = 0）。这是 Win32 BOOL 类型。
	BStr	长度前缀为双字节的 Unicode 字符串。可以在 String 数据类型上使用此成员（它是 COM 中的默认字符串）。
	ByValArray	当 MarshalAsAttribute.Value 设置为 ByValArray 时，必须设置 SizeConst 以指示数组中的元素数。当需要区分字符串类型时，ArraySubType 字段可以选择包含数组元素的 UnmanagedType。此 UnmanagedType 只可用于作为结构中的字段的数组。
	ByValTStr	用于在结构中出现的内联定长字符数组。与 ByValTStr 一起使用的字符类型由应用于包含结构的System.Runtime.InteropServices.StructLayoutAttribute 的 System.Runtime.InteropServices.CharSet 参数确定。应始终使用 MarshalAsAttribute.SizeConst 字段来指示数组的大小。  .NET Framework 的 ByValTStr 类型的行为类似于结构中的 C 样式、固定大小的字符串（例如，char s[5]）。托管代码中的行为与 Microsoft Visual Basic 6.0 中的行为不同，后者不是空终止（例如，MyString As String * 5）。
	Currency	在 System.Decimal 上使用，以将十进制数值作为 COM 货币类型而不是 Decimal 封送。
	CustomMarshaler	当与 MarshalAsAttribute.MarshalType 或 MarshalAsAttribute.MarshalTypeRef 一起使用时，指定自定义封送拆收器类。MarshalAsAttribute.MarshalCookie 字段可用于将附加信息传递给自定义封送拆收器。可以在任何引用类型上使用此成员。
	Error	此与 I4 或 U4 关联的本机类型将导致参数作为导出类型库中的 HRESULT 导出。
	FunctionPtr	一个可用作 C 样式函数指针的整数。可将此成员用于 Delegate 数据类型或从 Delegate 继承的类型。
	I1	1 字节有符号整数。可使用此成员将布尔值转换为 1 字节、C 样式的 bool（true = 1、false = 0）。
	I2	2 字节有符号整数。
	I4	4 字节有符号整数。
	I8	8 字节有符号整数。
	IDispatch	一个 COM IDispatch 指针（在 Microsoft Visual Basic 6.0 中为 Object）。
	Interface	COM 接口指针。从类元数据获得接口的 Guid。如果将此成员应用于类，则可以使用该成员指定确切的接口类型或默认的接口类型。当应用于 Object 数据类型时，此成员将产生 UnmanagedType.IUnknown 行为。
	IUnknown	COMIUnknown 指针。可以在 Object 数据类型上使用此成员。
	LPArray	指向 C 样式数组的第一个元素的指针。当从托管到非托管进行封送处理时，该数组的长度由托管数组的长度确定。当从非托管到托管进行封送处理时，将根据 MarshalAsAttribute.SizeConst 和MarshalAsAttribute.SizeParamIndex 字段确定该数组的长度，当需要区分字符串类型时，还可以后跟数组中元素的非托管类型。
	LPStr	单字节、空终止的 ANSI 字符串。可在 System.String 或 System.Text.StringBuilder 数据类型上使用此成员。
	LPStruct	一个指针，它指向用于封送托管格式化类的 C 样式结构。仅对平台调用方法有效。
	LPTStr	与平台相关的字符串：在 Windows 98 上为 ANSI，在 Windows NT 和 Windows XP 上为 Unicode。该值仅对平台调用受支持，而对 COM Interop 则不受支持，原因是不支持导出 LPTStr 类型的字符串。
	LPWStr	一个 2 字节、空终止的 Unicode 字符串。  请注意，如果非托管字符串不是使用非托管的 CoTaskMemAlloc 函数创建的，则不能在此非托管字符串中使用LPWStr 值。
	R4	4 字节浮点数。
	R8	8 字节浮点数。
	SafeArray	SafeArray 是自我描述的数组，它带有关联数组数据的类型、秩和界限。可将此成员与MarshalAsAttribute.SafeArraySubType 字段一起使用，以重写默认元素类型。
	Struct	一个用于封送托管格式化类和值类型的 VARIANT。
	SysInt	与平台相关的有符号整数。在 32 位 Windows 上为 4 字节，在 64 位 Windows 上为 8 字节。
	SysUInt	与平台相关的无符号整数。在 32 位 Windows 上为 4 字节，在 64 位 Windows 上为 8 字节。
	TBStr	一个有长度前缀的与平台相关的 char 字符串。在 Windows 98 上为 ANSI，在 Windows NT 上为 Unicode。很少用到这个类似于 BSTR 的成员。
	U1	1 字节无符号整数。
	U2	2 字节无符号整数。
	U4	4 字节无符号整数。
	U8	8 字节无符号整数。
	VariantBool	2 字节、OLE 定义的 VARIANT_BOOL 类型（true = -1、false = 0）。
	VBByRefStr	允许 Visual Basic 2005 在非托管代码中更改字符串，并将结果在托管代码中反映出来。该值仅对平台调用受支持。

备注

在 System.Runtime.InteropServices.MarshalAsAttribute 中使用 UnmanagedType 枚举，以指定在与非托管代码进行交互的过程中如何对类型进行封送处理。可以使用此枚举对使用简单值类型（I1、I2、I4、I8、R4、R8、U2、U4 和 U8）、.NET Framework 中未提供的非托管类型以及各种杂项类型的代码进行封送处理。

有关更多信息，请参见 与非托管代码交互操作。

示例

下面的代码段演示如何在托管源代码中声明由 COM 组件实现的非托管接口。System.Runtime.InteropServices.ComImportAttribute 防止IMyStorage 接口被导回由 COM 使用。（COM 客户端应当直接使用现有 COM 组件。）在此示例中，MarshalAsAttribute 指定若干UnmanagedType 成员，这些成员表示由原始 COM 接口使用的类型。

C#

C++

VB

using System;
using System.Runtime.InteropServices;

namespace MyModule
{
	// If you do not have a type library for an interface
	// you can redeclare it using ComImportAttribute.

	// This is how the interface would look in an idl file.

	//[
	//object,
	//uuid("73EB4AF8-BE9C-4b49-B3A4-24F4FF657B26"),
	//dual,	helpstring("IMyStorage Interface"),
	//pointer_default(unique)
	//]
	//interface IMyStorage : IDispatch
	//{
	//	[id(1)]
	//	HRESULT GetItem([in] BSTR bstrName, [out, retval] IDispatch ** ppItem);
	//	[id(2)]
	//	HRESULT GetItems([in] BSTR bstrLocation, [out] SAFEARRAY(VARIANT)* pItems);
	//	[id(3)]
	//	HRESULT GetItemDescriptions([in] BSTR bstrLocation, [out] SAFEARRAY(VARIANT) ** ppItems);
	//	[id(4), propget]
	//	HRESULT get_IsEmpty([out, retval] BOOL * pfEmpty);
	//};

	// This is the managed declaration.

	[ComImport]
	[Guid("73EB4AF8-BE9C-4b49-B3A4-24F4FF657B26")]
	public interface IMyStorage  
	{
		[DispId(1)]
		[return : MarshalAs( UnmanagedType.Interface )]
		Object GetItem( [In, MarshalAs( UnmanagedType.BStr )] String bstrName );

		[DispId(2)]
		void GetItems( [In, MarshalAs( UnmanagedType.BStr )] String bstrLocation, 
			[Out, MarshalAs( UnmanagedType.SafeArray, 
					  SafeArraySubType = VarEnum.VT_VARIANT )] out Object[] Items );
                
                
		[DispId(3)]
		void GetItemDescriptions( [In] String bstrLocation, 
			[In, Out, MarshalAs( UnmanagedType.SafeArray )] ref Object[] varDescriptions );

		bool IsEmpty 
		{
			[DispId(4)]
			[return : MarshalAs( UnmanagedType.VariantBool )]
			get;
		}
	}
}

成员

	成员名称	说明
	AnsiBStr	长度前缀为单字节的 ANSI 字符串。可以在 String 数据类型上使用此成员。
	AsAny	一个动态类型，将在运行时确定对象的类型，并将该对象作为所确定的类型进行封送处理。仅对平台调用方法有效。
	Bool	4 字节布尔值（true != 0、false = 0）。这是 Win32 BOOL 类型。
	BStr	长度前缀为双字节的 Unicode 字符串。可以在 String 数据类型上使用此成员（它是 COM 中的默认字符串）。
	ByValArray	当 MarshalAsAttribute.Value 设置为 ByValArray 时，必须设置 SizeConst 以指示数组中的元素数。当需要区分字符串类型时，ArraySubType 字段可以选择包含数组元素的 UnmanagedType。此 UnmanagedType 只可用于作为结构中的字段的数组。
	ByValTStr	用于在结构中出现的内联定长字符数组。与 ByValTStr 一起使用的字符类型由应用于包含结构的System.Runtime.InteropServices.StructLayoutAttribute 的 System.Runtime.InteropServices.CharSet 参数确定。应始终使用 MarshalAsAttribute.SizeConst 字段来指示数组的大小。  .NET Framework 的 ByValTStr 类型的行为类似于结构中的 C 样式、固定大小的字符串（例如，char s[5]）。托管代码中的行为与 Microsoft Visual Basic 6.0 中的行为不同，后者不是空终止（例如，MyString As String * 5）。
	Currency	在 System.Decimal 上使用，以将十进制数值作为 COM 货币类型而不是 Decimal 封送。
	CustomMarshaler	当与 MarshalAsAttribute.MarshalType 或 MarshalAsAttribute.MarshalTypeRef 一起使用时，指定自定义封送拆收器类。MarshalAsAttribute.MarshalCookie 字段可用于将附加信息传递给自定义封送拆收器。可以在任何引用类型上使用此成员。
	Error	此与 I4 或 U4 关联的本机类型将导致参数作为导出类型库中的 HRESULT 导出。
	FunctionPtr	一个可用作 C 样式函数指针的整数。可将此成员用于 Delegate 数据类型或从 Delegate 继承的类型。
	I1	1 字节有符号整数。可使用此成员将布尔值转换为 1 字节、C 样式的 bool（true = 1、false = 0）。
	I2	2 字节有符号整数。
	I4	4 字节有符号整数。
	I8	8 字节有符号整数。
	IDispatch	一个 COM IDispatch 指针（在 Microsoft Visual Basic 6.0 中为 Object）。
	Interface	COM 接口指针。从类元数据获得接口的 Guid。如果将此成员应用于类，则可以使用该成员指定确切的接口类型或默认的接口类型。当应用于 Object 数据类型时，此成员将产生 UnmanagedType.IUnknown 行为。
	IUnknown	COMIUnknown 指针。可以在 Object 数据类型上使用此成员。
	LPArray	指向 C 样式数组的第一个元素的指针。当从托管到非托管进行封送处理时，该数组的长度由托管数组的长度确定。当从非托管到托管进行封送处理时，将根据 MarshalAsAttribute.SizeConst 和MarshalAsAttribute.SizeParamIndex 字段确定该数组的长度，当需要区分字符串类型时，还可以后跟数组中元素的非托管类型。
	LPStr	单字节、空终止的 ANSI 字符串。可在 System.String 或 System.Text.StringBuilder 数据类型上使用此成员。
	LPStruct	一个指针，它指向用于封送托管格式化类的 C 样式结构。仅对平台调用方法有效。
	LPTStr	与平台相关的字符串：在 Windows 98 上为 ANSI，在 Windows NT 和 Windows XP 上为 Unicode。该值仅对平台调用受支持，而对 COM Interop 则不受支持，原因是不支持导出 LPTStr 类型的字符串。
	LPWStr	一个 2 字节、空终止的 Unicode 字符串。  请注意，如果非托管字符串不是使用非托管的 CoTaskMemAlloc 函数创建的，则不能在此非托管字符串中使用LPWStr 值。
	R4	4 字节浮点数。
	R8	8 字节浮点数。
	SafeArray	SafeArray 是自我描述的数组，它带有关联数组数据的类型、秩和界限。可将此成员与MarshalAsAttribute.SafeArraySubType 字段一起使用，以重写默认元素类型。
	Struct	一个用于封送托管格式化类和值类型的 VARIANT。
	SysInt	与平台相关的有符号整数。在 32 位 Windows 上为 4 字节，在 64 位 Windows 上为 8 字节。
	SysUInt	与平台相关的无符号整数。在 32 位 Windows 上为 4 字节，在 64 位 Windows 上为 8 字节。
	TBStr	一个有长度前缀的与平台相关的 char 字符串。在 Windows 98 上为 ANSI，在 Windows NT 上为 Unicode。很少用到这个类似于 BSTR 的成员。
	U1	1 字节无符号整数。
	U2	2 字节无符号整数。
	U4	4 字节无符号整数。
	U8	8 字节无符号整数。
	VariantBool	2 字节、OLE 定义的 VARIANT_BOOL 类型（true = -1、false = 0）。
	VBByRefStr	允许 Visual Basic 2005 在非托管代码中更改字符串，并将结果在托管代码中反映出来。该值仅对平台调用受支持。

备注

在 System.Runtime.InteropServices.MarshalAsAttribute 中使用 UnmanagedType 枚举，以指定在与非托管代码进行交互的过程中如何对类型进行封送处理。可以使用此枚举对使用简单值类型（I1、I2、I4、I8、R4、R8、U2、U4 和 U8）、.NET Framework 中未提供的非托管类型以及各种杂项类型的代码进行封送处理。

有关更多信息，请参见 与非托管代码交互操作。

示例

下面的代码段演示如何在托管源代码中声明由 COM 组件实现的非托管接口。System.Runtime.InteropServices.ComImportAttribute 防止IMyStorage 接口被导回由 COM 使用。（COM 客户端应当直接使用现有 COM 组件。）在此示例中，MarshalAsAttribute 指定若干UnmanagedType 成员，这些成员表示由原始 COM 接口使用的类型。

C#

C++

VB

using System;
using System.Runtime.InteropServices;

namespace MyModule
{
	// If you do not have a type library for an interface
	// you can redeclare it using ComImportAttribute.

	// This is how the interface would look in an idl file.

	//[
	//object,
	//uuid("73EB4AF8-BE9C-4b49-B3A4-24F4FF657B26"),
	//dual,	helpstring("IMyStorage Interface"),
	//pointer_default(unique)
	//]
	//interface IMyStorage : IDispatch
	//{
	//	[id(1)]
	//	HRESULT GetItem([in] BSTR bstrName, [out, retval] IDispatch ** ppItem);
	//	[id(2)]
	//	HRESULT GetItems([in] BSTR bstrLocation, [out] SAFEARRAY(VARIANT)* pItems);
	//	[id(3)]
	//	HRESULT GetItemDescriptions([in] BSTR bstrLocation, [out] SAFEARRAY(VARIANT) ** ppItems);
	//	[id(4), propget]
	//	HRESULT get_IsEmpty([out, retval] BOOL * pfEmpty);
	//};

	// This is the managed declaration.

	[ComImport]
	[Guid("73EB4AF8-BE9C-4b49-B3A4-24F4FF657B26")]
	public interface IMyStorage  
	{
		[DispId(1)]
		[return : MarshalAs( UnmanagedType.Interface )]
		Object GetItem( [In, MarshalAs( UnmanagedType.BStr )] String bstrName );

		[DispId(2)]
		void GetItems( [In, MarshalAs( UnmanagedType.BStr )] String bstrLocation, 
			[Out, MarshalAs( UnmanagedType.SafeArray, 
					  SafeArraySubType = VarEnum.VT_VARIANT )] out Object[] Items );
                
                
		[DispId(3)]
		void GetItemDescriptions( [In] String bstrLocation, 
			[In, Out, MarshalAs( UnmanagedType.SafeArray )] ref Object[] varDescriptions );

		bool IsEmpty 
		{
			[DispId(4)]
			[return : MarshalAs( UnmanagedType.VariantBool )]
			get;
		}
	}
}

成员

	成员名称	说明
	AnsiBStr	长度前缀为单字节的 ANSI 字符串。可以在 String 数据类型上使用此成员。
	AsAny	一个动态类型，将在运行时确定对象的类型，并将该对象作为所确定的类型进行封送处理。仅对平台调用方法有效。
	Bool	4 字节布尔值（true != 0、false = 0）。这是 Win32 BOOL 类型。
	BStr	长度前缀为双字节的 Unicode 字符串。可以在 String 数据类型上使用此成员（它是 COM 中的默认字符串）。
	ByValArray	当 MarshalAsAttribute.Value 设置为 ByValArray 时，必须设置 SizeConst 以指示数组中的元素数。当需要区分字符串类型时，ArraySubType 字段可以选择包含数组元素的 UnmanagedType。此 UnmanagedType 只可用于作为结构中的字段的数组。
	ByValTStr	用于在结构中出现的内联定长字符数组。与 ByValTStr 一起使用的字符类型由应用于包含结构的System.Runtime.InteropServices.StructLayoutAttribute 的 System.Runtime.InteropServices.CharSet 参数确定。应始终使用 MarshalAsAttribute.SizeConst 字段来指示数组的大小。  .NET Framework 的 ByValTStr 类型的行为类似于结构中的 C 样式、固定大小的字符串（例如，char s[5]）。托管代码中的行为与 Microsoft Visual Basic 6.0 中的行为不同，后者不是空终止（例如，MyString As String * 5）。
	Currency	在 System.Decimal 上使用，以将十进制数值作为 COM 货币类型而不是 Decimal 封送。
	CustomMarshaler	当与 MarshalAsAttribute.MarshalType 或 MarshalAsAttribute.MarshalTypeRef 一起使用时，指定自定义封送拆收器类。MarshalAsAttribute.MarshalCookie 字段可用于将附加信息传递给自定义封送拆收器。可以在任何引用类型上使用此成员。
	Error	此与 I4 或 U4 关联的本机类型将导致参数作为导出类型库中的 HRESULT 导出。
	FunctionPtr	一个可用作 C 样式函数指针的整数。可将此成员用于 Delegate 数据类型或从 Delegate 继承的类型。
	I1	1 字节有符号整数。可使用此成员将布尔值转换为 1 字节、C 样式的 bool（true = 1、false = 0）。
	I2	2 字节有符号整数。
	I4	4 字节有符号整数。
	I8	8 字节有符号整数。
	IDispatch	一个 COM IDispatch 指针（在 Microsoft Visual Basic 6.0 中为 Object）。
	Interface	COM 接口指针。从类元数据获得接口的 Guid。如果将此成员应用于类，则可以使用该成员指定确切的接口类型或默认的接口类型。当应用于 Object 数据类型时，此成员将产生 UnmanagedType.IUnknown 行为。
	IUnknown	COMIUnknown 指针。可以在 Object 数据类型上使用此成员。
	LPArray	指向 C 样式数组的第一个元素的指针。当从托管到非托管进行封送处理时，该数组的长度由托管数组的长度确定。当从非托管到托管进行封送处理时，将根据 MarshalAsAttribute.SizeConst 和MarshalAsAttribute.SizeParamIndex 字段确定该数组的长度，当需要区分字符串类型时，还可以后跟数组中元素的非托管类型。
	LPStr	单字节、空终止的 ANSI 字符串。可在 System.String 或 System.Text.StringBuilder 数据类型上使用此成员。
	LPStruct	一个指针，它指向用于封送托管格式化类的 C 样式结构。仅对平台调用方法有效。
	LPTStr	与平台相关的字符串：在 Windows 98 上为 ANSI，在 Windows NT 和 Windows XP 上为 Unicode。该值仅对平台调用受支持，而对 COM Interop 则不受支持，原因是不支持导出 LPTStr 类型的字符串。
	LPWStr	一个 2 字节、空终止的 Unicode 字符串。  请注意，如果非托管字符串不是使用非托管的 CoTaskMemAlloc 函数创建的，则不能在此非托管字符串中使用LPWStr 值。
	R4	4 字节浮点数。
	R8	8 字节浮点数。
	SafeArray	SafeArray 是自我描述的数组，它带有关联数组数据的类型、秩和界限。可将此成员与MarshalAsAttribute.SafeArraySubType 字段一起使用，以重写默认元素类型。
	Struct	一个用于封送托管格式化类和值类型的 VARIANT。
	SysInt	与平台相关的有符号整数。在 32 位 Windows 上为 4 字节，在 64 位 Windows 上为 8 字节。
	SysUInt	与平台相关的无符号整数。在 32 位 Windows 上为 4 字节，在 64 位 Windows 上为 8 字节。
	TBStr	一个有长度前缀的与平台相关的 char 字符串。在 Windows 98 上为 ANSI，在 Windows NT 上为 Unicode。很少用到这个类似于 BSTR 的成员。
	U1	1 字节无符号整数。
	U2	2 字节无符号整数。
	U4	4 字节无符号整数。
	U8	8 字节无符号整数。
	VariantBool	2 字节、OLE 定义的 VARIANT_BOOL 类型（true = -1、false = 0）。
	VBByRefStr	允许 Visual Basic 2005 在非托管代码中更改字符串，并将结果在托管代码中反映出来。该值仅对平台调用受支持。

备注

在 System.Runtime.InteropServices.MarshalAsAttribute 中使用 UnmanagedType 枚举，以指定在与非托管代码进行交互的过程中如何对类型进行封送处理。可以使用此枚举对使用简单值类型（I1、I2、I4、I8、R4、R8、U2、U4 和 U8）、.NET Framework 中未提供的非托管类型以及各种杂项类型的代码进行封送处理。

有关更多信息，请参见 与非托管代码交互操作。

示例

下面的代码段演示如何在托管源代码中声明由 COM 组件实现的非托管接口。System.Runtime.InteropServices.ComImportAttribute 防止IMyStorage 接口被导回由 COM 使用。（COM 客户端应当直接使用现有 COM 组件。）在此示例中，MarshalAsAttribute 指定若干UnmanagedType 成员，这些成员表示由原始 COM 接口使用的类型。

C#

C++

VB

using System;
using System.Runtime.InteropServices;

namespace MyModule
{
	// If you do not have a type library for an interface
	// you can redeclare it using ComImportAttribute.

	// This is how the interface would look in an idl file.

	//[
	//object,
	//uuid("73EB4AF8-BE9C-4b49-B3A4-24F4FF657B26"),
	//dual,	helpstring("IMyStorage Interface"),
	//pointer_default(unique)
	//]
	//interface IMyStorage : IDispatch
	//{
	//	[id(1)]
	//	HRESULT GetItem([in] BSTR bstrName, [out, retval] IDispatch ** ppItem);
	//	[id(2)]
	//	HRESULT GetItems([in] BSTR bstrLocation, [out] SAFEARRAY(VARIANT)* pItems);
	//	[id(3)]
	//	HRESULT GetItemDescriptions([in] BSTR bstrLocation, [out] SAFEARRAY(VARIANT) ** ppItems);
	//	[id(4), propget]
	//	HRESULT get_IsEmpty([out, retval] BOOL * pfEmpty);
	//};

	// This is the managed declaration.

	[ComImport]
	[Guid("73EB4AF8-BE9C-4b49-B3A4-24F4FF657B26")]
	public interface IMyStorage  
	{
		[DispId(1)]
		[return : MarshalAs( UnmanagedType.Interface )]
		Object GetItem( [In, MarshalAs( UnmanagedType.BStr )] String bstrName );

		[DispId(2)]
		void GetItems( [In, MarshalAs( UnmanagedType.BStr )] String bstrLocation, 
			[Out, MarshalAs( UnmanagedType.SafeArray, 
					  SafeArraySubType = VarEnum.VT_VARIANT )] out Object[] Items );
                
                
		[DispId(3)]
		void GetItemDescriptions( [In] String bstrLocation, 
			[In, Out, MarshalAs( UnmanagedType.SafeArray )] ref Object[] varDescriptions );

		bool IsEmpty 
		{
			[DispId(4)]
			[return : MarshalAs( UnmanagedType.VariantBool )]
			get;
		}
	}
}

成员

	成员名称	说明
	AnsiBStr	长度前缀为单字节的 ANSI 字符串。可以在 String 数据类型上使用此成员。
	AsAny	一个动态类型，将在运行时确定对象的类型，并将该对象作为所确定的类型进行封送处理。仅对平台调用方法有效。
	Bool	4 字节布尔值（true != 0、false = 0）。这是 Win32 BOOL 类型。
	BStr	长度前缀为双字节的 Unicode 字符串。可以在 String 数据类型上使用此成员（它是 COM 中的默认字符串）。
	ByValArray	当 MarshalAsAttribute.Value 设置为 ByValArray 时，必须设置 SizeConst 以指示数组中的元素数。当需要区分字符串类型时，ArraySubType 字段可以选择包含数组元素的 UnmanagedType。此 UnmanagedType 只可用于作为结构中的字段的数组。
	ByValTStr	用于在结构中出现的内联定长字符数组。与 ByValTStr 一起使用的字符类型由应用于包含结构的System.Runtime.InteropServices.StructLayoutAttribute 的 System.Runtime.InteropServices.CharSet 参数确定。应始终使用 MarshalAsAttribute.SizeConst 字段来指示数组的大小。  .NET Framework 的 ByValTStr 类型的行为类似于结构中的 C 样式、固定大小的字符串（例如，char s[5]）。托管代码中的行为与 Microsoft Visual Basic 6.0 中的行为不同，后者不是空终止（例如，MyString As String * 5）。
	Currency	在 System.Decimal 上使用，以将十进制数值作为 COM 货币类型而不是 Decimal 封送。
	CustomMarshaler	当与 MarshalAsAttribute.MarshalType 或 MarshalAsAttribute.MarshalTypeRef 一起使用时，指定自定义封送拆收器类。MarshalAsAttribute.MarshalCookie 字段可用于将附加信息传递给自定义封送拆收器。可以在任何引用类型上使用此成员。
	Error	此与 I4 或 U4 关联的本机类型将导致参数作为导出类型库中的 HRESULT 导出。
	FunctionPtr	一个可用作 C 样式函数指针的整数。可将此成员用于 Delegate 数据类型或从 Delegate 继承的类型。
	I1	1 字节有符号整数。可使用此成员将布尔值转换为 1 字节、C 样式的 bool（true = 1、false = 0）。
	I2	2 字节有符号整数。
	I4	4 字节有符号整数。
	I8	8 字节有符号整数。
	IDispatch	一个 COM IDispatch 指针（在 Microsoft Visual Basic 6.0 中为 Object）。
	Interface	COM 接口指针。从类元数据获得接口的 Guid。如果将此成员应用于类，则可以使用该成员指定确切的接口类型或默认的接口类型。当应用于 Object 数据类型时，此成员将产生 UnmanagedType.IUnknown 行为。
	IUnknown	COMIUnknown 指针。可以在 Object 数据类型上使用此成员。
	LPArray	指向 C 样式数组的第一个元素的指针。当从托管到非托管进行封送处理时，该数组的长度由托管数组的长度确定。当从非托管到托管进行封送处理时，将根据 MarshalAsAttribute.SizeConst 和MarshalAsAttribute.SizeParamIndex 字段确定该数组的长度，当需要区分字符串类型时，还可以后跟数组中元素的非托管类型。
	LPStr	单字节、空终止的 ANSI 字符串。可在 System.String 或 System.Text.StringBuilder 数据类型上使用此成员。
	LPStruct	一个指针，它指向用于封送托管格式化类的 C 样式结构。仅对平台调用方法有效。
	LPTStr	与平台相关的字符串：在 Windows 98 上为 ANSI，在 Windows NT 和 Windows XP 上为 Unicode。该值仅对平台调用受支持，而对 COM Interop 则不受支持，原因是不支持导出 LPTStr 类型的字符串。
	LPWStr	一个 2 字节、空终止的 Unicode 字符串。  请注意，如果非托管字符串不是使用非托管的 CoTaskMemAlloc 函数创建的，则不能在此非托管字符串中使用LPWStr 值。
	R4	4 字节浮点数。
	R8	8 字节浮点数。
	SafeArray	SafeArray 是自我描述的数组，它带有关联数组数据的类型、秩和界限。可将此成员与MarshalAsAttribute.SafeArraySubType 字段一起使用，以重写默认元素类型。
	Struct	一个用于封送托管格式化类和值类型的 VARIANT。
	SysInt	与平台相关的有符号整数。在 32 位 Windows 上为 4 字节，在 64 位 Windows 上为 8 字节。
	SysUInt	与平台相关的无符号整数。在 32 位 Windows 上为 4 字节，在 64 位 Windows 上为 8 字节。
	TBStr	一个有长度前缀的与平台相关的 char 字符串。在 Windows 98 上为 ANSI，在 Windows NT 上为 Unicode。很少用到这个类似于 BSTR 的成员。
	U1	1 字节无符号整数。
	U2	2 字节无符号整数。
	U4	4 字节无符号整数。
	U8	8 字节无符号整数。
	VariantBool	2 字节、OLE 定义的 VARIANT_BOOL 类型（true = -1、false = 0）。
	VBByRefStr	允许 Visual Basic 2005 在非托管代码中更改字符串，并将结果在托管代码中反映出来。该值仅对平台调用受支持。

备注

在 System.Runtime.InteropServices.MarshalAsAttribute 中使用 UnmanagedType 枚举，以指定在与非托管代码进行交互的过程中如何对类型进行封送处理。可以使用此枚举对使用简单值类型（I1、I2、I4、I8、R4、R8、U2、U4 和 U8）、.NET Framework 中未提供的非托管类型以及各种杂项类型的代码进行封送处理。

有关更多信息，请参见 与非托管代码交互操作。

示例

下面的代码段演示如何在托管源代码中声明由 COM 组件实现的非托管接口。System.Runtime.InteropServices.ComImportAttribute 防止IMyStorage 接口被导回由 COM 使用。（COM 客户端应当直接使用现有 COM 组件。）在此示例中，MarshalAsAttribute 指定若干UnmanagedType 成员，这些成员表示由原始 COM 接口使用的类型。

C#

C++

VB

using System;
using System.Runtime.InteropServices;

namespace MyModule
{
	// If you do not have a type library for an interface
	// you can redeclare it using ComImportAttribute.

	// This is how the interface would look in an idl file.

	//[
	//object,
	//uuid("73EB4AF8-BE9C-4b49-B3A4-24F4FF657B26"),
	//dual,	helpstring("IMyStorage Interface"),
	//pointer_default(unique)
	//]
	//interface IMyStorage : IDispatch
	//{
	//	[id(1)]
	//	HRESULT GetItem([in] BSTR bstrName, [out, retval] IDispatch ** ppItem);
	//	[id(2)]
	//	HRESULT GetItems([in] BSTR bstrLocation, [out] SAFEARRAY(VARIANT)* pItems);
	//	[id(3)]
	//	HRESULT GetItemDescriptions([in] BSTR bstrLocation, [out] SAFEARRAY(VARIANT) ** ppItems);
	//	[id(4), propget]
	//	HRESULT get_IsEmpty([out, retval] BOOL * pfEmpty);
	//};

	// This is the managed declaration.

	[ComImport]
	[Guid("73EB4AF8-BE9C-4b49-B3A4-24F4FF657B26")]
	public interface IMyStorage  
	{
		[DispId(1)]
		[return : MarshalAs( UnmanagedType.Interface )]
		Object GetItem( [In, MarshalAs( UnmanagedType.BStr )] String bstrName );

		[DispId(2)]
		void GetItems( [In, MarshalAs( UnmanagedType.BStr )] String bstrLocation, 
			[Out, MarshalAs( UnmanagedType.SafeArray, 
					  SafeArraySubType = VarEnum.VT_VARIANT )] out Object[] Items );
                
                
		[DispId(3)]
		void GetItemDescriptions( [In] String bstrLocation, 
			[In, Out, MarshalAs( UnmanagedType.SafeArray )] ref Object[] varDescriptions );

		bool IsEmpty 
		{
			[DispId(4)]
			[return : MarshalAs( UnmanagedType.VariantBool )]
			get;
		}
	}
}

成员

	成员名称	说明
	AnsiBStr	长度前缀为单字节的 ANSI 字符串。可以在 String 数据类型上使用此成员。
	AsAny	一个动态类型，将在运行时确定对象的类型，并将该对象作为所确定的类型进行封送处理。仅对平台调用方法有效。
	Bool	4 字节布尔值（true != 0、false = 0）。这是 Win32 BOOL 类型。
	BStr	长度前缀为双字节的 Unicode 字符串。可以在 String 数据类型上使用此成员（它是 COM 中的默认字符串）。
	ByValArray	当 MarshalAsAttribute.Value 设置为 ByValArray 时，必须设置 SizeConst 以指示数组中的元素数。当需要区分字符串类型时，ArraySubType 字段可以选择包含数组元素的 UnmanagedType。此 UnmanagedType 只可用于作为结构中的字段的数组。
	ByValTStr	用于在结构中出现的内联定长字符数组。与 ByValTStr 一起使用的字符类型由应用于包含结构的System.Runtime.InteropServices.StructLayoutAttribute 的 System.Runtime.InteropServices.CharSet 参数确定。应始终使用 MarshalAsAttribute.SizeConst 字段来指示数组的大小。  .NET Framework 的 ByValTStr 类型的行为类似于结构中的 C 样式、固定大小的字符串（例如，char s[5]）。托管代码中的行为与 Microsoft Visual Basic 6.0 中的行为不同，后者不是空终止（例如，MyString As String * 5）。
	Currency	在 System.Decimal 上使用，以将十进制数值作为 COM 货币类型而不是 Decimal 封送。
	CustomMarshaler	当与 MarshalAsAttribute.MarshalType 或 MarshalAsAttribute.MarshalTypeRef 一起使用时，指定自定义封送拆收器类。MarshalAsAttribute.MarshalCookie 字段可用于将附加信息传递给自定义封送拆收器。可以在任何引用类型上使用此成员。
	Error	此与 I4 或 U4 关联的本机类型将导致参数作为导出类型库中的 HRESULT 导出。
	FunctionPtr	一个可用作 C 样式函数指针的整数。可将此成员用于 Delegate 数据类型或从 Delegate 继承的类型。
	I1	1 字节有符号整数。可使用此成员将布尔值转换为 1 字节、C 样式的 bool（true = 1、false = 0）。
	I2	2 字节有符号整数。
	I4	4 字节有符号整数。
	I8	8 字节有符号整数。
	IDispatch	一个 COM IDispatch 指针（在 Microsoft Visual Basic 6.0 中为 Object）。
	Interface	COM 接口指针。从类元数据获得接口的 Guid。如果将此成员应用于类，则可以使用该成员指定确切的接口类型或默认的接口类型。当应用于 Object 数据类型时，此成员将产生 UnmanagedType.IUnknown 行为。
	IUnknown	COMIUnknown 指针。可以在 Object 数据类型上使用此成员。
	LPArray	指向 C 样式数组的第一个元素的指针。当从托管到非托管进行封送处理时，该数组的长度由托管数组的长度确定。当从非托管到托管进行封送处理时，将根据 MarshalAsAttribute.SizeConst 和MarshalAsAttribute.SizeParamIndex 字段确定该数组的长度，当需要区分字符串类型时，还可以后跟数组中元素的非托管类型。
	LPStr	单字节、空终止的 ANSI 字符串。可在 System.String 或 System.Text.StringBuilder 数据类型上使用此成员。
	LPStruct	一个指针，它指向用于封送托管格式化类的 C 样式结构。仅对平台调用方法有效。
	LPTStr	与平台相关的字符串：在 Windows 98 上为 ANSI，在 Windows NT 和 Windows XP 上为 Unicode。该值仅对平台调用受支持，而对 COM Interop 则不受支持，原因是不支持导出 LPTStr 类型的字符串。
	LPWStr	一个 2 字节、空终止的 Unicode 字符串。  请注意，如果非托管字符串不是使用非托管的 CoTaskMemAlloc 函数创建的，则不能在此非托管字符串中使用LPWStr 值。
	R4	4 字节浮点数。
	R8	8 字节浮点数。
	SafeArray	SafeArray 是自我描述的数组，它带有关联数组数据的类型、秩和界限。可将此成员与MarshalAsAttribute.SafeArraySubType 字段一起使用，以重写默认元素类型。
	Struct	一个用于封送托管格式化类和值类型的 VARIANT。
	SysInt	与平台相关的有符号整数。在 32 位 Windows 上为 4 字节，在 64 位 Windows 上为 8 字节。
	SysUInt	与平台相关的无符号整数。在 32 位 Windows 上为 4 字节，在 64 位 Windows 上为 8 字节。
	TBStr	一个有长度前缀的与平台相关的 char 字符串。在 Windows 98 上为 ANSI，在 Windows NT 上为 Unicode。很少用到这个类似于 BSTR 的成员。
	U1	1 字节无符号整数。
	U2	2 字节无符号整数。
	U4	4 字节无符号整数。
	U8	8 字节无符号整数。
	VariantBool	2 字节、OLE 定义的 VARIANT_BOOL 类型（true = -1、false = 0）。
	VBByRefStr	允许 Visual Basic 2005 在非托管代码中更改字符串，并将结果在托管代码中反映出来。该值仅对平台调用受支持。

备注

在 System.Runtime.InteropServices.MarshalAsAttribute 中使用 UnmanagedType 枚举，以指定在与非托管代码进行交互的过程中如何对类型进行封送处理。可以使用此枚举对使用简单值类型（I1、I2、I4、I8、R4、R8、U2、U4 和 U8）、.NET Framework 中未提供的非托管类型以及各种杂项类型的代码进行封送处理。

有关更多信息，请参见 与非托管代码交互操作。

示例

下面的代码段演示如何在托管源代码中声明由 COM 组件实现的非托管接口。System.Runtime.InteropServices.ComImportAttribute 防止IMyStorage 接口被导回由 COM 使用。（COM 客户端应当直接使用现有 COM 组件。）在此示例中，MarshalAsAttribute 指定若干UnmanagedType 成员，这些成员表示由原始 COM 接口使用的类型。

C#

C++

VB

using System;
using System.Runtime.InteropServices;

namespace MyModule
{
	// If you do not have a type library for an interface
	// you can redeclare it using ComImportAttribute.

	// This is how the interface would look in an idl file.

	//[
	//object,
	//uuid("73EB4AF8-BE9C-4b49-B3A4-24F4FF657B26"),
	//dual,	helpstring("IMyStorage Interface"),
	//pointer_default(unique)
	//]
	//interface IMyStorage : IDispatch
	//{
	//	[id(1)]
	//	HRESULT GetItem([in] BSTR bstrName, [out, retval] IDispatch ** ppItem);
	//	[id(2)]
	//	HRESULT GetItems([in] BSTR bstrLocation, [out] SAFEARRAY(VARIANT)* pItems);
	//	[id(3)]
	//	HRESULT GetItemDescriptions([in] BSTR bstrLocation, [out] SAFEARRAY(VARIANT) ** ppItems);
	//	[id(4), propget]
	//	HRESULT get_IsEmpty([out, retval] BOOL * pfEmpty);
	//};

	// This is the managed declaration.

	[ComImport]
	[Guid("73EB4AF8-BE9C-4b49-B3A4-24F4FF657B26")]
	public interface IMyStorage  
	{
		[DispId(1)]
		[return : MarshalAs( UnmanagedType.Interface )]
		Object GetItem( [In, MarshalAs( UnmanagedType.BStr )] String bstrName );

		[DispId(2)]
		void GetItems( [In, MarshalAs( UnmanagedType.BStr )] String bstrLocation, 
			[Out, MarshalAs( UnmanagedType.SafeArray, 
					  SafeArraySubType = VarEnum.VT_VARIANT )] out Object[] Items );
                
                
		[DispId(3)]
		void GetItemDescriptions( [In] String bstrLocation, 
			[In, Out, MarshalAs( UnmanagedType.SafeArray )] ref Object[] varDescriptions );

		bool IsEmpty 
		{
			[DispId(4)]
			[return : MarshalAs( UnmanagedType.VariantBool )]
			get;
		}
	}
}

	成员名称	说明
	AnsiBStr	长度前缀为单字节的 ANSI 字符串。可以在 String 数据类型上使用此成员。
	AsAny	一个动态类型，将在运行时确定对象的类型，并将该对象作为所确定的类型进行封送处理。仅对平台调用方法有效。
	Bool	4 字节布尔值（true != 0、false = 0）。这是 Win32 BOOL 类型。
	BStr	长度前缀为双字节的 Unicode 字符串。可以在 String 数据类型上使用此成员（它是 COM 中的默认字符串）。
	ByValArray	当 MarshalAsAttribute.Value 设置为 ByValArray 时，必须设置 SizeConst 以指示数组中的元素数。当需要区分字符串类型时，ArraySubType 字段可以选择包含数组元素的 UnmanagedType。此 UnmanagedType 只可用于作为结构中的字段的数组。
	ByValTStr	用于在结构中出现的内联定长字符数组。与 ByValTStr 一起使用的字符类型由应用于包含结构的System.Runtime.InteropServices.StructLayoutAttribute 的 System.Runtime.InteropServices.CharSet 参数确定。应始终使用 MarshalAsAttribute.SizeConst 字段来指示数组的大小。  .NET Framework 的 ByValTStr 类型的行为类似于结构中的 C 样式、固定大小的字符串（例如，char s[5]）。托管代码中的行为与 Microsoft Visual Basic 6.0 中的行为不同，后者不是空终止（例如，MyString As String * 5）。
	Currency	在 System.Decimal 上使用，以将十进制数值作为 COM 货币类型而不是 Decimal 封送。
	CustomMarshaler	当与 MarshalAsAttribute.MarshalType 或 MarshalAsAttribute.MarshalTypeRef 一起使用时，指定自定义封送拆收器类。MarshalAsAttribute.MarshalCookie 字段可用于将附加信息传递给自定义封送拆收器。可以在任何引用类型上使用此成员。
	Error	此与 I4 或 U4 关联的本机类型将导致参数作为导出类型库中的 HRESULT 导出。
	FunctionPtr	一个可用作 C 样式函数指针的整数。可将此成员用于 Delegate 数据类型或从 Delegate 继承的类型。
	I1	1 字节有符号整数。可使用此成员将布尔值转换为 1 字节、C 样式的 bool（true = 1、false = 0）。
	I2	2 字节有符号整数。
	I4	4 字节有符号整数。
	I8	8 字节有符号整数。
	IDispatch	一个 COM IDispatch 指针（在 Microsoft Visual Basic 6.0 中为 Object）。
	Interface	COM 接口指针。从类元数据获得接口的 Guid。如果将此成员应用于类，则可以使用该成员指定确切的接口类型或默认的接口类型。当应用于 Object 数据类型时，此成员将产生 UnmanagedType.IUnknown 行为。
	IUnknown	COMIUnknown 指针。可以在 Object 数据类型上使用此成员。
	LPArray	指向 C 样式数组的第一个元素的指针。当从托管到非托管进行封送处理时，该数组的长度由托管数组的长度确定。当从非托管到托管进行封送处理时，将根据 MarshalAsAttribute.SizeConst 和MarshalAsAttribute.SizeParamIndex 字段确定该数组的长度，当需要区分字符串类型时，还可以后跟数组中元素的非托管类型。
	LPStr	单字节、空终止的 ANSI 字符串。可在 System.String 或 System.Text.StringBuilder 数据类型上使用此成员。
	LPStruct	一个指针，它指向用于封送托管格式化类的 C 样式结构。仅对平台调用方法有效。
	LPTStr	与平台相关的字符串：在 Windows 98 上为 ANSI，在 Windows NT 和 Windows XP 上为 Unicode。该值仅对平台调用受支持，而对 COM Interop 则不受支持，原因是不支持导出 LPTStr 类型的字符串。
	LPWStr	一个 2 字节、空终止的 Unicode 字符串。  请注意，如果非托管字符串不是使用非托管的 CoTaskMemAlloc 函数创建的，则不能在此非托管字符串中使用LPWStr 值。
	R4	4 字节浮点数。
	R8	8 字节浮点数。
	SafeArray	SafeArray 是自我描述的数组，它带有关联数组数据的类型、秩和界限。可将此成员与MarshalAsAttribute.SafeArraySubType 字段一起使用，以重写默认元素类型。
	Struct	一个用于封送托管格式化类和值类型的 VARIANT。
	SysInt	与平台相关的有符号整数。在 32 位 Windows 上为 4 字节，在 64 位 Windows 上为 8 字节。
	SysUInt	与平台相关的无符号整数。在 32 位 Windows 上为 4 字节，在 64 位 Windows 上为 8 字节。
	TBStr	一个有长度前缀的与平台相关的 char 字符串。在 Windows 98 上为 ANSI，在 Windows NT 上为 Unicode。很少用到这个类似于 BSTR 的成员。
	U1	1 字节无符号整数。
	U2	2 字节无符号整数。
	U4	4 字节无符号整数。
	U8	8 字节无符号整数。
	VariantBool	2 字节、OLE 定义的 VARIANT_BOOL 类型（true = -1、false = 0）。
	VBByRefStr	允许 Visual Basic 2005 在非托管代码中更改字符串，并将结果在托管代码中反映出来。该值仅对平台调用受支持。

备注

在 System.Runtime.InteropServices.MarshalAsAttribute 中使用 UnmanagedType 枚举，以指定在与非托管代码进行交互的过程中如何对类型进行封送处理。可以使用此枚举对使用简单值类型（I1、I2、I4、I8、R4、R8、U2、U4 和 U8）、.NET Framework 中未提供的非托管类型以及各种杂项类型的代码进行封送处理。

有关更多信息，请参见 与非托管代码交互操作。

示例

下面的代码段演示如何在托管源代码中声明由 COM 组件实现的非托管接口。System.Runtime.InteropServices.ComImportAttribute 防止IMyStorage 接口被导回由 COM 使用。（COM 客户端应当直接使用现有 COM 组件。）在此示例中，MarshalAsAttribute 指定若干UnmanagedType 成员，这些成员表示由原始 COM 接口使用的类型。

C#

C++

VB

using System;
using System.Runtime.InteropServices;

namespace MyModule
{
	// If you do not have a type library for an interface
	// you can redeclare it using ComImportAttribute.

	// This is how the interface would look in an idl file.

	//[
	//object,
	//uuid("73EB4AF8-BE9C-4b49-B3A4-24F4FF657B26"),
	//dual,	helpstring("IMyStorage Interface"),
	//pointer_default(unique)
	//]
	//interface IMyStorage : IDispatch
	//{
	//	[id(1)]
	//	HRESULT GetItem([in] BSTR bstrName, [out, retval] IDispatch ** ppItem);
	//	[id(2)]
	//	HRESULT GetItems([in] BSTR bstrLocation, [out] SAFEARRAY(VARIANT)* pItems);
	//	[id(3)]
	//	HRESULT GetItemDescriptions([in] BSTR bstrLocation, [out] SAFEARRAY(VARIANT) ** ppItems);
	//	[id(4), propget]
	//	HRESULT get_IsEmpty([out, retval] BOOL * pfEmpty);
	//};

	// This is the managed declaration.

	[ComImport]
	[Guid("73EB4AF8-BE9C-4b49-B3A4-24F4FF657B26")]
	public interface IMyStorage  
	{
		[DispId(1)]
		[return : MarshalAs( UnmanagedType.Interface )]
		Object GetItem( [In, MarshalAs( UnmanagedType.BStr )] String bstrName );

		[DispId(2)]
		void GetItems( [In, MarshalAs( UnmanagedType.BStr )] String bstrLocation, 
			[Out, MarshalAs( UnmanagedType.SafeArray, 
					  SafeArraySubType = VarEnum.VT_VARIANT )] out Object[] Items );
                
                
		[DispId(3)]
		void GetItemDescriptions( [In] String bstrLocation, 
			[In, Out, MarshalAs( UnmanagedType.SafeArray )] ref Object[] varDescriptions );

		bool IsEmpty 
		{
			[DispId(4)]
			[return : MarshalAs( UnmanagedType.VariantBool )]
			get;
		}
	}
}