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.
- streamProperty
Type : System.Data.Services.Providers.ResourceProperty
Objet ResourceProperty qui représente le flux nommé.
- 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.
- operationContext
Type : System.Data.Services.DataServiceOperationContext
Instance DataServiceOperationContext utilisée par le service de données pour traiter la demande.
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.