ODataService — Typ dostawcy (F#)

Zawiera typy dostęp do usługi protokołu Open danych (OData).OData jest protokół przesyłania danych przez Internet.Wielu dostawców danych narazić dostęp do swoich danych, przez publikowanie usługi sieci web OData.Dostawca typu OData generuje typów na podstawie struktury źródła OData i tym samym pozwala na używanie danych z dowolnego źródła danych OData bezpośrednio w kodzie bez zwykłe obciążenie tworzenia typów danych.

Ścieżka obszaru nazw/modułu: Microsoft.FSharp.Data.TypeProviders

Zestaw: FSharp.Data.TypeProviders (w FSharp.Data.TypeProviders.dll)

type ODataService<ServiceUri : string,
                  ?LocalSchemaFile : string,
                  ?ForceUpdate : bool,
                  ?ResolutionFolder : string,
                  ?DataServiceCollection : bool>

Parametrów typu statycznego

Parametr typu

Opis

ServiceUri: string

Ciąg identyfikatora URI dla usługi OData.

?LocalSchemaFile: string

Ścieżka do pliku, który zawiera schemat.Ten plik jest zapisywany przez dostawcę typu.

?Wymuszanie aktualizacji: bool

Wymaga bezpośredniego połączenia do usługi jest dostępny w czasie projektowania/kompilacji i pliku Usługa lokalna jest odświeżany.Wartością domyślną jest true.Gdy ForceUpdate ma wartość false, dostawca reaguje na zmiany w LocalSchemaFile.

?ResolutionFolder: string

Folder do rozwiązania ścieżki względne plików w czasie kompilacji.Wartością domyślną jest folder, który zawiera projekt lub skryptu.

?DataServiceCollection: bool

Generuje zbiory pochodzące z DataServiceCollection.Wartością domyślną jest false.

Uwagi

Instruktaż, która pokazuje, jak użyć dostawcy typu ODataService, zobacz Wskazówki: uzyskiwanie dostępu do usługi OData za pomocą dostawców typów (F#).

O OData (protokół Open danych)

Protokół OData zapewnia dostęp tylko do odczytu lub odczytu zapisu do źródła danych za pośrednictwem Internetu.Podstawowe dane mogą być w jednym z dwóch formatów jest XML i znane jako Atom i który używa notacji obiektu JavaScript (JSON) format serializacji.Protokół OData został zdefiniowany przez firmę Microsoft i wydany jako otwarty standard pod Microsoft Otwórz specyfikacji Promise (PBO).

Nie trzeba wiedzieć, jak zdefiniowane i wdrożone dostępu do danych, chociaż usługi sieci web OData protokołu OData.Jednakże następujące krótki opis może pomóc koncepcyjnie zrozumieć, co się dzieje.Protokół OData następujące zasady z reprezentacyjne Państwo Transfer (RESZTA), co oznacza, że żądania klientów są niezależne od siebie; nie stanu sesji lub danych jest przechowywana na serwerze żądań klienta.Zamiast tego Państwa niezbędne jest przenoszona z klienta do serwera z każdego żądania klienta.W przypadku OData, żądania klientów obejmują tworzyć, odczytywać, aktualizowania i usuwania operacji (CRUD).Indywidualne żądania klientów są HTTP metody, które obejmują GET, PUT, POST, scalanie i usuwanie, zawartość określić jakie żądane szczegóły.Serwer odpowiada na te żądania przez HTTP.

OData danych składa się z źródła danych, które są kolekcjami wpisów.Dla bazy danych pasza może reprezentować tabeli i wpisy byłoby indywidualnych rekordów w tabeli.Usługi sieci web OData może również zawierać dokumentu usługi, który wyświetla listę dostępnych źródeł, operacje usługi, które są funkcje dostępne na tej usługi i dokument metadanych, opisujący wszystkie istotne informacje dotyczące usługi.Wszystkie zasoby udostępnione przez służbę OData są opisane w dokumencie metadanych.

Dostawca typu OData

Dostawca OData typu sprawia, że opublikowane do usługi OData do autora F# jako zestaw typów struktury danych na podstawie dostępnych danych.Oznacza to, że użycie dostawcy typu OData, typu jest udostępnione dla każdego źródła danych dostarczonych przez tę usługę.Na przykład jeśli kanały OData zestawu tabel z relacyjnej bazy danych, typ Dostawca udostępnia typu dla każdej tabeli.Kolumny tabeli są właściwości typu.Wpisy dla każdej paszy, są dostępne jako wystąpienia typu.

Konstruowanie kwerendy

Za pomocą wyrażenia kwerendy można utworzyć kwerendy do usługi OData.Wyrażenia kwerendy umożliwiają skonstruować wyników kwerend przy użyciu kodu F#, znacznie wyrażeń sekwencji sposób umożliwiają określenie sekwencji.Wybierz słowo kluczowe odtwarza tę samą rolę jako kluczowe plon.Ponadto operatory kwerendy można dostosować kwerendę w taki sam sposób jak LINQ, innego języka .net lub ciąg kwerendy SQL.

Można tylko podzbiór operatory kwerendy OData kwerend.Wynika to z ograniczenia typów kwerend, które obsługuje protokół OData.Obsługiwane kwerendy operatorów obejmują rzut (select), zamawiania (orderBy, thenBy), filtrowania (where, filtrowanie przez ciąg i Data) i stronicowania (skip, take).Aby uzyskać więcej informacji o tych operatorów kwerendy i inne, zobacz Wyrażenia kwerend (F#).Ponadto można używać określonych operacji OData AddQueryOption i Rozwiń.

Typy generowanych

W poniższej tabeli przedstawiono typy generowanych przez wystąpienia formularza:

type MyService = ODataService<parameters>

W poniższej tabeli ServiceTypeName reprezentuje nazwę typu usługi i * reprezentuje członków obszaru nazw.

Typ

Opis

Moja_usługa

Ogólny typ kontenera.

Zawiera metodę GetDataContext, która zwraca uproszczony widok kontekst danych.Metoda zwraca nowej instancji MyService.ServiceTypes.SimpleDataContextTypes. ServiceTypeName, która jest inicjowana z wartością ServiceUri statyczne parametr lub argument, jeśli został dostarczony.

MyService.ServiceTypes

Zawiera osadzony typów pełne i uproszczone typów dla bazy danych.

MyService.ServiceTypes.*

Osadzone typy generowanych przez DataSvcUtil.exe.

MyService.ServiceTypes. ServiceTypeName

Typ kontekstowego usługi dziedziczone z DataContext.

MyService.ServiceTypes.SimpleDataContextTypes. ServiceTypeName

Zawiera jedną właściwość dla każdej właściwości typu pełny kontekst, który zwraca DataServiceQuery.

Właściwość Credentials pobiera lub ustawia poświadczenia używane do kwerendy usługi OData w czasie wykonywania.

Właściwość DataContext pobiera kontekście pełnych danych typu DataContext.Jest to typ bazowy ServiceTypeName typu generowane przez dostawcę typu.

Platformy

Windows 8Windows 8, Windows 7, Windows Server 2012, Windows Server 2008 R2

Informacje o wersji

F# Core wersji biblioteki

Obsługiwane: 2.0, 4.0, przenośne

Zobacz też

Zadania

Wskazówki: uzyskiwanie dostępu do usługi OData za pomocą dostawców typów (F#)

Informacje

Microsoft.FSharp.Collections — Przestrzeń nazw (F#)

Microsoft.FSharp.Data.TypeProviders — Przestrzeń nazw (F#)