MemoryStream.WriteAsync Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Túlterhelések
| Name | Description |
|---|---|
| WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
Aszinkron módon írja be az aktuális memóriafolyamba |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Aszinkron módon bájtok sorozatát írja az aktuális streambe, az aktuális pozíciót a streamen belül a megírt bájtok számával lépteti előre, és figyeli a lemondási kérelmeket. |
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)
Aszinkron módon írja be az aktuális memóriafolyamba source tárolt bájtok sorrendjét, a megírt bájtok számával előrelépteti a memóriafolyam aktuális pozícióját, és figyeli a lemondási kérelmeket.
public override System.Threading.Tasks.ValueTask WriteAsync(ReadOnlyMemory<byte> source, System.Threading.CancellationToken cancellationToken = default);override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Overrides Function WriteAsync (source As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParaméterek
- sourcebuffer
- ReadOnlyMemory<Byte>
Az adatok írásához használandó memóriaterület.
- cancellationToken
- CancellationToken
A lemondási kérelmek figyelésére szolgáló jogkivonat. Az alapértelmezett érték a None.
Válaszok
Az aszinkron írási műveletet képviselő feladat.
Kivételek
A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.
A következőre érvényes:
WriteAsync(Byte[], Int32, Int32, CancellationToken)
Aszinkron módon bájtok sorozatát írja az aktuális streambe, az aktuális pozíciót a streamen belül a megírt bájtok számával lépteti előre, és figyeli a lemondási kérelmeket.
public:
override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task WriteAsync(byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteAsync(byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task[<System.Runtime.InteropServices.ComVisible(false)>]
override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As TaskParaméterek
- buffer
- Byte[]
A puffer, amelyből adatokat írhat.
- offset
- Int32
A nullaalapú bájteltolás buffer , amelyből a bájtok másolása megkezdhető a streambe.
- count
- Int32
Az írható bájtok maximális száma.
- cancellationToken
- CancellationToken
A lemondási kérelmek figyelésére szolgáló jogkivonat. Az alapértelmezett érték a None.
Válaszok
Az aszinkron írási műveletet képviselő feladat.
- Attribútumok
Kivételek
buffer az null.
offset vagy count negatív.
A puffer hosszánál nagyobb és count nagyobb összegoffset.
A stream nem támogatja az írást.
A stream el lett dobva.
A streamet jelenleg egy korábbi írási művelet használja.
A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.
Megjegyzések
Ha a művelet befejeződése előtt megszakítja a műveletet, a visszaadott tevékenység tartalmazza a CanceledStatus tulajdonság értékét.
A lemondási jogkivonatot az osztály egy példányának CancellationTokenSource létrehozásával és a Token tulajdonság paraméterként cancellationToken való átadásával hozhatja létre.
Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által Write(Byte[], Int32, Int32)kiadott kivételeket: .