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. Northwind veri hizmeti, WCF Veri Hizmetleri'ni tamamladığınızda 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 yoktur, ancak DataServiceContext durum bilgisi yoktur. İstemcideki durum, güncelleştirme yönetimi gibi özellikleri desteklemek için etkileşimler arasında korunur. Bu sınıf ve DataServiceQuery veri hizmetine belirli bir HTTP isteğini temsil eden sınıf, istemci kitaplığındaki iki ana sınıftır.

Oluşturucular

Name	Description
DataServiceContext(Uri)	belirtilen DataServiceContextile sınıfının yeni bir örneğini serviceRoot başlatır.

Özellikler

Name	Description
ApplyingChanges	şu anda izlenen nesnelere DataServiceContext değişiklik uygulayıp uygulamadığını gösteren 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üründen okunan özelliklerin istemci tarafı türündeki özelliklere eşlenmesi gerekip gerekmediğini alır veya ayarlar.
IgnoreResourceNotFoundException	Veri hizmeti tarafından bir 404 hatası (kaynak bulunamadı) döndürülürken özel durumun tetiklenip tetiklenmediğini alır veya ayarlar.
Links	Nesne tarafından izlenmekte olan tüm ilişkilendirmelerin veya bağlantıların DataServiceContext koleksiyonunu alır.
MergeOption	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 SaveChangesOptions kullanılan değerleri alır veya ayarlarSaveChanges().
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

Name	Description
AddLink(Object, String, Object)	Belirtilen bağlantıyı izlemekte olduğu nesne kümesine DataServiceContext ekler.
AddObject(String, Object)	Belirtilen nesneyi, izlemekte olduğu 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)	varlık nesneleri arasındaki ilişkiyi DataServiceContext tanımlayan belirtilen bağlantıyı izlemeye başlamasını bildirir.
AttachTo(String, Object, String)	belirtilen kaynağı izlemeye başlamasını bildirir DataServiceContext ve belirtilen kaynak kümesindeki kaynağın konumunu sağlar.
AttachTo(String, Object)	belirtilen kaynağı izlemeye başlamasını bildirir DataServiceContext ve kaynağın belirtilen kaynak kümesi içindeki konumunu sağlar.
BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Zaman uyumsuz olarak, sayfalanmış sorgu sonucundaki verilerin sonraki sayfasını almak için veri hizmetine bir istek 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[])	Zaman uyumsuz olarak bir grup sorguyu veri hizmetine toplu iş olarak gönderir.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)	Belirtilen varlık için belirtilen ileti üst bilgileriyle birlikte veri akışı olarak 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ığı 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)	tarafından izlenen DataServiceContextbağlantılar listesinde bağlantının durumunu silinecek şekilde değiştirir.
DeleteObject(Object)	içinde silinecek DataServiceContextbelirtilen nesnenin durumunu değiştirir.
Detach(Object)	Varlığı, izlemekte olduğu 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)	bir ikili özelliği akış olarak alma 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>)	Sayfalanmış sorgu sonucundaki verilerin sonraki 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)	EntityDescriptor Sağlanan varlık nesnesinin öğesini 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, DataServiceRequestArgs)	Belirtilen varlık için ikili özellik verilerini, belirtilen ileti üst bilgileriyle birlikte veri akışı olarak alır.
GetReadStream(Object, String)	Belirtilen varlığın ikili özellik verilerini, belirtilen İletiyi kabul et üst bilgisi ile veri akışı olarak alır.
GetReadStream(Object)	Belirtilen varlık için ikili özellik verilerini 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()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
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(Object, String)	Veri hizmetinden belirtilen bir özellik için ertelenen içeriği yükler.
LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)	Sağlanan genel sorgu devamlılığı nesnesini kullanarak veri hizmetinden ilgili varlıkların sonraki sayfasını yükler.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
SaveChanges()	depolamada izlediği değişiklikleri DataServiceContext kaydeder.
SaveChanges(SaveChangesOptions)	depolamada 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)	Varlığın ikili özelliği olarak yeni bir veri akışı ayarlar. Belirtilen Content-Type ve Slug üst bilgileri istek iletisine eklenir.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)
TryGetEntity<TEntity>(Uri, TEntity)	varlığın URI'sine başvuruyla 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

Name	Description
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, istek iletisinde XML olarak tamamen seri hale getirildikten sonra gerçekleşir.

Ayrıca bkz.

• .NET Framework İstemci Kitaplıkları (WCF Veri Hizmetleri)