WebClient.UploadFileAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 로컬 파일을 지정된 리소스에 업로드합니다. 이들 메서드는 호출 스레드를 차단하지 않습니다.
오버로드
| UploadFileAsync(Uri, String) |
POST 메서드를 사용하여 지정된 로컬 파일을 지정된 리소스에 업로드합니다. 이 메서드는 호출 스레드를 차단하지 않습니다. |
| UploadFileAsync(Uri, String, String) |
POST 메서드를 사용하여 지정된 로컬 파일을 지정된 리소스에 업로드합니다. 이 메서드는 호출 스레드를 차단하지 않습니다. |
| UploadFileAsync(Uri, String, String, Object) |
POST 메서드를 사용하여 지정된 로컬 파일을 지정된 리소스에 업로드합니다. 이 메서드는 호출 스레드를 차단하지 않습니다. |
UploadFileAsync(Uri, String)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
POST 메서드를 사용하여 지정된 로컬 파일을 지정된 리소스에 업로드합니다. 이 메서드는 호출 스레드를 차단하지 않습니다.
public:
void UploadFileAsync(Uri ^ address, System::String ^ fileName);public void UploadFileAsync (Uri address, string fileName);member this.UploadFileAsync : Uri * string -> unitPublic Sub UploadFileAsync (address As Uri, fileName As String)매개 변수
- address
- Uri
파일을 받을 리소스의 URI입니다. HTTP 리소스의 경우 이 URI는 POST 메서드로 전송되는 요청을 받아들일 수 있는 스크립트, ASP 페이지 등의 리소스를 식별해야 합니다.
- fileName
- String
리소스에 보낼 파일입니다.
예외
BaseAddress 및 address를 조합하여 만든 URI가 잘못된 경우
또는
fileName이 null 또는 Empty이거나, 잘못된 문자를 포함하거나, 지정된 파일 경로가 없는 경우
또는
스트림을 여는 동안 오류가 발생한 경우
또는
리소스를 호스팅하는 서버에서 응답이 없는 경우
또는
Content-type 헤더가 multipart로 시작되는 경우
설명
파일은 스레드 풀에서 자동으로 할당되는 스레드 리소스를 사용하여 비동기적으로 전송됩니다. 파일 업로드가 완료될 때 알림을 받으려면 이벤트에 이벤트 처리기를 UploadFileCompleted 추가합니다.
이 메서드는 파일이 전송되는 동안 호출 스레드를 차단하지 않습니다. 서버의 응답을 기다리는 동안 파일 및 블록을 보내려면 메서드 중 UploadFile 하나를 사용합니다.
.NET Framework 및 .NET Core 1.0에서는 메서드를 호출 CancelAsync 하여 완료되지 않은 비동기 작업을 취소할 수 있습니다.
속성이 BaseAddress 빈 문자열("") address 이 아닌 경우 요청된 데이터의 절대 URI를 형성하기 위해 와 BaseAddress 결합된 상대 URI여야 합니다. 속성이 QueryString 빈 문자열이 아니면 에 추가됩니다 address.
이 메서드는 STOR 명령을 사용하여 FTP 리소스를 업로드합니다. HTTP 리소스의 경우 POST 메서드가 사용됩니다.
참고
애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다. 자세한 내용은 .NET Framework 네트워크 추적을 참조하세요.
이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw UploadFile(Uri, String)된 예외를 참조하세요.
적용 대상
UploadFileAsync(Uri, String, String)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
POST 메서드를 사용하여 지정된 로컬 파일을 지정된 리소스에 업로드합니다. 이 메서드는 호출 스레드를 차단하지 않습니다.
public:
void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);public void UploadFileAsync (Uri address, string? method, string fileName);public void UploadFileAsync (Uri address, string method, string fileName);member this.UploadFileAsync : Uri * string * string -> unitPublic Sub UploadFileAsync (address As Uri, method As String, fileName As String)매개 변수
- address
- Uri
파일을 받을 리소스의 URI입니다. HTTP 리소스의 경우 이 URI는 POST 메서드로 전송되는 요청을 받아들일 수 있는 스크립트, ASP 페이지 등의 리소스를 식별해야 합니다.
- method
- String
리소스에 데이터를 보내는 데 사용되는 메서드입니다. null인 경우 http의 기본값은 POST이고 ftp의 기본값은 STOR입니다.
- fileName
- String
리소스에 보낼 파일입니다.
예외
BaseAddress 및 address를 조합하여 만든 URI가 잘못된 경우
또는
fileName이 null 또는 Empty이거나, 잘못된 문자를 포함하거나, 지정된 파일 경로가 없는 경우
또는
스트림을 여는 동안 오류가 발생한 경우
또는
리소스를 호스팅하는 서버에서 응답이 없는 경우
또는
Content-type 헤더가 multipart로 시작되는 경우
설명
파일은 스레드 풀에서 자동으로 할당되는 스레드 리소스를 사용하여 비동기적으로 전송됩니다. 파일 업로드가 완료될 때 알림을 받으려면 이벤트에 이벤트 처리기를 UploadFileCompleted 추가합니다.
이 메서드는 파일이 전송되는 동안 호출 스레드를 차단하지 않습니다. 서버의 응답을 기다리는 동안 파일 및 블록을 보내려면 메서드 중 UploadFile 하나를 사용합니다.
.NET Framework 및 .NET Core 1.0에서는 메서드를 호출 CancelAsync 하여 완료되지 않은 비동기 작업을 취소할 수 있습니다.
속성이 BaseAddress 빈 문자열("") address 이 아닌 경우 요청된 데이터의 절대 URI를 형성하기 위해 와 BaseAddress 결합된 상대 URI여야 합니다. 속성이 QueryString 빈 문자열이 아니면 에 추가됩니다 address.
이 메서드는 STOR 명령을 사용하여 FTP 리소스를 업로드합니다. HTTP 리소스의 경우 POST 메서드가 사용됩니다.
참고
애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다. 자세한 내용은 .NET Framework 네트워크 추적을 참조하세요.
이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw UploadFile(Uri, String, String)된 예외를 참조하세요.
적용 대상
UploadFileAsync(Uri, String, String, Object)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
POST 메서드를 사용하여 지정된 로컬 파일을 지정된 리소스에 업로드합니다. 이 메서드는 호출 스레드를 차단하지 않습니다.
public:
void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName, System::Object ^ userToken);public void UploadFileAsync (Uri address, string? method, string fileName, object? userToken);public void UploadFileAsync (Uri address, string method, string fileName, object userToken);member this.UploadFileAsync : Uri * string * string * obj -> unitPublic Sub UploadFileAsync (address As Uri, method As String, fileName As String, userToken As Object)매개 변수
- address
- Uri
파일을 받을 리소스의 URI입니다. HTTP 리소스의 경우 이 URI는 POST 메서드로 전송되는 요청을 받아들일 수 있는 스크립트, ASP 페이지 등의 리소스를 식별해야 합니다.
- method
- String
리소스에 데이터를 보내는 데 사용되는 메서드입니다. null인 경우 http의 기본값은 POST이고 ftp의 기본값은 STOR입니다.
- fileName
- String
리소스에 보낼 파일입니다.
- userToken
- Object
비동기 작업이 완료될 때 호출되는 메서드로 전달되는 사용자 정의 개체입니다.
예외
BaseAddress 및 address를 조합하여 만든 URI가 잘못된 경우
또는
fileName이 null 또는 Empty이거나, 잘못된 문자를 포함하거나, 지정된 파일 경로가 없는 경우
또는
스트림을 여는 동안 오류가 발생한 경우
또는
리소스를 호스팅하는 서버에서 응답이 없는 경우
또는
Content-type 헤더가 multipart로 시작되는 경우
설명
파일은 스레드 풀에서 자동으로 할당되는 스레드 리소스를 사용하여 비동기적으로 전송됩니다. 파일 업로드가 완료될 때 알림을 받으려면 이벤트에 이벤트 처리기를 UploadFileCompleted 추가합니다.
이 메서드는 파일이 전송되는 동안 호출 스레드를 차단하지 않습니다. 서버의 응답을 기다리는 동안 파일 및 블록을 보내려면 메서드 중 UploadFile 하나를 사용합니다.
.NET Framework 및 .NET Core 1.0에서는 메서드를 호출 CancelAsync 하여 완료되지 않은 비동기 작업을 취소할 수 있습니다.
속성이 BaseAddress 빈 문자열("") address 이 아닌 경우 요청된 데이터의 절대 URI를 형성하기 위해 와 BaseAddress 결합된 상대 URI여야 합니다. 속성이 QueryString 빈 문자열이 아니면 에 추가됩니다 address.
이 메서드는 STOR 명령을 사용하여 FTP 리소스를 업로드합니다. HTTP 리소스의 경우 POST 메서드가 사용됩니다.
참고
애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다. 자세한 내용은 .NET Framework 네트워크 추적을 참조하세요.
적용 대상
.NET
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기