DataServiceContext.GetReadStream Método (Object, String)
Obtiene el flujo de datos binarios que pertenece a la entidad especificada, usando el encabezado de mensaje Content-Type especificado.
No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Espacio de nombres: System.Data.Services.Client
Ensamblado: Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)
Sintaxis
'Declaración
Public Function GetReadStream ( _
entity As Object, _
acceptContentType As String _
) As DataServiceStreamResponse
'Uso
Dim instance As DataServiceContext
Dim entity As Object
Dim acceptContentType As String
Dim returnValue As DataServiceStreamResponse
returnValue = instance.GetReadStream(entity, _
acceptContentType)
public DataServiceStreamResponse GetReadStream(
Object entity,
string acceptContentType
)
public:
DataServiceStreamResponse^ GetReadStream(
Object^ entity,
String^ acceptContentType
)
member GetReadStream :
entity:Object *
acceptContentType:string -> DataServiceStreamResponse
public function GetReadStream(
entity : Object,
acceptContentType : String
) : DataServiceStreamResponse
Parámetros
- entity
Tipo: System.Object
Entidad que tiene el flujo de datos binarios que se va a recuperar.
- acceptContentType
Tipo: System.String
Valor Content-Type del flujo de datos binarios solicitado del servicio de datos, especificado en el encabezado Accept.
Valor devuelto
Tipo: System.Data.Services.Client.DataServiceStreamResponse
Instancia de DataServiceStreamResponse que representa la respuesta.
Excepciones
| Excepción | Condición |
|---|---|
| ArgumentNullException | entity es nulles una referencia NULL (Nothing en Visual Basic).. O bien acceptContentType es nulles una referencia NULL (Nothing en Visual Basic).. |
| ArgumentException | Este DataServiceContext no realiza el seguimiento de entity. O bien entity se encuentra en el estado Added. O bien entity no es una entrada de vínculo multimedia y no tiene un flujo relacionado. |
Comentarios
El parámetro acceptContentType debe ser un valor Content-Type válido para el encabezado HTTP Accept.
El método GetReadStream solicita sincrónicamente el flujo de datos binarios relacionado para entity.
En el protocolo AtomPub, entity es una entrada de vínculo de multimedia y el flujo binario es el recurso multimedia asociado.
No se realiza ninguna validación en los encabezados que se establecen en acceptContentType. Por tanto, no modifique este encabezado HTTP de manera que cambie el significado de la solicitud.