Stream.CopyToAsync 메서드

public:
 virtual System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ destination, int bufferSize, System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task CopyToAsync (System.IO.Stream destination, int bufferSize, System.Threading.CancellationToken cancellationToken);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task CopyToAsync (System.IO.Stream destination, int bufferSize, System.Threading.CancellationToken cancellationToken);

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

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member CopyToAsync : System.IO.Stream * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.CopyToAsync : System.IO.Stream * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function CopyToAsync (destination As Stream, bufferSize As Integer, cancellationToken As CancellationToken) As Task

매개 변수

반환

Task

비동기 복사 작업을 나타내는 작업입니다.A task that represents the asynchronous copy operation.

특성

ComVisibleAttribute

예외

설명

CopyToAsync메서드를 사용 하면 주 스레드를 차단 하지 않고 리소스를 많이 사용 하는 i/o 작업을 수행할 수 있습니다.The CopyToAsync method enables you to perform resource-intensive I/O operations without blocking the main thread. 이 성능 고려 사항은 특히 시간이 소비되는 스트림 작업이 UI 스레드를 차단하고 응용 프로그램이 작동하지 않는 것처럼 표시할 수 있는 Windows 8.x 스토어Windows 8.x Store 응용 프로그램 또는 데스크톱desktop 응용 프로그램에서 중요합니다.This performance consideration is particularly important in a Windows 8.x 스토어Windows 8.x Store app or 데스크톱desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. 비동기 메서드는 async await Visual Basic 및 c #의 및 키워드와 함께 사용 됩니다.The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

작업이 완료 되기 전에 취소 되는 경우 반환 된 작업에는 Canceled 속성에 대 한 값이 포함 됩니다 Status .If the operation is canceled before it completes, the returned task contains the Canceled value for the Status property.

복사는 현재 스트림의 현재 위치에서 시작 됩니다.Copying begins at the current position in the current stream.

두 스트림 간의 복사 예는 오버 로드를 참조 하세요 CopyToAsync(Stream) .For an example of copying between two streams, see the CopyToAsync(Stream) overload.

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

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

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

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

매개 변수

반환

Task

비동기 복사 작업을 나타내는 작업입니다.A task that represents the asynchronous copy operation.

설명

CopyToAsync메서드를 사용 하면 주 스레드를 차단 하지 않고 리소스를 많이 사용 하는 i/o 작업을 수행할 수 있습니다.The CopyToAsync method enables you to perform resource-intensive I/O operations without blocking the main thread. 이 성능 고려 사항은 특히 시간이 소비되는 스트림 작업이 UI 스레드를 차단하고 응용 프로그램이 작동하지 않는 것처럼 표시할 수 있는 Windows 8.x 스토어Windows 8.x Store 응용 프로그램 또는 데스크톱desktop 응용 프로그램에서 중요합니다.This performance consideration is particularly important in a Windows 8.x 스토어Windows 8.x Store app or 데스크톱desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. 비동기 메서드는 async await Visual Basic 및 c #의 및 키워드와 함께 사용 됩니다.The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

작업이 완료 되기 전에 취소 되는 경우 반환 된 작업에는 Canceled 속성에 대 한 값이 포함 됩니다 Status .If the operation is canceled before it completes, the returned task contains the Canceled value for the Status property.

복사는 현재 스트림의 현재 위치에서 시작 됩니다.Copying begins at the current position in the current stream.

두 스트림 간의 복사 예는 오버 로드를 참조 하세요 CopyToAsync(Stream) .For an example of copying between two streams, see the CopyToAsync(Stream) overload.

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

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

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task CopyToAsync (System.IO.Stream destination);

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

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CopyToAsync : System.IO.Stream -> System.Threading.Tasks.Task

Public Function CopyToAsync (destination As Stream) As Task

매개 변수

반환

Task

비동기 복사 작업을 나타내는 작업입니다.A task that represents the asynchronous copy operation.

특성

ComVisibleAttribute

예외

예제

다음 예제에서는 두 개체를 사용 하 여 FileStream 한 디렉터리에서 다른 디렉터리로 파일을 비동기적으로 복사 하는 방법을 보여 줍니다.The following example demonstrates how to use two FileStream objects to asynchronously copy the files from one directory to another. FileStream 클래스는 Stream 클래스에서 파생됩니다.The FileStream class derives from the Stream class. Click컨트롤에 대 한 이벤트 처리기는 Button async 비동기 메서드를 호출 하므로 한정자로 표시 됩니다.Notice that the Click event handler for the Button control is marked with the async modifier because it calls an asynchronous method

using System;
using System.Threading.Tasks;
using System.Windows;
using System.IO;

namespace WpfApplication
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private async void Button_Click(object sender, RoutedEventArgs e)
        {
            string StartDirectory = @"c:\Users\exampleuser\start";
            string EndDirectory = @"c:\Users\exampleuser\end";

            foreach (string filename in Directory.EnumerateFiles(StartDirectory))
            {
                using (FileStream SourceStream = File.Open(filename, FileMode.Open))
                {
                    using (FileStream DestinationStream = File.Create(EndDirectory + filename.Substring(filename.LastIndexOf('\\'))))
                    {
                        await SourceStream.CopyToAsync(DestinationStream);
                    }
                }
            }
        }
    }
}

Imports System.IO

Class MainWindow

    Private Async Sub Button_Click(sender As Object, e As RoutedEventArgs)
        Dim StartDirectory As String = "c:\Users\exampleuser\start"
        Dim EndDirectory As String = "c:\Users\exampleuser\end"

        For Each filename As String In Directory.EnumerateFiles(StartDirectory)
            Using SourceStream As FileStream = File.Open(filename, FileMode.Open)
                Using DestinationStream As FileStream = File.Create(EndDirectory + filename.Substring(filename.LastIndexOf("\"c)))
                    Await SourceStream.CopyToAsync(DestinationStream)
                End Using

            End Using
        Next
    End Sub

End Class

설명

CopyToAsync메서드를 사용 하면 주 스레드를 차단 하지 않고 리소스를 많이 사용 하는 i/o 작업을 수행할 수 있습니다.The CopyToAsync method enables you to perform resource-intensive I/O operations without blocking the main thread. 이 성능 고려 사항은 특히 시간이 소비되는 스트림 작업이 UI 스레드를 차단하고 응용 프로그램이 작동하지 않는 것처럼 표시할 수 있는 Windows 8.x 스토어Windows 8.x Store 응용 프로그램 또는 데스크톱desktop 응용 프로그램에서 중요합니다.This performance consideration is particularly important in a Windows 8.x 스토어Windows 8.x Store app or 데스크톱desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. 비동기 메서드는 async await Visual Basic 및 c #의 및 키워드와 함께 사용 됩니다.The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

복사는 현재 스트림의 현재 위치에서 시작 됩니다.Copying begins at the current position in the current stream.

public:
 System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ destination, int bufferSize);

public System.Threading.Tasks.Task CopyToAsync (System.IO.Stream destination, int bufferSize);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task CopyToAsync (System.IO.Stream destination, int bufferSize);

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

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CopyToAsync : System.IO.Stream * int -> System.Threading.Tasks.Task

Public Function CopyToAsync (destination As Stream, bufferSize As Integer) As Task

매개 변수

반환

Task

비동기 복사 작업을 나타내는 작업입니다.A task that represents the asynchronous copy operation.

특성

ComVisibleAttribute

예외

설명

CopyToAsync메서드를 사용 하면 주 스레드를 차단 하지 않고 리소스를 많이 사용 하는 i/o 작업을 수행할 수 있습니다.The CopyToAsync method enables you to perform resource-intensive I/O operations without blocking the main thread. 이 성능 고려 사항은 특히 시간이 소비되는 스트림 작업이 UI 스레드를 차단하고 응용 프로그램이 작동하지 않는 것처럼 표시할 수 있는 Windows 8.x 스토어Windows 8.x Store 응용 프로그램 또는 데스크톱desktop 응용 프로그램에서 중요합니다.This performance consideration is particularly important in a Windows 8.x 스토어Windows 8.x Store app or 데스크톱desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. 비동기 메서드는 async await Visual Basic 및 c #의 및 키워드와 함께 사용 됩니다.The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

복사는 현재 스트림의 현재 위치에서 시작 됩니다.Copying begins at the current position in the current stream.

두 스트림 간의 복사 예는 오버 로드를 참조 하세요 CopyToAsync(Stream) .For an example of copying between two streams, see the CopyToAsync(Stream) overload.