Udostępnij za pośrednictwem

2.2.2.9 Body

  • Artykuł

The Body element is an optional child element of the airsync:ApplicationData element ([MS-ASCMD] section 2.2.3.11), the itemoperations:Properties element ([MS-ASCMD] section 2.2.3.139.2), the search:Properties element ([MS-ASCMD] section 2.2.3.139.3), the meetingresponse:SendResponse element ([MS-ASCMD] section 2.2.3.163), and the composemail:SmartForward element ([MS-ASCMD] section 2.2.3.169) that specifies a free-form, variable-length data field associated with an item stored on the server. The item can be for any of the following content classes: Calendar, Contact, Email, Notes, SMS, or Tasks.

The Body element is a container data type, as specified in [MS-ASDTYPE] section 2.2.

The Body element MUST be included in a response message whenever an item has changes or new items are created. There is no limit on the number of Body elements in a command response. When included in a command response, the Body element indicates the existence of one or more variable-length fields of data associated with the item. Command requests can include the Body element.

The Body element, if present, has the following required and optional child elements in this order:

  • Type (section 2.2.2.41.1): This element is required.

  • EstimatedDataSize (section 2.2.2.23.2): This element is optional.

  • Truncated (section 2.2.2.39.1). This element is optional.

  • Data (section 2.2.2.20.1): This element is optional.

  • Part (section 2.2.2.33): This element is optional.

  • Preview (section 2.2.2.35.1): This element is optional.

When the Body element is a child of the meetingresponse:SendResponse element or the composemail:SmartForward element, it has only the child elements Type and Data.

Protocol Versions

The following table specifies the protocol versions that support this element. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.

Protocol version

Element support

2.5

12.0

Yes

12.1

Yes

14.0

Yes

14.1

Yes

16.0

Yes

16.1

Yes

For the Calendar, Contact, Email, and Tasks content classes, the Body element that is defined in the respective class namespace is used with protocol version 2.5 instead of the Body element of the AirSyncBase namespace. For details, see the [MS-ASCAL], [MS-ASCNTC], [MS-ASEMAIL], and [MS-ASTASK] documents.

The Body element is a child of the meetingresponse:SendResponse element and the composemail:SmartForward element only when protocol version 16.0 or 16.1 is used.