depth (property)

The depth associated with the current operation.

Syntax

@property (nonatomic,readwrite,assign,getter=depth,setter=setDepth:) int depth;
- (int)depth;
- (void)setDepth:(int)newDepth;

/* Possible Values */
DP_UNSPECIFIED(0),
DP_RESOURCE_ONLY(1),
DP_IMMEDIATE_CHILDREN(2),
DP_INFINITY(3)
public var depth: WebdavDepths {
  get {...}
set {...} }
public enum WebdavDepths : Int32 { case dpUnspecified = 0 case dpResourceOnly = 1 case dpImmediateChildren = 2 case dpInfinity = 3 }

Default Value

0

Remarks

When performing certain operations on resource collections, the class will use Depth to instruct the server on how deep to operate within the collection. Depth is an enumerated type with the following possible values:

dpUnspecified (0)The server will use the protocol default depth for the operation (this is normally "infinity").
dpResourceOnly (1)The server will operate only on the collection resource URI, and not on any of its internal member resources.
dpImmediateChildren (2)The server will operate on the collection resource URI and all of its immediate member resources (but on none of their member resources).
dpInfinity (3)The server will recursively operate on the target resource URI and all of its internal member URIs through all levels of the collection hierarchy.

Depth is used when performing the following operations: LockResource, MoveResource CopyResource, FindProperties, PatchProperties, and ListDirectory.

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks 2020 iOS Edition - Version 20.0 [Build 8161]