WS_XML_WRITER_RAW_ENCODING 结构 (webservices.h)

用于指示编写器应从解码的 base64 字符发出字节。

语法

typedef struct _WS_XML_WRITER_RAW_ENCODING {
  WS_XML_WRITER_ENCODING encoding;
} WS_XML_WRITER_RAW_ENCODING;

成员

encoding

派生自 WS_XML_WRITER_ENCODING 的所有类型的基类型。

注解

当需要编写任意(可能是非 xml 文档)同时仍使用 WS_XML_WRITER 抽象时,此编码非常有用。 在此编码中,只能写入表示 base64 编码字节的字符,并且只能在文档的根目录中写入。 不能写入任何元素或注释。 编写器将发出由 base64 编码字符表示的字节。 为了在文档根目录中容纳非空格文本,编写器将像指定 WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT 属性一样运行。

文档的 base64 字符仅在必要时转换为字节。 因此,例如,使用 WsWriteBytes 通常执行传递字节的 base64 编码,实际上可避免所有 base64 转换,并且是使用此编码编写文档的最有效方法。 例如,使用 WsWriteChars 将导致 base64 字符以物理方式解码为相应的字节。 通常,使用 WsReadBytes、WsPullBytesWsPushBytes 以外的任何内容编写文档时,将产生 base64 转换。

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
标头 webservices.h