HttpContent.CopyToAsync 方法

定義

命名空間:

System.Net.Http

組件:

System.Net.Http.dll

將 HTTP 內容序列化成位元組資料流，然後複製到 stream 參數所提供的資料流物件。

多載

CopyToAsync(Stream)	將 HTTP 內容序列化成位元組資料流，然後複製到 stream 參數所提供的資料流物件。
CopyToAsync(Stream, TransportContext)	將 HTTP 內容序列化成位元組資料流，然後複製到 stream 參數所提供的資料流物件。
CopyToAsync(Stream, CancellationToken)	將 HTTP 內容序列化成位元組資料流，然後複製到 stream 參數所提供的資料流物件。
CopyToAsync(Stream, TransportContext, CancellationToken)	將 HTTP 內容序列化成位元組資料流，然後複製到 stream 參數所提供的資料流物件。

備註

此作業不會封鎖。

如果實作或SerializeToStreamAsync(Stream, TransportContext)內部，這個方法會使用 SerializeToStreamAsync(Stream, TransportContext, CancellationToken) ，將內容串行化為指定的數據流。 例如，如果先前已緩衝內容，例如，藉由呼叫 LoadIntoBufferAsync()，方法會傳回緩衝的內容，而不是呼叫串行化方法。

CopyToAsync(Stream)

來源:

HttpContent.cs

將 HTTP 內容序列化成位元組資料流，然後複製到 stream 參數所提供的資料流物件。

public:
 System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ stream);

public System.Threading.Tasks.Task CopyToAsync (System.IO.Stream stream);

member this.CopyToAsync : System.IO.Stream -> System.Threading.Tasks.Task

Public Function CopyToAsync (stream As Stream) As Task

參數

stream

Stream

目標資料流。

傳回

Task

工作物件，表示非同步作業。

備註

這項作業不會封鎖。 傳回 Task 的物件會在所有內容都寫入傳遞為 stream 參數的數據流對象之後完成。

CopyToAsync(Stream, TransportContext)

來源:

HttpContent.cs

將 HTTP 內容序列化成位元組資料流，然後複製到 stream 參數所提供的資料流物件。

public:
 System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ stream, System::Net::TransportContext ^ context);

public System.Threading.Tasks.Task CopyToAsync (System.IO.Stream stream, System.Net.TransportContext? context);

member this.CopyToAsync : System.IO.Stream * System.Net.TransportContext -> System.Threading.Tasks.Task

Public Function CopyToAsync (stream As Stream, context As TransportContext) As Task

參數

stream

Stream

目標資料流。

context

TransportContext

傳輸的相關資訊 (例如通道繫結權杖)。 此參數可以是 null。

傳回

Task

工作物件，表示非同步作業。

備註

這項作業不會封鎖。 傳回 Task 的物件會在所有內容都寫入傳遞為 stream 參數的數據流對象之後完成。

CopyToAsync(Stream, CancellationToken)

來源:

HttpContent.cs

將 HTTP 內容序列化成位元組資料流，然後複製到 stream 參數所提供的資料流物件。

public:
 System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ stream, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task CopyToAsync (System.IO.Stream stream, System.Threading.CancellationToken cancellationToken);

member this.CopyToAsync : System.IO.Stream * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function CopyToAsync (stream As Stream, cancellationToken As CancellationToken) As Task

參數

stream

Stream

目標資料流。

cancellationToken

CancellationToken

用於取消作業的取消權杖。

傳回

Task

工作物件，表示非同步作業。

例外狀況

OperationCanceledException

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

備註

這項作業不會封鎖。 傳回 Task 的物件會在所有內容都寫入傳遞為 stream 參數的數據流對象之後完成。

CopyToAsync(Stream, TransportContext, CancellationToken)

來源:

HttpContent.cs

將 HTTP 內容序列化成位元組資料流，然後複製到 stream 參數所提供的資料流物件。

public:
 System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ stream, System::Net::TransportContext ^ context, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task CopyToAsync (System.IO.Stream stream, System.Net.TransportContext? context, System.Threading.CancellationToken cancellationToken);

member this.CopyToAsync : System.IO.Stream * System.Net.TransportContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function CopyToAsync (stream As Stream, context As TransportContext, cancellationToken As CancellationToken) As Task

參數

stream

Stream

目標資料流。

context

TransportContext

傳輸的相關資訊 (例如通道繫結權杖)。 此參數可以是 null。

cancellationToken

CancellationToken

用於取消作業的取消權杖。

傳回

Task

工作物件，表示非同步作業。

例外狀況

OperationCanceledException

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

備註

這項作業不會封鎖。 傳回 Task 的物件會在所有內容都寫入傳遞為 stream 參數的數據流對象之後完成。