ObjectAdapter.Add(Operation, Object) Metoda

Definicja

Przestrzeń nazw:

Microsoft.AspNetCore.JsonPatch.Adapters

Zestaw:

Microsoft.AspNetCore.JsonPatch.dll

Pakiet:

Microsoft.AspNetCore.JsonPatch v9.0.0

Źródło:

ObjectAdapter.cs

Operacja "add" wykonuje jedną z następujących funkcji, w zależności od tego, do czego odwołuje się lokalizacja docelowa:

o Jeśli lokalizacja docelowa określa indeks tablicy, nowa wartość zostanie wstawiona do tablicy w określonym indeksie.

o Jeśli lokalizacja docelowa określa element członkowski obiektu, który jeszcze nie istnieje, nowy element członkowski zostanie dodany do obiektu.

o Jeśli lokalizacja docelowa określa element członkowski obiektu, który istnieje, wartość tego elementu członkowskiego zostanie zamieniona.

Obiekt operacji MUSI zawierać element członkowski "value", którego zawartość określa wartość, która ma zostać dodana.

Przykład:

{ "op": "add", "path": "/a/b/c", "value": [ "foo", "bar" ] }

Po zastosowaniu operacji lokalizacja docelowa MUSI odwoływać się do jednej z następujących elementów:

o Katalog główny dokumentu docelowego — gdzie wartość określona staje się całą zawartością dokumentu docelowego.

o Element członkowski, który ma zostać dodany do istniejącego obiektu — gdzie podana wartość jest dodawana do tego obiektu w wskazanej lokalizacji. Jeśli element członkowski już istnieje, zostanie zastąpiony określoną wartością.

o Element, który ma zostać dodany do istniejącej tablicy — gdzie jest dodawana podana wartość do tablicy w wskazanej lokalizacji. Wszystkie elementy w lub powyżej określonego indeksu są przesunięte w jedną pozycję po prawej stronie. Określony indeks NIE MOŻE być większy niż liczba elementów w tablicy. Jeśli znak "-" jest używany do indeksowania końca tablicy (zobacz [RFC6901]), ma to wpływ na dołączenie wartości do tablicy.

Ponieważ ta operacja jest przeznaczona do dodawania do istniejących obiektów i tablic, jej lokalizacja docelowa często nie istnieje. Mimo że algorytm obsługi błędów wskaźnika zostanie wywołany, ta specyfikacja definiuje zachowanie obsługi błędów dla wskaźników "add" w celu zignorowania tego błędu i dodania wartości zgodnie z określoną.

Jednak sam obiekt lub tablica zawierająca ją musi istnieć i pozostaje błędem, aby nie być takim przypadkiem. Na przykład "dodaj" z lokalizacją docelową "/a/b", zaczynając od tego dokumentu:

{ "a": { "foo": 1 } }

nie jest błędem, ponieważ "a" istnieje, a element "b" zostanie dodany do jego wartości. Jest to błąd w tym dokumencie:

{ "q": { "bar": 2 } }

ponieważ "a" nie istnieje.

public:
 virtual void Add(Microsoft::AspNetCore::JsonPatch::Operations::Operation ^ operation, System::Object ^ objectToApplyTo);

public void Add (Microsoft.AspNetCore.JsonPatch.Operations.Operation operation, object objectToApplyTo);

abstract member Add : Microsoft.AspNetCore.JsonPatch.Operations.Operation * obj -> unit
override this.Add : Microsoft.AspNetCore.JsonPatch.Operations.Operation * obj -> unit

Public Sub Add (operation As Operation, objectToApplyTo As Object)

Parametry

operation

Operation

Operacja dodawania.

objectToApplyTo

Object

Obiekt, do których ma być zastosowana operacja.

Implementuje

Add(Operation, Object)