DataServiceRequest<TElement> 類別

定義

命名空間:

System.Data.Services.Client

組件:

System.Data.Services.Client.dll

表示以批次送出至資料服務的要求物件。

generic <typename TElement>
public ref class DataServiceRequest sealed : System::Data::Services::Client::DataServiceRequest

public sealed class DataServiceRequest<TElement> : System.Data.Services.Client.DataServiceRequest

type DataServiceRequest<'Element> = class
    inherit DataServiceRequest

Public NotInheritable Class DataServiceRequest(Of TElement)
Inherits DataServiceRequest

類型參數

TElement

繼承

Object

DataServiceRequest

DataServiceRequest<TElement>

範例

傳回時 ExecuteBatch ，批次要求的整個 HTTP 回應已從網路數據流讀取，但尚未處理回應。 身分識別解析和對象具體化不會在響應中針對指定的實體發生，直到它逐一查看，如下列範例所示。

DataServiceContext service = new DataServiceContext(new   
                                                    Uri("http://myserviceroot"));  

// Create query batches.  
DataServiceRequest[] reqs = new DataServiceRequest[] {   
    new DataServiceRequest<Category>(  
            new Uri("http://myserviceroot/Categories")),  
            new DataServiceRequest<Customer>(  
            new Uri("http://myserviceroot/Customers"))  
};  

DataServiceResponse dsr;  
try  
{  
    // Client will not throw an exception on ExecuteBatch because the   
    // entire response has not been processed yet to know  
    // whether an exception should be thrown.  

    dsr = service.ExecuteBatch(reqs);     

    if (dsr.IsBatchResponse)   
    {  
        /*inspect HTTP artifacts associated with the entire batch:  
                      dsr.BatchHeaders, dsr.BatchStatusCode*/ }  

    foreach (QueryOperationResponse qr in dsr)  
    {  
        if (IsErrorStatusCode(qr.StatusCode))     
        {  
            //q.Error.Message contains the full contents of the error.  
            /* process any part of the Error Contract (<error> element)  
                      sent from the service.  */  
            }  
        }  
        else  
        {  
            if (qr.Query.ElementType == typeof(Customer))  
            {  
                //process customers  
                foreach (Customer c in qr){ /*process the customer*/ }  

                // the DataServiceContext does not materialize, resolve  
                // identity on Customer until it is enumerated.  
            }  
            else if (qr.Query.ElementType == typeof(Category))  
            {  
                // Process categories.  
                foreach (Category cat in qr)  
                {   
                    /*process the category*/   
                 }  
                // the DataServiceContext does not materialize or  
                // resolve identity on the Category until  
                // it is enumerated.  
                // This means that instream errors will be thrown  
                // during iteration.  
            }  
        }  
    }  
}  
catch (DataServiceRequestException e)  
{  
    // This error is thrown if the data service returns with  
    // a response code < 200 or >299 or the top level element.  
    // If neither of the above or true, this exception is not   
    // thrown.  

    dsr = e.Response;  

    if (dsr.IsBatchResponse)   
    {   
        /*inspect HTTP artifacts associated with the entire batch:  
                        dsr.BatchHeaders, dsr.BatchStatusCode*/   
    }  

    /* There will always only be one of these because if the top level  
     status code was >=200 and =<299 and the first element was not an  
     error, the call to start the query will not throw. */  

    foreach (QueryOperationResponse qr in dsr)  
    {  
        if (qr.Error != null)  
        {  
            // Process error.  
        }  
    }     
}  

備註

在提交為批次至數據服務的查詢群組中，查詢會指定為 DataServiceRequest<TElement> 實例。 DataServiceResponse傳回 ，表示整個批次要求的回應。 個別查詢回應會以 QueryOperationResponse 衍生自 OperationResponse的物件表示，可列舉 DataServiceResponse 實例來存取。

建構函式

DataServiceRequest<TElement>(Uri)

初始化 DataServiceRequest<TElement> 類別的新執行個體。

屬性

ElementType	取得用於建立 DataServiceRequest<TElement> 執行個體的物件型別。
RequestUri	取得包含要求字串的 URI 物件。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	表示資料服務查詢的 URI。 (繼承來源 DataServiceRequest)