AllOrNone
BodyPreference.AllOrNone property
客户端可以在命令请求中包含多个 BodyPreference 元素,其中 Type 元素具有不同的值(第 2.2.2.22.4 节)。 默认情况下,服务器返回的数据被截断为 TruncationSize 请求的与项目的 Body 元素的本机存储格式匹配的 Type 元素的大小。 但是,如果客户端还包括值为 TRUE 的 AllOrNone 元素以及 TruncationSize 元素,则它指示服务器在可用数据的大小(以字节为单位)超过该值时不要返回该类型的截断响应TruncationSize 元素。 例如,客户端可以使用这两个元素来表示它不能处理部分富文本格式 (RTF) 数据(Type 元素值为 3)。 在这种情况下,如果客户端指定了多个 BodyPreference 元素,则服务器选择下一个 BodyPreference 元素,它将向客户端返回最大数量的正文文本。 假设客户端指定了两个 BodyPreference 元素。 如果未定义 AllOrNone 元素,则搜索、同步或检索截断或未截断的内容,就像值设置为 FALSE 一样。
public bool? AllOrNone { get; set; }