Metodo IDataServiceStreamProvider2.GetWriteStream (Object, ResourceProperty, String, Nullable<Boolean>, DataServiceOperationContext)
Restituisce il flusso che il servizio dati utilizza per scrivere i dati binari ricevuti dal client come il flusso denominato specificato.
Spazio dei nomi System.Data.Services.Providers
Assembly: Microsoft.Data.Services (in Microsoft.Data.Services.dll)
Sintassi
'Dichiarazione
Function GetWriteStream ( _
entity As Object, _
streamProperty As ResourceProperty, _
etag As String, _
checkETagForEquality As Nullable(Of Boolean), _
operationContext As DataServiceOperationContext _
) As Stream
'Utilizzo
Dim instance As IDataServiceStreamProvider2
Dim entity As Object
Dim streamProperty As ResourceProperty
Dim etag As String
Dim checkETagForEquality As Nullable(Of Boolean)
Dim operationContext As DataServiceOperationContext
Dim returnValue As Stream
returnValue = instance.GetWriteStream(entity, _
streamProperty, etag, checkETagForEquality, _
operationContext)
Stream GetWriteStream(
Object entity,
ResourceProperty streamProperty,
string etag,
Nullable<bool> checkETagForEquality,
DataServiceOperationContext operationContext
)
Stream^ GetWriteStream(
Object^ entity,
ResourceProperty^ streamProperty,
String^ etag,
Nullable<bool> checkETagForEquality,
DataServiceOperationContext^ operationContext
)
abstract GetWriteStream :
entity:Object *
streamProperty:ResourceProperty *
etag:string *
checkETagForEquality:Nullable<bool> *
operationContext:DataServiceOperationContext -> Stream
function GetWriteStream(
entity : Object,
streamProperty : ResourceProperty,
etag : String,
checkETagForEquality : Nullable<boolean>,
operationContext : DataServiceOperationContext
) : Stream
Parametri
- entity
Tipo: System.Object
Entità a cui appartiene il flusso denominato.
- streamProperty
Tipo: System.Data.Services.Providers.ResourceProperty
Oggetto ResourceProperty che rappresenta il flusso denominato.
- etag
Tipo: System.String
Valore eTag inviato come parte della richiesta HTTP inviata al servizio dati.
- checkETagForEquality
Tipo: System.Nullable<Boolean>
Valore Boolean che ammette valori null che determina quale tipo di richiesta condizionale viene inoltrata al servizio dati, che è true quando l'eTag è stato inviato in un'intestazione If-Match, false quando l'eTag è stato inviato in un'intestazione If-None-Match e nullriferimento Null (Nothing in Visual Basic). quando la richiesta non era condizionale e non era incluso alcun eTag nella richiesta.
- operationContext
Tipo: System.Data.Services.DataServiceOperationContext
Istanza DataServiceOperationContext utilizzata dal servizio dati per elaborare la richiesta.
Valore restituito
Tipo: System.IO.Stream
Valore Stream valido utilizzato dal servizio dati per scrivere il contenuto di dati binari ricevuti dal client.
Osservazioni
Il metodo GetWriteStream non deve mai restituire un valore nullriferimento Null (Nothing in Visual Basic)..
operationContext viene fornito come argomento perché un responsabile dell'implementazione di questo metodo di interfaccia avrà bisogno di informazioni dalle intestazioni della richiesta HTTP per creare un flusso di scrittura. Quando si implementa questo metodo, è necessario eseguire controlli della concorrenza secondo le esigenze. Se un'intestazione di richiesta If-Match o If-None-Match è inclusa nella richiesta, etag non sarà nullriferimento Null (Nothing in Visual Basic).. In questo caso, il metodo deve eseguire il controllo della concorrenza appropriato. Se il controllo della concorrenza viene superato, il metodo restituisce il flusso richiesto. Se i controlli della concorrenza hanno esito negativo, il metodo genera un oggetto DataServiceException con il codice della risposta HTTP appropriato.
Quando si implementa questo metodo, le intestazioni di risposta HTTP Content-Type o eTag non devono essere impostate perché vengono impostate dal runtime del servizio dati. È possibile impostare le intestazioni di risposta HTTP restanti tramite l'elemento operationContext fornito.