NegotiateStream.WriteAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
非同步寫入指定數量 Byte的 s。 |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
非同步寫入指定數量 Byte的 s。 |
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)
非同步寫入指定數量 Byte的 s。
public override System.Threading.Tasks.ValueTask WriteAsync(ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask參數
- buffer
- ReadOnlyMemory<Byte>
一個包含要寫入 .NegotiateStream
- cancellationToken
- CancellationToken
用來監控取消申請的代幣。
傳回
代表非同步讀取操作的 A ValueTask 。
例外狀況
這個物件已經關閉了。
尚未進行認證。
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
若啟用加密、簽名或加密加簽名，此方法會從緩衝區讀取資料，進行加密、簽署或加密並簽署，並透過底層串流傳輸。 若未使用資料加密或簽章等安全服務，此方法會 WriteAsync 呼叫底層串流。
在成功驗證之前，你不能呼叫這個方法。 要驗證，請呼叫其中一個 AuthenticateAsClient、 AuthenticateAsClientAsync、 BeginAuthenticateAsClient、 AuthenticateAsServerAuthenticateAsServerAsync、 或 BeginAuthenticateAsServer 方法。
適用於
WriteAsync(Byte[], Int32, Int32, CancellationToken)
非同步寫入指定數量 Byte的 s。
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);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 Task參數
- cancellationToken
- CancellationToken
傳回
代表非同步讀取操作的 A Task 。
例外狀況
buffer 是 null。
這個物件已經關閉了。
尚未進行認證。
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
若啟用加密、簽名或加密加簽名，此方法會從緩衝區讀取資料，進行加密、簽署或加密並簽署，並透過底層串流傳輸。 若未使用資料加密或簽章等安全服務，此方法會 WriteAsync 呼叫底層串流。
在成功驗證之前，你不能呼叫這個方法。 要驗證，請呼叫其中一個 AuthenticateAsClient、 AuthenticateAsClientAsync、 BeginAuthenticateAsClient、 AuthenticateAsServerAuthenticateAsServerAsync、 或 BeginAuthenticateAsServer 方法。
此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 Write(Byte[], Int32, Int32)拋出的例外。
