字符串的封送处理

最新推荐文章于 2021-03-16 09:53:25 发布

cuibinmo3519

最新推荐文章于 2021-03-16 09:53:25 发布

阅读量206

点赞数

System.String 和 System.StringBuilder 类都有相似的封送处理行为。它们之间的主要差异是字符串是不可变的，而 StringBuilder 缓冲区的内容则可以由被调用方更改并复制回调用方。

本主题提供下列有关封送字符串类型的信息：

· 类库中使用的字符串

· 平台调用中使用的字符串

· 结构中使用的字符串

· 定长字符串缓冲区

类库中使用的字符串

下表显示字符串数据类型被作为方法参数封送到非托管代码时的封送处理选项。MarshalAsAttribute 属性提供了若干个 UnmanagedType 枚举值，以便将字符串封送到 COM 接口。

枚举类型	非托管格式的说明
UnmanagedType.BStr（默认）	具有预设长度和 Unicode 字符的 COM 样式的 BSTR。
UnmanagedType.LPStr	指向 ANSI 字符的空终止数组的指针。
UnmanagedType.LPWStr	指向 Unicode 字符的空终止数组的指针。

下面的示例显示 IStringWorker 接口中声明的字符串。

下面的示例显示在类型库中描述的对应接口。

interface IStringWorker : IDispatch {

HRESULT PassString1([in] BSTR s);

HRESULT PassString2([in] BSTR s);

HRESULT PassString3([in] LPStr s);

HRESULT PassString4([in] LPWStr s);

HRESULT PassStringRef1([in, out] BSTR *s);

HRESULT PassStringRef2([in, out] BSTR *s);

HRESULT PassStringRef3([in, out] LPStr *s);

HRESULT PassStringRef4([in, out] LPWStr *s);

);

平台调用中使用的字符串

平台调用复制字符串参数，并从 .NET Framework 格式 (Unicode) 转换为平台非托管格式。字符串是不可变的，在调用返回时不会从非托管内存复制回托管内存。

下表列出了在字符串被作为对平台调用进行的调用的方法参数封送时的封送处理选项。MarshalAsAttribute 属性提供了若干个 UnmanagedType 枚举值以封送字符串。

枚举类型	非托管格式的说明
UnmanagedType.AnsiBStr	具有预设长度并包含 ANSI 字符的 COM 样式 BSTR。
UnmanagedType.BStr（默认）	具有预设长度和 Unicode 字符的 COM 样式的 BSTR。
UnmanagedType.LPStr	指向 ANSI 字符的空终止数组的指针。
UnmanagedType.LPTStr	指向平台相关的字符的空终止数组的指针。
UnmanagedType.LPWStr	指向 Unicode 字符的空终止数组的指针。
UnmanagedType.TBStr	具有预设长度并包含平台相关字符的 COM 样式 BSTR。

下面的类型定义针对平台调用的调用显示 MarshalAsAttribute 的正确用法。

class StringLibAPI {

[DllImport("StringLib.Dll")]

public static extern void PassLPStr([MarshalAs(UnmanagedType.LPStr)] String s);

[DllImport("StringLib.Dll")]

public static extern void

PassLPWStr([MarshalAs(UnmanagedType.LPWStr)]String s);

[DllImport("StringLib.Dll")]

public static extern void

PassLPTStr([MarshalAs(UnmanagedType.LPTStr)]String s);

[DllImport("StringLib.Dll")]

public static extern void PassBStr([MarshalAs(UnmanagedType.BStr)]

String s);

[DllImport("StringLib.Dll")]

public static extern void

PassAnsiBStr([MarshalAs(UnmanagedType.AnsiBStr)]String s);

[DllImport("StringLib.Dll")]

public static extern void PassTBStr([MarshalAs(UnmanagedType.TBStr)]

String s);

}

结构中使用的字符串

字符串是结构的有效成员；但是，StringBuilder 缓冲区在结构中是无效的。下表显示当字符串数据类型被作为字段封送时该类型的封送处理选项。MarshalAsAttribute 属性提供了若干个 UnmanagedType 枚举值，以便将字符串封送到字段。

枚举类型	非托管格式的说明
UnmanagedType.BStr	具有预设长度和 Unicode 字符的 COM 样式的 BSTR。
UnmanagedType.LPStr	指向 ANSI 字符的空终止数组的指针。
UnmanagedType.LPTStr	指向平台相关的字符的空终止数组的指针。
UnmanagedType.LPWStr	指向 Unicode 字符的空终止数组的指针。
UnmanagedType.ByValTStr	定长的字符数组；数组的类型由包含数组的结构的字符集确定。