本文由机器翻译。若要查看英语原文,请勾选“英语”复选框。 也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语

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 命名空间。

System_CAPS_pubpropertyEntities

获取当前由 DataServiceContext 跟踪的所有资源的列表。

System_CAPS_pubpropertyIgnoreMissingProperties

获取从类型读取的属性或将其设置为是否必须映射到客户端类型的属性。

System_CAPS_pubpropertyIgnoreResourceNotFoundException

获取或设置当数据服务返回 404 错误(找不到资源)时是否引发异常。

System_CAPS_pubpropertyLinks

获取当前正由 DataServiceContext 对象跟踪的所有关联或链接的集合。

System_CAPS_pubpropertyMergeOption

获取或设置用于从数据服务中接收实体的同步选项。

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)

获取作为数据流中,指定 Accept 消息标头与指定实体二进制属性数据。

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 起可用

此类型的所有公共静态(Visual Basic 中的 已共享 在 Visual Basic 中)成员都是线程安全的。不保证所有实例成员都是线程安全的。

返回页首
显示: