PROPPATCH Method

PROPPATCH Method

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release. The WebDAVPROPPATCH method sets properties for the resource at the specified destination Uniform Resource Identifier (URI). All property names must be scoped in the XML body using namespace URI references.

When a PROPPATCH method or a BPROPPATCH Method request contains a Brief Header with a value of "t", every propstat XML Element with a status of 200 (OK) is omitted from the 207 (Multi-Status) response. If all operations on all resources are completed successfully, the 200 (OK) response may be returned instead of a 207 (Multi-Status) response.

The PROPPATCH method may be included in the scope of a transaction by submitting a Transaction Header with a lock token that corresponds to that transaction.

Note  See Authentication and Security Using WebDAV for more information.

The list of WebDAV Protocol Status Codes in the following table is not comprehensive. For information about 500-level status codes, see WebDAV Status Codes: 500s.

The following are response codes that can be expected to be used in a 207 (Multi-Status) response for this method.

The following example illustrates a WebDAVPROPPATCH method.

PROPPATCH /docs/myfile.doc HTTP/1.1
Host: www.contoso.com
Content-Type: text/xml
Content-Length: XXX
Translate: F

<?xml version="1.0"?>
<d:propertyupdate xmlns:d="DAV:" xmlns:o="urn:schemas-microsoft-com:office:office">
  <d:set>
    <d:prop>
      <o:Author>Douglas Groncki</o:Author>
    </d:prop>
  </d:set>
</d:propertyupdate>

HTTP/1.1 207 Multi-Status
Server: Microsoft-IIS/5.0
Date: Wed, 04 Aug 1999 21:52:58 GMT
Content-Type: text/xml
Content-Length: 310

<?xml version="1.0"?>
<a:multistatus xmlns:b="urn:schemas-microsoft-com:office:office" xmlns:a="DAV:">
  <a:response>
    <a:href>https://www.contoso.com/docs/myfile.doc</a:href>
    <a:propstat>
      <a:status>HTTP/1.1 200 OK</a:status>
        <a:prop>
          <b:Author/>
        </a:prop>
    </a:propstat>
  </a:response>
</a:multistatus>

• BPROPPATCH Method
• Creating Items (WebDAV)
• Removing Properties (WebDAV)

Send us your feedback about the Microsoft Exchange Server 2003 SDK.

This topic last updated: June 2004

Build: June 2007 (2007.618.1)

© 2003-2006 Microsoft Corporation. All rights reserved. Terms of use.