IObjectAdapter 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
定义可以对 JSON 修补程序文档执行的操作。
public interface class IObjectAdapter
public interface IObjectAdapter
type IObjectAdapter = interface
Public Interface IObjectAdapter
- 派生
方法
Add(Operation, Object) |
使用“添加”操作将新值插入目标文档的根目录、指定有效索引处的目标数组或指定位置的目标对象中。 向数组添加时,指定的索引不得大于数组中的元素数。 若要将值追加到数组,请使用“-”字符的索引, (请参阅 [RFC6901]) 。 添加到对象时,如果对象成员尚不存在,则会在指定位置向对象添加新成员;如果对象成员确实存在,则会替换该成员的值。 操作对象必须包含一个“value”成员,其内容指定要添加的值。 例如: { “op”: “add”, “path”: “/a/b/c”, “value”: [ “foo”, “bar” ] } 请参阅 RFC 6902 https://tools.ietf.org/html/rfc6902#page-4 |
Copy(Operation, Object) |
使用“复制”操作,将值从指定位置复制到目标位置。 操作对象必须包含一个“from”成员,该成员引用目标文档中要从其复制值的位置。 必须存在“发件人”位置才能使操作成功。 例如: { “op”: “copy”, “from”: “/a/b/c”, “path”: “/a/b/e” } 请参阅 RFC 6902 https://tools.ietf.org/html/rfc6902#page-7 |
Move(Operation, Object) |
使用“移动”操作删除指定位置的值并将其添加到目标位置。 操作对象必须包含一个“from”成员,该成员引用要从中移动值的目标文档中的位置。 必须存在“发件人”位置才能使操作成功。 例如: { “op”: “move”, “from”: “/a/b/c”, “path”: “/a/b/d” } 无法将某个位置移到其某个子级中。 请参阅 RFC 6902 https://tools.ietf.org/html/rfc6902#page-6 |
Remove(Operation, Object) |
使用“删除”操作删除目标位置的值。 必须存在目标位置才能使操作成功。 例如: { “op”: “remove”, “path”: “/a/b/c” } 如果从数组中删除元素,则指定索引上方的任何元素都向左移动一个位置。 请参阅 RFC 6902 https://tools.ietf.org/html/rfc6902#page-6 |
Replace(Operation, Object) |
使用“替换”操作,目标位置的值将替换为新值。 操作对象必须包含指定替换值的“value”成员。 必须存在目标位置才能使操作成功。 例如: { “op”: “replace”, “path”: “/a/b/c”, “value”: 42 } 请参阅 RFC 6902 https://tools.ietf.org/html/rfc6902#page-6 |