IODataPayloadUriConverter Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Unterstützt die benutzerdefinierte Konvertierung von URLs, die in der Nutzlast gefunden werden.
public interface IODataPayloadUriConverter
type IODataPayloadUriConverter = interface
Public Interface IODataPayloadUriConverter
- Abgeleitet
Hinweise
Diese Schnittstelle kann für Nachrichten implementiert werden (siehe IODataRequestMessage und IODataResponseMessage). Wenn eine Nachricht, die diese Schnittstelle implementiert, an oder ODataMessageWriterODataMessageReaderübergeben wird, verwendet der Nachrichtenschreiber/Leser diese Schnittstelle für die benutzerdefinierte URL-Konvertierung. Bei Writern bedeutet dies, dass immer, wenn ein URI in die Nutzlast geschrieben wird, die Konvertierungsmethode auf dieser Schnittstelle aufgerufen wird, um einen Basis-URI und einen Nutzlast-URI in den tatsächlichen URI zu konvertieren, der in die Nutzlast geschrieben werden soll. Wenn die Methode null aus einem Konvertierungsaufruf zurückgibt, wird die Standardkonvertierung verwendet. Bei Readern bedeutet dies, dass ein Basis-URI (entweder aus der Nutzlast oder den Readereinstellungen) und der URI, der aus der Nutzlast gelesen wird, an die Methode übergeben werden. Das Ergebnis entspricht den über die OData-OM-Instanzen gemeldeten Informationen. Wenn die Konvertierungsmethode NULL zurückgibt, wird die Standardkonvertierung aktiviert.
Methoden
ConvertPayloadUri(Uri, Uri) |
Implementiert ein benutzerdefiniertes URL-Konvertierungsschema. Diese Methode gibt NULL zurück, wenn keine benutzerdefinierte Konvertierung gewünscht wird. Wenn die Methode eine von NULL abweichende URL zurückgibt, wird der Wert ohne weitere Überprüfung verwendet. |