IObjectAdapter Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет операции, которые могут выполняться с документом исправлений 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, который ссылается на расположение в целевом документе для копирования значения. Для успешного выполнения операции должно существовать расположение 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, который ссылается на расположение в целевом документе для перемещения значения. Для успешного выполнения операции должно существовать расположение from. Пример: { "op": "move", "from": "/a/b/c", "path": "/a/b/d" } Расположение не может быть перемещено в один из его дочерних элементов. См. RFC 6902 https://tools.ietf.org/html/rfc6902#page-6 |
Remove(Operation, Object) |
С помощью операции remove значение в целевом расположении удаляется. Целевое расположение ДОЛЖНО существовать для успешного выполнения операции. Пример: { "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 |