[3] [CODE(URI)@en[[[DAV:]]]] [[名前空間]]の [DFN[[CODE(XMLe)@en[[[propstat]]]]]]
[[要素]]は、 [CODE(XMLe)@en[[[prop]]]] [[要素]]と [CODE(XMLe)@en[[[status]]]]
[[要素]]をまとめるものです [SRC[>>1]]。

* 仕様書

[REFS[
- [1] '''[CITE@en[RFC 4918 - HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)]] ([TIME[2014-09-21 17:04:59 +09:00]] 版) <http://tools.ietf.org/html/rfc4918#section-14.22>'''
- [7] [CITE@en[RFC 4918 - HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)]] ([TIME[2014-09-21 17:04:59 +09:00]] 版) <http://tools.ietf.org/html/rfc4918#section-14.24>
- [10] [CITE@en[RFC 4918 - HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)]] ([TIME[2014-09-21 17:04:59 +09:00]] 版) <http://tools.ietf.org/html/rfc4918#section-17>
]REFS]

* 内容

[4] [CODE(XMLe)@en[[[propstat]]]] [[要素]]の[[内容]]は[[要素内容]]で、
[CODE(XMLe)@en[[[prop]]]] [[要素]]と [CODE(XMLe)@en[[[status]]]]
[[要素]]を1つずつ含めなければ[['''なりません''']]。
更に [CODE(XMLe)@en[[[error]]]] [[要素]]と [CODE(XMLe)@en[[[responsedescription]]]]
[[要素]]を1つずつ含めることができます。 [SRC[>>1]]
順序は意味を持ちません [SRC[>>10]]。

[5] [CODE(XMLe)@en[[[prop]]]] [[要素]]は、 [CODE(XMLe)@en[[[status]]]]
[[要素]]に示された結果が適用される[[特性]]のみ列挙しなければ[['''なりません''']]。 [SRC[>>1]]

[6] [CODE(XMLe)@en[[[error]]]] [[要素]]や [CODE(XMLe)@en[[[responsedescription]]]]
[[要素]]が含まれる場合、これらも [CODE(XMLe)@en[[[prop]]]] [[要素]]の[[特性]]に関するものです。
[SRC[>>1]]

;; [9] [CODE(XMLe)@en[[[location]]]] [[要素]]は認められていません。

* 文脈

[8] [CODE(XMLe)@en[[[response]]]] [[要素]]で使うことができます [SRC[>>7]]。

* 歴史

[FIG(quote)[
[FIGCAPTION[
[2] RFC 2518 (WebDAV) 12.9.1.1  propstat XML Element
]FIGCAPTION]

>
:   Name:       [CODE(DAVe)[propstat]]
:   Namespace:  [CODE(URI)[[[DAV:]]]]
:   Purpose:    Groups together a prop and status element that is
associated with a particular href element.
:   Description: The propstat XML element MUST contain one prop XML
element and one status XML element.  The contents of the prop XML
element MUST only list the names of properties to which the result in
the status element applies.

: 目的 : 特定の [CODE(DAVe)[href]] 要素に関連付けられる
[CODE(DAVe)[prop]] 要素と [CODE(DAVe)[status]] 要素を集団化します。
: 説明 : [CODE(DAVe)[propstat]] 要素は1つの [CODE(DAVe)[prop]] XML 要素と
1つの [CODE(DAVe)[status]] 要素を含まなければ'''なりません'''。
[CODE(DAVe)[prop]] XML 要素の内容は [CODE(DAVe)[status]] 要素が適用されることになる[[特性]]の名前だけを列挙しなければ'''なりません'''。

>   <!ELEMENT [CODE(DAVe)[propstat]] ([CODE(DAVe)[[[prop]]]], [CODE(DAVe)[[[status]]]], [CODE(DAVe)[[[responsedescription]]]]?) >
]FIG]