DataServiceContext Sınıf

Tanım

Ad Alanı:

System.Data.Services.Client

Bütünleştirilmiş Kod:

System.Data.Services.Client.dll

, DataServiceContext veri hizmetinin çalışma zamanı bağlamını temsil eder.

public ref class DataServiceContext

public class DataServiceContext

type DataServiceContext = class

Public Class DataServiceContext

Devralma

Object

DataServiceContext

Örnekler

Aşağıdaki örnekte, tüm müşterileri döndüren Northwind veri hizmetinde örtük olarak bir sorgu yürütmek için Hizmet Başvurusu Ekle aracı tarafından oluşturulan öğesinin nasıl kullanılacağı DataServiceContext gösterilmektedir. İstenen Customers varlık kümesinin URI'si bağlam tarafından otomatik olarak belirlenir. Numaralandırma gerçekleştiğinde sorgu örtük olarak yürütülür. WCF Veri Hizmetleri tamamladığınızda Northwind veri hizmeti oluşturulur.

// Create the DataServiceContext using the service URI.
NorthwindEntities context = new NorthwindEntities(svcUri);

// Define a new query for Customers.
DataServiceQuery<Customer> query = context.Customers;

try
{
    // Enumerate over the query result, which is executed implicitly.
    foreach (Customer customer in query)
    {
        Console.WriteLine("Customer Name: {0}", customer.CompanyName);
    }
}
catch (DataServiceQueryException ex)
{
    throw new ApplicationException(
        "An error occurred during query execution.", ex);
}

' Create the DataServiceContext using the service URI.
Dim context = New NorthwindEntities(svcUri)

' Define a new query for Customers.
Dim query As DataServiceQuery(Of Customer) = context.Customers

Try
    ' Enumerate over the query result, which is executed implicitly.
    For Each customer As Customer In query
        Console.WriteLine("Customer Name: {0}", customer.CompanyName)
    Next
Catch ex As DataServiceQueryException
    Throw New ApplicationException( _
            "An error occurred during query execution.", ex)
End Try

Açıklamalar

WCF Veri Hizmetleri durum bilgisi yok ama DataServiceContext değil. İstemcideki durum, güncelleştirme yönetimi gibi özellikleri desteklemek için etkileşimler arasında korunur. Bu sınıf ve DataServiceQuery bir veri hizmetine yapılan belirli bir HTTP isteğini temsil eden sınıf, istemci kitaplığındaki iki ana sınıftır.

Oluşturucular

DataServiceContext(Uri)

belirtilen serviceRootile sınıfının yeni bir örneğini DataServiceContext başlatır.

Özellikler

ApplyingChanges	şu anda izlenen nesnelere DataServiceContext değişiklik uygulayıp uygulamadığını belirten bir değer alır.
BaseUri	Hedef veri hizmetinin kökünü tanımlayan mutlak URI'yi alır.
Credentials	nesnesi kullanılarak DataServiceContext oluşturulan her sorgu tarafından kullanılan kimlik doğrulama bilgilerini alır veya ayarlar.
DataNamespace	Atom yükünün meta veri öğelerinin değil veri öğelerinin XML ad alanını alır veya ayarlar.
Entities	tarafından DataServiceContextizlenmekte olan tüm kaynakların listesini alır.
IgnoreMissingProperties	Türden okunan özelliklerin istemci tarafı türündeki özelliklerle eşlenip eşlenmeyeceğini alır veya ayarlar.
IgnoreResourceNotFoundException	Veri hizmeti tarafından bir 404 hatası (kaynak bulunamadı) döndürülürken bir özel durumun tetiklenip tetiklenmediğini alır veya ayarlar.
Links	Nesne tarafından izlenen tüm ilişkilendirmelerin veya bağlantıların DataServiceContext koleksiyonunu alır.
MergeOption	Bir veri hizmetinden varlık almak için eşitleme seçeneğini alır veya ayarlar.
ResolveName	Bir veri hizmetine varlık gönderdiğinizde istemci kitaplığı tarafından kullanılan varsayılan tür çözümleme stratejisini geçersiz kılmak için bir işlev alır veya ayarlar.
ResolveType	Bir veri hizmetinden varlık alırken istemci kitaplığı tarafından kullanılan varsayılan tür çözümleme seçeneğini geçersiz kılmak için kullanılan bir işlevi alır veya ayarlar.
SaveChangesDefaultOptions	yöntemi tarafından SaveChanges() kullanılan değerleri alır veya ayarlarSaveChangesOptions.
Timeout	Veri hizmetine yönelik temel HTTP isteği için kullanılan zaman aşımı seçeneğini alır veya ayarlar.
TypeScheme	Hizmet tarafından hangi tür düzeninin kullanıldığını belirtmek için kullanılan URI'yi alır veya ayarlar.
UsePostTunneling	Tünel sonrası kullanılıp kullanılmayacağını belirten bir Boole değeri alır veya ayarlar.

Yöntemler

AddLink(Object, String, Object)	Belirtilen bağlantıyı izlediği nesne kümesine DataServiceContext ekler.
AddObject(String, Object)	Belirtilen nesneyi, izlediği nesne kümesine DataServiceContext ekler.
AddRelatedObject(Object, String, Object)	Bağlama ilgili bir nesne ekler ve tek bir istekteki iki nesne arasındaki ilişkiyi tanımlayan bağlantıyı oluşturur.
AttachLink(Object, String, Object)	DataServiceContext varlık nesneleri arasındaki ilişkiyi tanımlayan belirtilen bağlantıyı izlemeye başlamasını bildirir.
AttachTo(String, Object)	DataServiceContext Belirtilen kaynağı izlemeye başlamasını bildirir ve belirtilen kaynak kümesi içindeki kaynağın konumunu sağlar.
AttachTo(String, Object, String)	DataServiceContext Belirtilen kaynağı izlemeye başlamasını bildirir ve belirtilen kaynak kümesindeki kaynağın konumunu sağlar.
BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Zaman uyumsuz olarak veri hizmetine, sayfalanmış sorgu sonucundaki bir sonraki veri sayfasını alma isteği gönderir.
BeginExecute<TElement>(Uri, AsyncCallback, Object)	Bu çağrının hizmetten sonuçları beklerken işlemeyi engellememesi için isteği zaman uyumsuz olarak gönderir.
BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])	Bir grup sorguyu zaman uyumsuz olarak veri hizmetine toplu iş olarak gönderir.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)	Belirtilen varlık için veri akışı olarak belirtilen ileti üst bilgileriyle birlikte ikili özellik verilerini zaman uyumsuz olarak alır.
BeginLoadProperty(Object, String, AsyncCallback, Object)	Veri hizmetinden belirtilen özelliğin değerini zaman uyumsuz olarak yükler.
BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)	Sağlanan sorgu devamlılık nesnesini kullanarak veri hizmetinden ilgili varlıkların sonraki sayfasını zaman uyumsuz olarak yükler.
BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)	Sağlanan sonraki bağlantı URI'sini kullanarak veri hizmetinden ilgili varlıkların bir sayfasını zaman uyumsuz olarak yükler.
BeginSaveChanges(AsyncCallback, Object)	Bekleyen değişiklikleri, son kaydedilişinden bu yana tarafından DataServiceContext toplanan veri hizmetine zaman uyumsuz olarak gönderir.
BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)	Bekleyen değişiklikleri, son kaydedilişinden bu yana tarafından DataServiceContext toplanan veri hizmetine zaman uyumsuz olarak gönderir.
CancelRequest(IAsyncResult)	Sağlanan IAsyncResult nesneyle ilişkili işlemi iptal etmeye çalışır.
CreateQuery<T>(String)	Belirtilen genel türde veriler için bir veri hizmeti sorgusu oluşturur.
DeleteLink(Object, String, Object)	Bağlantının durumunu, tarafından DataServiceContextizlenen bağlantılar listesinde silinecek şekilde değiştirir.
DeleteObject(Object)	içinde silinecek DataServiceContextbelirtilen nesnenin durumunu değiştirir.
Detach(Object)	Varlığı, izlediği varlıklar listesinden DataServiceContext kaldırır.
DetachLink(Object, String, Object)	Belirtilen bağlantıyı tarafından izlenen bağlantılar listesinden DataServiceContextkaldırır.
EndExecute<TElement>(IAsyncResult)	öğesini tamamlamak BeginExecute<TElement>(Uri, AsyncCallback, Object)için çağrıldı.
EndExecuteBatch(IAsyncResult)	öğesini tamamlamak BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])için çağrıldı.
EndGetReadStream(IAsyncResult)	İkili bir özelliği akış olarak almanın zaman uyumsuz işlemini tamamlamak için çağrılır.
EndLoadProperty(IAsyncResult)	İşlemi tamamlamak BeginLoadProperty(Object, String, AsyncCallback, Object) için çağrıldı.
EndSaveChanges(IAsyncResult)	İşlemi tamamlamak BeginSaveChanges(AsyncCallback, Object) için çağrıldı.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Execute<T>(DataServiceQueryContinuation<T>)	Disk belleğine alınmış sorgu sonucundaki bir sonraki veri sayfasını almak için veri hizmetine bir istek gönderir.
Execute<TElement>(Uri)	Belirli bir URI'yi yürütmek için veri hizmetine bir istek gönderir.
ExecuteBatch(DataServiceRequest[])	Bir grup sorguyu veri hizmetine toplu iş olarak gönderir.
GetEntityDescriptor(Object)	Sağlanan varlık nesnesi için öğesini EntityDescriptor alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLinkDescriptor(Object, String, Object)	LinkDescriptor İki varlık arasındaki ilişkiyi tanımlayan belirli bir bağlantı için öğesini alır.
GetMetadataUri()	.edmx meta verilerinin konumunun URI'sini alır.
GetReadStream(Object)	Veri akışı olarak belirtilen varlık için ikili özellik verilerini alır.
GetReadStream(Object, DataServiceRequestArgs)	Belirtilen varlık için ikili özellik verilerini, belirtilen ileti üst bilgileriyle birlikte bir veri akışı olarak alır.
GetReadStream(Object, String)	Belirtilen varlığın ikili özellik verilerini, belirtilen Accept ileti üst bilgisi ile veri akışı olarak alır.
GetReadStreamUri(Object)	İkili özellik verilerini veri akışı olarak döndürmek için kullanılan URI'yi alır.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
LoadProperty(Object, String)	Veri hizmetinden belirtilen bir özellik için ertelenen içeriği yükler.
LoadProperty(Object, String, DataServiceQueryContinuation)	Sağlanan sorgu devamlılık nesnesini kullanarak veri hizmetinden ilgili varlıkların sonraki sayfasını yükler.
LoadProperty(Object, String, Uri)	Sağlanan sonraki bağlantı URI'sini kullanarak ilgili varlıkların bir sayfasını yükler.
LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)	Sağlanan genel sorgu devamlılık nesnesini kullanarak veri hizmetinden ilgili varlıkların sonraki sayfasını yükler.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
SaveChanges()	depolama alanına izlediği değişiklikleri DataServiceContext kaydeder.
SaveChanges(SaveChangesOptions)	depolama alanına izlediği değişiklikleri DataServiceContext kaydeder.
SetLink(Object, String, Object)	DataServiceContext Belirtilen nesneler arasında yeni bir bağlantı olduğunu ve bağlantının parametresi tarafından belirtilen özellik tarafından sourceProperty temsillandığını bildirir.
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	Yeni bir veri akışını, istek iletisinde belirtilen ayarlarla bir varlığın ikili özelliği olarak ayarlar.
SetSaveStream(Object, Stream, Boolean, String, String)	Yeni bir veri akışını varlığın ikili özelliği olarak ayarlar. Belirtilen Content-Type ve Slug üst bilgileri istek iletisine eklenir.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TryGetEntity<TEntity>(Uri, TEntity)	Varlığın URI'sine başvurarak DataServiceContext tarafından izlenen bir varlığın alındığını test edin.
TryGetUri(Object, Uri)	Varsa, belirtilen varlıkla ilişkili kurallı URI'yi alır.
UpdateObject(Object)	içinde DataServiceContext belirtilen nesnenin durumunu olarak Modifieddeğiştirir.

Ekinlikler

ReadingEntity	Varlık verileri varlık nesnesine tamamen okunduktan sonra gerçekleşir.
SendingRequest	Yeni HttpWebRequest bir oluşturulduğunda gerçekleşir.
WritingEntity	Bir varlık bir istek iletisinde XML olarak tamamen seri hale getirildikten sonra gerçekleşir.

Ayrıca bkz.

• .NET Framework İstemci Kitaplıklarıyla Çalışma (WCF Veri Hizmetleri)