ODataService türü sağlayıcı (F#)
Açık Veri Protokolü (OData) hizmeti erişim türleri sağlar. OData Internet üzerinden veri aktarımı için bir iletişim kuralı var. Birçok veri sağlayıcı tarafından OData web hizmeti yayımlama verilerine erişimi açarsınız. OData türü sağlayıcı size OData kaynak yapısını temel alan türlerini oluşturur ve böylece hemen kodunuzda yük bindirmeden veri türleri oluşturma her zamanki gibi herhangi bir OData veri kaynağından verileri kullanmanıza olanak sağlar.
Ad alanı/modül yolu: Microsoft.FSharp.Data.TypeProviders
Derleme: FSharp.Data.TypeProviders (FSharp.Data.TypeProviders.dll),
type ODataService<ServiceUri : string,
?LocalSchemaFile : string,
?ForceUpdate : bool,
?ResolutionFolder : string,
?DataServiceCollection : bool>
Statik tür parametreleri
Tür parametresi |
Description |
|---|---|
ServiceUri: dize |
OData hizmet URI dizesi. |
?LocalSchemaFile: dize |
Şema içeren bir dosya yolu. Bu dosya türü sağlayıcı tarafından yazılır. |
?ForceUpdate: bool |
Hizmetine doğrudan bağlantı tasarım/derleme zamanında kullanılabilir ve yerel hizmet dosyasını yenilenmesi gerekir. Varsayılan değer true olur. Zaman ForceUpdate sağlayıcı tepki verir değişikliklere yanlış LocalSchemaFile. |
?ResolutionFolder: dize |
Derleme zamanında göreli dosya yolları çözmek için kullanılacak bir klasör. Proje ya da komut dosyasını içeren klasörün varsayılan değerdir. |
?DataServiceCollection: bool |
Türetilen koleksiyonlar oluşturur DataServiceCollection<T>. Varsayılan değeri false'tur. |
Notlar
İzlenecek ODataService türü sağlayıcısının nasıl kullanılacağını gösteren bir yol için bkz: İzlenecek yol: OData hizmet sağlayıcıları türü (F#) kullanarak erişme.
OData (açık veri iletişim kuralı) hakkında
OData protokol Internet üzerinden bir veri kaynağına salt okunur veya okuma-yazma erişimi sağlar. Temel verileri bir xml tabanlı ve Atom olarak bilinen ve JavaScript Object Notation (json) seri hale getirme biçimi kullanan bir iki biçimden birinde olabilir. OData Protokolü Microsoft tarafından tanımlanan ve açık bir standart Microsoft açık Specification Promise (osp) altında yayımlandı.
Nasıl OData Protokolü tanımlandığı ve verilere erişmek için OData web hizmeti rağmen uygulanan bilmesi gerekmez. Bununla birlikte, aşağıdaki kısa açıklama kavramsal olarak neler olduğunu anlamanıza yardımcı olabilir. OData protokol prensipleri olan bağlardır durumu aktarmak (istemci isteklerini birbirinden bağımsız olduğu anlamına rest), aşağıdaki gibidir; oturum durumu ya da veri istemci istekleri arasındaki sunucuda depolanır. Bunun yerine, tüm gerekli durumu, istemciden sunucuya her istemci isteği ile birlikte aktarılır. OData söz konusu olduğunda, istemci isteklerini dahil oluşturmak, okuma, güncelleştirme ve silme (crud) işlemleri. İstemcilerin tek tek istekleri içeriği ne istenen ayrıntılarını belirtin get, put, post, birleştirme ve silme dahil, http, yöntemlerdir. Sunucu, http üzerinden bu isteklere yanıt verir.
OData veri girişleri koleksiyonlarıdır Özet akışları oluşur. Bir veritabanı için bir Özet Tablo gösterebilir ve bu tablodaki kayıtları tek tek girişler olacaktır. OData web hizmeti, kullanılabilir özet akışlarını listeler bir hizmet belgesinin, söz konusu hizmeti, kullanılabilir işlevler, servis işlemlerin ve hizmet ile ilgili tüm bilgileri açıklayan meta verileri belge de içerebilir. OData hizmeti tarafından kullanılabilir kaynakların tümünü meta verileri belgesinde açıklanmıştır.
OData türü sağlayıcı
OData türü sağlayıcı bir F# Geliştirici olarak belirlenen veri yapısından türleri kümesi için kullanılabilir OData hizmete yayımladığınız verileri sağlar. OData türü sağlayıcı kullanırken, diğer bir deyişle, bir tür her bu hizmet tarafından sağlanan özet akışları için kullanılabilir duruma getirilir. OData özet akışlarını bir ilişkisel veritabanından tablolar kümesi, örneğin, türü sağlayıcı türü her tablo için kullanılabilmesini sağlar. O tablodaki sütun türü özelliklerdir. Her akış için giriş türü örnekleri kullanılabilir.
Sorgu oluşturma
OData hizmet sorgularda, sorgu ifadelerini kullanarak oluşturulabilir. Sorgu ifadelerini F# kodunu kullanarak sorgu sonuçlarını oluşturmasına izin, çok yol sıra ifadeleri sıralarını belirlemenize olanak sağlar. Select anahtar sözcüğünden verim anahtar sözcük olarak aynı rol oynar. Ayrıca, sorgu işleçleri, LINQ, başka bir .net dili veya bir sql sorgu dizesi gibi bir sorgu aynı şekilde özelleştirmek için kullanılabilir.
OData sorgularda, sorgu işleçleri yalnızca bir alt kümesini kullanabilirsiniz. Bu sınırlamalar OData protokolünü destekleyen sorgu türleri de kaynaklanmaktadır. Desteklenen sorgu işleçleri dahil projeksiyon (select), sıralama (orderBy, thenBy), filtreleme (where, filtre dizesi ve tarih) ve disk belleği (skip, take). Bu sorgu işleçler ve diğerleri hakkında daha fazla bilgi için bkz: Sorgu ifadelerini (F#). Buna ek olarak, OData belirli işlemleri kullanabilirsiniz AddQueryOption ve genişletme.
Üretilen türleri
Bir form oluşturmada tarafından üretilen türleri aşağıdaki tabloda gösterilmiştir:
type MyService = ODataService<parameters>
Aşağıdaki tabloda, ServiceTypeName hizmet türünün adını temsil eder ve * ad alanının tüm üyeleri temsil eder.
Tür |
Description |
|---|---|
MyService |
Genel kapsayıcı türü. Veri içeriği Basitleştirilmiş bir görünümünü verir GetDataContext yöntemi içerir. Bu yöntem, MyService.ServiceTypes.SimpleDataContextTypes yeni bir örneğini döndürür. ServiceTypeName, hangi değeri ile başlatılmış ServiceUri static parametresi ya da varsa bağımsız değişkeni. |
MyService.ServiceTypes |
Katıştırılmış tam türleri ve veritabanı için Basitleştirilmiş türleri içerir. |
MyService.ServiceTypes.* |
DataSvcUtil.exe tarafından oluşturulan katıştırılmış türleri. |
MyService.ServiceTypes. ServiceTypeName |
Hizmet içerik türü devralınan DataContext. |
MyService.ServiceTypes.SimpleDataContextTypes. ServiceTypeName |
Fonksiyonu tüm içerik türünün her özellik için bir özellik içeren bir DataServiceQuery<TElement>. Kimlik özelliği alır veya zamanında OData hizmet sorgulamak için kullanılacak kimlik bilgilerini ayarlar. DataContext özellik türü tam veri içeriği alır DataContext. Bu temel türü, ServiceTypeName türü sağlayıcı tarafından oluşturulan türü. |
Platformlar
Windows 8Windows 8, Windows 7 ve Windows Server 2012, Windows Server 2008 R2
Sürüm Bilgisi
F# Çekirdek Kitaplığı sürümleri
Desteklenen: 2.0, 4.0, Portable
Ayrıca bkz.
Görevler
İzlenecek yol: OData hizmet sağlayıcıları türü (F#) kullanarak erişme