Partager via


Méthode IDataServiceStreamProvider2.GetWriteStream (Object, ResourceProperty, String, Nullable<Boolean>, DataServiceOperationContext)

Retourne le flux que le service de données utilise pour écrire les données binaires reçues de client comme flux nommé spécifié.

Espace de noms :  System.Data.Services.Providers
Assembly :  Microsoft.Data.Services (en Microsoft.Data.Services.dll)

Syntaxe

'Déclaration
Function GetWriteStream ( _
    entity As Object, _
    streamProperty As ResourceProperty, _
    etag As String, _
    checkETagForEquality As Nullable(Of Boolean), _
    operationContext As DataServiceOperationContext _
) As Stream
'Utilisation
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

Paramètres

  • entity
    Type : System.Object
    Entité à laquelle le flux nommé appartient.
  • etag
    Type : System.String
    Valeur de l'ETAG envoyée dans le cadre de la requête HTTP envoyée au service de données.
  • checkETagForEquality
    Type : System.Nullable<Boolean>
    Valeur Boolean nullable qui détermine quel type de demande conditionnelle a été publié dans le service de données, qui est true lorsque l'ETAG a été introduit dans un en-tête If-Match, false lorsque l'ETAG a été introduit dans un en-tête If-None-Match, et nullune référence Null (Nothing dans Visual Basic) lorsque la demande n'était pas conditionnelles et qu'aucun ETAG n'y était inclus.

Valeur de retour

Type : System.IO.Stream
Stream valide que le service de données utilise pour écrire le contenu des données binaires reçues du client.

Notes

La méthode GetWriteStream ne doit jamais retourner une valeur nulle.

Le operationContext est fourni comme argument car un implémenteur de cette méthode d'interface a besoin des informations des en-têtes de demande HTTP pour créer un flux d'écriture. Lorsque vous implémentez cette méthode, vous devez exécuter des contrôles d'accès concurrentiels selon les besoins. leSi un en-tête de demande If-Match ou If-None-Match a été inclus dans la demande, le etag ne sera pas de type nullune référence Null (Nothing dans Visual Basic). Dans ce cas, cette méthode doit exécuter le contrôle d'accès concurrentiel approprié. Si le contrôle d'accès concurrentiel réussit, cette méthode doit retourner le flux de données demandé. Si les contrôles d'accès concurrentiel échouent, la méthode doit déclencher une exception DataServiceException avec le code de réponse HTTP approprié.

Lorsque vous implémentez cette méthode, vous ne devez pas définir les en-têtes de réponse Content-Type ou eTag HTTP car ils sont définis par l'exécution du service de données. Vous pouvez définir des en-têtes de réponse HTTP restants à l'aide du operationContextfourni.

Voir aussi

Référence

IDataServiceStreamProvider2 Interface

Surcharge GetWriteStream

Espace de noms System.Data.Services.Providers