本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

DataServiceContext 類別

 

DataServiceContext 代表資料服務的執行階段內容。

命名空間:   System.Data.Services.Client
組件:  System.Data.Services.Client (於 System.Data.Services.Client.dll)

System.Object
  System.Data.Services.Client.DataServiceContext

public class DataServiceContext

名稱描述
System_CAPS_pubmethodDataServiceContext(Uri)

使用指定的 DataServiceContext 初始化 serviceRoot 類別的新執行個體。

名稱描述
System_CAPS_pubpropertyApplyingChanges

取得值,該值指出 DataServiceContext 目前是否正在套用追蹤之物件的變更。

System_CAPS_pubpropertyBaseUri

取得識別目標資料服務根目錄的絕對 URI。

System_CAPS_pubpropertyCredentials

取得或設定驗證資訊,此資訊為透過 DataServiceContext 物件所建立之每個查詢所使用。

System_CAPS_pubpropertyDataNamespace

取得或設定 Atom 承載之資料項目 (而非中繼資料項目) 的 XML 命名空間 (Namespace)。

System_CAPS_pubpropertyEntities

取得 DataServiceContext 目前正在追蹤的所有資源之清單。

System_CAPS_pubpropertyIgnoreMissingProperties

取得或設定從型別讀取的屬性是否必須對應至用戶端型別上的屬性。

System_CAPS_pubpropertyIgnoreResourceNotFoundException

取得或設定是否在資料服務傳回 404 錯誤 (找不到資源) 時引發例外狀況。

System_CAPS_pubpropertyLinks

取得 DataServiceContext 物件目前正在追蹤的所有關聯或連結之集合。

System_CAPS_pubpropertyMergeOption

取得或設定從資料服務接收實體 (Entity) 的同步處理選項。

System_CAPS_pubpropertyResolveName

取得或設定函式,當您傳送實體到資料服務時,此函式會覆寫用戶端程式庫所用的預設型別解析策略。

System_CAPS_pubpropertyResolveType

取得或設定函式,從資料服務接收實體時,此函式用來覆寫用戶端程式庫所用的預設型別解析選項。

System_CAPS_pubpropertySaveChangesDefaultOptions

取得或設定 SaveChangesOptions 方法所使用的 SaveChanges 值。

System_CAPS_pubpropertyTimeout

取得或設定用於資料服務的基礎 HTTP 要求的逾時選項。

System_CAPS_pubpropertyTypeScheme

取得或設定用來表示服務使用哪種型別配置的 URI。

System_CAPS_pubpropertyUsePostTunneling

取得或設定布林值,這個值表示否要使用 Post 通道。

名稱描述
System_CAPS_pubmethodAddLink(Object, String, Object)

將指定的連結加入 DataServiceContext 正在追蹤的物件集。

System_CAPS_pubmethodAddObject(String, Object)

將指定的物件加入 DataServiceContext 正在追蹤的物件集。

System_CAPS_pubmethodAddRelatedObject(Object, String, Object)

將相關物件加入至內容中,並建立連結以定義單一要求中兩個物件之間的關聯性。

System_CAPS_pubmethodAttachLink(Object, String, Object)

通知 DataServiceContext 開始追蹤指定的連結,此連結定義實體物件之間的關聯性。

System_CAPS_pubmethodAttachTo(String, Object)

通知 DataServiceContext,開始追蹤指定的資源,並提供指定的資源集內資源的位置。

System_CAPS_pubmethodAttachTo(String, Object, String)

通知 DataServiceContext 開始追蹤指定的資源並提供資源在指定之資源集內的位置。

System_CAPS_pubmethodBeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)

非同步傳送要求給資料服務,在分頁式查詢結果中擷取下一頁資料。

System_CAPS_pubmethodBeginExecute<TElement>(Uri, AsyncCallback, Object)

以非同步方式傳送要求,讓這個呼叫不會在等候來自服務的結果時封鎖處理。

System_CAPS_pubmethodBeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])

以非同步方式和批次方式將一組查詢送出至資料服務。

System_CAPS_pubmethodBeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)

以非同步方式取得指定之實體二進位屬性資料做為資料流,以及指定的訊息標頭。

System_CAPS_pubmethodBeginLoadProperty(Object, String, AsyncCallback, Object)

從資料服務非同步載入指定之屬性的值。

System_CAPS_pubmethodBeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)

透過使用提供的查詢接續物件,以非同步方式從資料服務載入下一頁相關實體。

System_CAPS_pubmethodBeginLoadProperty(Object, String, Uri, AsyncCallback, Object)

透過使用提供的下一個連結 URI,以非同步方式從資料服務載入一頁相關實體。

System_CAPS_pubmethodBeginSaveChanges(AsyncCallback, Object)

以非同步方式將自從上一次儲存變更後 DataServiceContext 所收集之暫止的變更送出至資料服務。

System_CAPS_pubmethodBeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)

以非同步方式將自從上一次儲存變更後 DataServiceContext 所收集之暫止的變更送出至資料服務。

System_CAPS_pubmethodCancelRequest(IAsyncResult)

嘗試取消與所提供之 IAsyncResult 物件相關聯的作業。

System_CAPS_pubmethodCreateQuery<T>(String)

為指定之泛型型別的資料建立資料服務查詢。

System_CAPS_pubmethodDeleteLink(Object, String, Object)

DataServiceContext 正在追蹤的連結清單中的連結狀態變更成已刪除。

System_CAPS_pubmethodDeleteObject(Object)

DataServiceContext 中指定之物件的狀態變更成已刪除。

System_CAPS_pubmethodDetach(Object)

DataServiceContext 正在追蹤的實體清單中移除實體。

System_CAPS_pubmethodDetachLink(Object, String, Object)

DataServiceContext 正在追蹤的連結清單中移除指定的連結。

System_CAPS_pubmethodEndExecute<TElement>(IAsyncResult)

呼叫以完成 BeginExecute<TElement>

System_CAPS_pubmethodEndExecuteBatch(IAsyncResult)

呼叫以完成 BeginExecuteBatch

System_CAPS_pubmethodEndGetReadStream(IAsyncResult)

呼叫以完成擷取二進位屬性做為資料流的非同步作業。

System_CAPS_pubmethodEndLoadProperty(IAsyncResult)

呼叫以完成 BeginLoadProperty 作業。

System_CAPS_pubmethodEndSaveChanges(IAsyncResult)

呼叫以完成 BeginSaveChanges 作業。

System_CAPS_pubmethodEquals(Object)

判斷指定的物件是否等於目前的物件。(繼承自 Object。)

System_CAPS_pubmethodExecute<T>(DataServiceQueryContinuation<T>)

傳送要求給資料服務,在分頁式查詢結果中擷取下一頁資料。

System_CAPS_pubmethodExecute<TElement>(Uri)

將要求傳送到資料服務來執行特定的 URI。

System_CAPS_pubmethodExecuteBatch(DataServiceRequest[])

以批次方式將一組查詢送出至資料服務。

System_CAPS_protmethodFinalize()

允許物件在記憶體回收進行回收之前,嘗試釋放資源並執行其他清除作業。 (繼承自 Object。)

System_CAPS_pubmethodGetEntityDescriptor(Object)

取得所提供之實體物件的 EntityDescriptor

System_CAPS_pubmethodGetHashCode()

做為預設雜湊函式。(繼承自 Object。)

System_CAPS_pubmethodGetLinkDescriptor(Object, String, Object)

針對定義兩個實體之間關聯性的特定連結取得 LinkDescriptor

System_CAPS_pubmethodGetMetadataUri()

取得 .edmx 中繼資料位置的統一資源識別元 (URI)。

System_CAPS_pubmethodGetReadStream(Object)

取得指定之實體的二進位屬性資料做為資料流。

System_CAPS_pubmethodGetReadStream(Object, DataServiceRequestArgs)

取得指定之實體的二進位屬性資料做為資料流,以及指定的訊息標頭。

System_CAPS_pubmethodGetReadStream(Object, String)

取得指定之實體的二進位屬性資料做為資料流,具有指定接受訊息標頭。

System_CAPS_pubmethodGetReadStreamUri(Object)

取得用來傳回二進位屬性資料做為資料流的 URI。

System_CAPS_pubmethodGetType()

取得目前執行個體的 Type(繼承自 Object。)

System_CAPS_pubmethodLoadProperty(Object, String)

從資料服務載入指定之屬性的延遲內容。

System_CAPS_pubmethodLoadProperty(Object, String, DataServiceQueryContinuation)

透過使用提供的查詢接續物件,從資料服務載入下一頁相關實體。

System_CAPS_pubmethodLoadProperty(Object, String, Uri)

透過使用提供的下一個連結 URI,載入一頁相關實體。

System_CAPS_pubmethodLoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)

透過使用提供的泛型查詢接續物件,從資料服務載入下一頁相關實體。

System_CAPS_protmethodMemberwiseClone()

建立目前 Object 的淺層複製。(繼承自 Object。)

System_CAPS_pubmethodSaveChanges()

DataServiceContext 正在追蹤的變更儲存至儲存區。

System_CAPS_pubmethodSaveChanges(SaveChangesOptions)

DataServiceContext 正在追蹤的變更儲存至儲存區。

System_CAPS_pubmethodSetLink(Object, String, Object)

通知 DataServiceContext,來源和指定的目標物件之間存在新連結,以及由 sourceProperty 參數所指定的屬性表示該連結。

System_CAPS_pubmethodSetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

設定新的資料流做為要求訊息中指定的設定實體的二進位屬性。

System_CAPS_pubmethodSetSaveStream(Object, Stream, Boolean, String, String)

設定新的資料流做為實體的二進位屬性。 要求訊息中包含指定的 Content-type 和 Slug 標頭。

System_CAPS_pubmethodToString()

傳回代表目前物件的字串。(繼承自 Object。)

System_CAPS_pubmethodTryGetEntity<TEntity>(Uri, TEntity)

透過實體 URI 的參考進行測試擷取 DataServiceContext 正在追蹤的實體。

System_CAPS_pubmethodTryGetUri(Object, Uri)

擷取與指定之實體相關聯的標準 URI (若有的話)。

System_CAPS_pubmethodUpdateObject(Object)

DataServiceContext 中指定之物件的狀態變更成 Modified

名稱描述
System_CAPS_pubeventReadingEntity

當實體資料已完全讀入實體物件之後發生。

System_CAPS_pubeventSendingRequest

已建立新的 HttpWebRequest 時發生。

System_CAPS_pubeventWritingEntity

實體已完全序列化為要求訊息中的 XML 之後發生。

WCF 資料服務 are stateless, but the DataServiceContext is not. State on the client is maintained between interactions in order to support features such as update management. This class, and the DataServiceQuery class that represents a particular HTTP request to a data service, are the two main classes in the client library.

The following example shows how to use the T:System.Data.Services.Client.DataServiceContext generated by the Add Service Reference tool to implicitly execute a query against the Northwind data service that returns all customers. The URI of the requested Customers entity set is determined automatically by the context. The query is executed implicitly when the enumeration occurs. The Northwind data service is created when you complete the ssAstoria .

// 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);
}

.NET Framework
自 3.5 起供應
Silverlight
自 2.0 起供應

此類型的任何 public static (在 Visual Basic 中 共用 在 Visual Basic 中) 成員皆為安全執行緒。不保證任何執行個體成員為安全執行緒。

回到頁首
顯示: