通过

使用二进制数据（WCF 数据服务）

利用 WCF 数据服务 客户端库，您可以通过以下方式之一从 开放式数据协议 (OData) 源中检索二进制数据并进行更新。

  • 作为实体的基元类型属性。当使用可轻松加载到内存中的小型二进制数据对象时，建议使用此方法。在这种情况下，二进制属性是数据模型公开的实体属性，而数据服务会在响应消息中将二进制数据序列化为 base-64 二进制编码的 XML。

  • 作为单独的二进制资源流。当访问和更改可能表示照片、视频或其他任何类型的二进制编码数据的二进制大型对象 (BLOB) 数据时，建议使用此方法。

WCF 数据服务 通过使用 HTTP 实现二进制数据流，如 OData 中定义。在此机制中，二进制数据被视为独立于实体但又与实体相关的媒体资源，这称为媒体链接入口。有关更多信息，请参见流提供程序（WCF 数据服务）。

Ee473426.Tip(zh-cn,VS.100).gif提示：
有关如何创建一个 Windows Presentation Foundation (WPF) 客户端应用程序（它从存储照片的 OData 服务下载二进制图像文件）的逐步示例，请参见数据服务流提供程序系列文章 - 第 2 部分：从客户端访问媒体资源流一文。要下载博客文章中的流照片数据服务的示例代码，请参见 MSDN 代码库中的流照片数据服务示例。

实体元数据

具有相关媒体资源流的实体由应用于实体类型（媒体链接入口）的 HasStream 属性在数据服务元数据中表示。在下面的示例中，PhotoInfo 实体是媒体链接入口，它具有一个由 HasStream 属性表示的相关媒体资源。

<EntityType xmlns:m="https://schemas.microsoft.com/ado/2007/08/dataservices/metadata"
            Name="PhotoInfo" m:HasStream="true">
  <Key>
    <PropertyRef Name="PhotoId" />
  </Key>
  <Property Name="PhotoId" Type="Int32" Nullable="false" 
            annotation:StoreGeneratedPattern="Identity" />
  <Property Name="FileName" Type="String" Nullable="false" />
  <Property Name="FileSize" Type="Int32" Nullable="true" />
  <Property Name="DateTaken" Type="DateTime" Nullable="true" />
  <Property Name="TakenBy" Type="String" Nullable="true" />
  <Property Name="DateAdded" Type="DateTime" Nullable="false" />
  <Property Name="Exposure" Type="PhotoData.Exposure" Nullable="false" />
  <Property Name="Dimensions" Type="PhotoData.Dimensions" Nullable="false" />
  <Property Name="DateModified" Type="DateTime" Nullable="false" />
  <Property Name="Comments" Type="String" MaxLength="Max" 
            FixedLength="false" Unicode="true" />
  <Property Name="ContentType" Type="String" MaxLength="50" FixedLength="false" Unicode="true" />
</EntityType>

本主题中的其余示例揭示了如何访问和更改媒体资源流。有关如何通过使用 WCF 数据服务 客户端库在 .NET Framework 客户端应用程序中使用媒体资源的完整示例，请参见从客户端访问媒体资源流一文。

访问二进制资源流

WCF 数据服务 客户端库提供了从基于 OData 的数据服务访问二进制资源流的方法。下载媒体资源时，可以使用媒体资源的 URI，也可以获取一个包含媒体资源数据本身的二进制流。还可以上载媒体资源数据作为一个二进制流。

Ee473426.Tip(zh-cn,VS.100).gif提示：
有关如何创建一个 Windows Presentation Foundation (WPF) 客户端应用程序（它从存储照片的 OData 服务下载二进制图像文件）的逐步示例，请参见数据服务流提供程序系列文章 - 第 2 部分：从客户端访问媒体资源流一文。要下载博客文章中的流照片数据服务的示例代码，请参见 MSDN 代码库中的流照片数据服务示例。

获取二进制流的 URI

检索某些类型的媒体资源（如图像和其他媒体文件）时，在应用程序中使用媒体资源的 URI 通常比处理二进制数据流本身更容易。要获取与给定媒体链接入口相关联的资源流的 URI，必须对跟踪实体的 DataServiceContext 实例调用 GetReadStreamUri 方法。下面的示例揭示了如何调用 GetReadStreamUri 方法以获取用于在客户端上创建新图像的媒体资源流的 URI：

' Use the ReadStreamUri of the Media Resource for selected PhotoInfo object
' as the URI source of a new bitmap image.
photoImage.Source = New BitmapImage(context.GetReadStreamUri(currentPhoto))

// Use the ReadStreamUri of the Media Resource for selected PhotoInfo object
// as the URI source of a new bitmap image.
photoImage.Source = new BitmapImage(context.GetReadStreamUri(currentPhoto));

下载二进制资源流

检索二进制资源流时，必须对跟踪媒体链接入口的 DataServiceContext 实例调用 GetReadStream 方法。该方法向数据服务发送一个返回 DataServiceStreamResponse 对象的请求，该对象具有对包含资源的流的引用。当应用程序要求将二进制资源作为 Stream 时可使用该方法。下面的示例揭示了如何调用 GetReadStream 方法以检索用于在客户端上创建新图像的流：

Ee473426.note(zh-cn,VS.100).gif注意：
数据服务不会设置包含二进制数据流的响应消息中的 Content-Length 标头。此值可能不反映二进制数据流的实际长度。

将媒体资源作为流上载

若要插入或更新媒体资源，请对正在跟踪实体的 DataServiceContext 实例调用 SetSaveStream 方法。此方法向包含从所提供的流中读取的媒体资源的数据服务发送请求。下面的示例揭示了如何调用 SetSaveStream 方法以向数据服务发送图像：

' Set the file stream as the source of binary stream 
' to send to the data service. The Slug header is the file name and
' the content type is determined from the file extension. 
' A value of 'true' means that the stream is closed by the client when 
' the upload is complete.
context.SetSaveStream(photoEntity, imageStream, True, _
    photoEntity.ContentType, photoEntity.FileName)

// Set the file stream as the source of binary stream 
// to send to the data service. The Slug header is the file name and
// the content type is determined from the file extension. 
// A value of 'true' means that the stream is closed by the client when 
// the upload is complete.
context.SetSaveStream(photoEntity, imageStream, true,
    photoEntity.ContentType, photoEntity.FileName);

在此示例中，通过为 closeStream 参数提供 true 值，调用 SetSaveStream 方法。这样可保证在将二进制数据上载到数据服务之后，DataServiceContext 将会关闭流。

Ee473426.note(zh-cn,VS.100).gif注意：
调用 SetSaveStream 时，只有在调用 SaveChanges 之后，才会将流发送到数据服务。

另请参见

概念

将数据绑定到控件（WCF 数据服务）

其他资源

WCF 数据服务客户端库