WebClient.UploadValuesTaskAsync 메서드

정의

작업 개체를 사용하여 지정된 이름/값 컬렉션을 지정된 URI로 식별된 리소스로 비동기 작업으로 업로드합니다. 이들 메서드는 호출 스레드를 차단하지 않습니다.

오버로드

UploadValuesTaskAsync(String, String, NameValueCollection)

작업 개체를 사용하여 지정된 이름/값 컬렉션을 지정된 URI로 식별된 리소스로 비동기 작업으로 업로드합니다.

UploadValuesTaskAsync(String, NameValueCollection)

작업 개체를 사용하여 지정된 이름/값 컬렉션을 지정된 URI로 식별된 리소스로 비동기 작업으로 업로드합니다.

UploadValuesTaskAsync(Uri, NameValueCollection)

작업 개체를 사용하여 지정된 이름/값 컬렉션을 지정된 URI로 식별된 리소스로 비동기 작업으로 업로드합니다.

UploadValuesTaskAsync(Uri, String, NameValueCollection)

작업 개체를 사용하여 지정된 이름/값 컬렉션을 지정된 URI로 식별된 리소스로 비동기 작업으로 업로드합니다.

UploadValuesTaskAsync(String, String, NameValueCollection)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

작업 개체를 사용하여 지정된 이름/값 컬렉션을 지정된 URI로 식별된 리소스로 비동기 작업으로 업로드합니다.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, string? method, System.Collections.Specialized.NameValueCollection data);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, string method, System.Collections.Specialized.NameValueCollection data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, string method, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesTaskAsync : string * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : string * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
Public Function UploadValuesTaskAsync (address As String, method As String, data As NameValueCollection) As Task(Of Byte())

매개 변수

address
String

컬렉션을 받을 리소스의 URI입니다.

method
String

리소스에 컬렉션을 보내는 데 사용되는 HTTP 메서드입니다. null인 경우 http의 기본값은 POST이고 ftp의 기본값은 STOR입니다.

data
NameValueCollection

리소스에 보낼 NameValueCollection입니다.

반환

Task<Byte[]>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다. 작업 개체의 Result 속성은 서버에서 전송한 응답이 포함된 Byte 배열을 반환합니다.

특성

예외

address 매개 변수가 null인 경우

또는

data 매개 변수가 null인 경우

BaseAddressaddress를 조합하여 만든 URI가 잘못된 경우

또는

method는 콘텐츠를 보내는 데 사용할 수 없습니다.

또는

리소스를 호스팅하는 서버에서 응답이 없는 경우

또는

스트림을 여는 동안 오류가 발생한 경우

또는

Content-type 헤더가 null 또는 "application/x-www-form-urlencoded"가 아닌 경우

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 이름/값 컬렉션이 리소스에 업로드된 후 완료됩니다. 이름/값 컬렉션은 스레드 풀에서 자동으로 할당되는 스레드 리소스를 사용하여 비동기적으로 전송됩니다.

.NET Framework 및 .NET Core 1.0에서는 메서드를 호출 CancelAsync 하여 완료되지 않은 비동기 작업을 취소할 수 있습니다.

서버에서 기본 요청을 이해하지 못하는 경우 기본 프로토콜 클래스는 어떤 일이 발생하는지 결정합니다. 일반적으로 WebException 는 오류를 나타내기 위해 속성이 설정된 상태에서 Status throw됩니다.

Content-type 헤더가 이면 이 메서드는 null이를 "application/x-www-form-urlencoded"로 설정합니다.

속성이 BaseAddress 빈 문자열("")이 아니고 address 절대 URI를 포함하지 않는 경우 는 요청된 데이터의 절대 URI address 를 형성하기 위해 와 BaseAddress 결합된 상대 URI여야 합니다. 속성이 QueryString 빈 문자열이 아니면 에 추가됩니다 address.

이 메서드는 STOR 명령을 사용하여 FTP 리소스를 업로드합니다. HTTP 리소스의 경우 POST 메서드가 사용됩니다.

참고

애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다. 자세한 내용은 .NET Framework 네트워크 추적을 참조하세요.

적용 대상

UploadValuesTaskAsync(String, NameValueCollection)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

작업 개체를 사용하여 지정된 이름/값 컬렉션을 지정된 URI로 식별된 리소스로 비동기 작업으로 업로드합니다.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, System.Collections.Specialized.NameValueCollection data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesTaskAsync : string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
Public Function UploadValuesTaskAsync (address As String, data As NameValueCollection) As Task(Of Byte())

매개 변수

address
String

컬렉션을 받을 리소스의 URI입니다.

data
NameValueCollection

리소스에 보낼 NameValueCollection입니다.

반환

Task<Byte[]>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다. 작업 개체의 Result 속성은 서버에서 전송한 응답이 포함된 Byte 배열을 반환합니다.

특성

예외

address 매개 변수가 null인 경우

또는

data 매개 변수가 null인 경우

BaseAddressaddress를 조합하여 만든 URI가 잘못된 경우

또는

리소스를 호스팅하는 서버에서 응답이 없는 경우

또는

스트림을 여는 동안 오류가 발생한 경우

또는

Content-type 헤더가 null 또는 "application/x-www-form-urlencoded"가 아닌 경우

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 이름/값 컬렉션이 리소스에 업로드된 후 완료됩니다. 이름/값 컬렉션은 스레드 풀에서 자동으로 할당되는 스레드 리소스를 사용하여 비동기적으로 전송됩니다.

.NET Framework 및 .NET Core 1.0에서는 메서드를 호출 CancelAsync 하여 완료되지 않은 비동기 작업을 취소할 수 있습니다.

서버에서 기본 요청을 이해하지 못하는 경우 기본 프로토콜 클래스는 어떤 일이 발생하는지 결정합니다. 일반적으로 WebException 는 오류를 나타내기 위해 속성이 설정된 상태에서 Status throw됩니다.

Content-type 헤더가 이면 이 메서드는 null이를 "application/x-www-form-urlencoded"로 설정합니다.

속성이 BaseAddress 빈 문자열("")이 아니고 address 절대 URI를 포함하지 않는 경우 는 요청된 데이터의 절대 URI address 를 형성하기 위해 와 BaseAddress 결합된 상대 URI여야 합니다. 속성이 QueryString 빈 문자열이 아니면 에 추가됩니다 address.

이 메서드는 STOR 명령을 사용하여 FTP 리소스를 업로드합니다. HTTP 리소스의 경우 POST 메서드가 사용됩니다.

참고

애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다. 자세한 내용은 .NET Framework 네트워크 추적을 참조하세요.

적용 대상

UploadValuesTaskAsync(Uri, NameValueCollection)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

작업 개체를 사용하여 지정된 이름/값 컬렉션을 지정된 URI로 식별된 리소스로 비동기 작업으로 업로드합니다.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, System.Collections.Specialized.NameValueCollection data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesTaskAsync : Uri * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : Uri * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
Public Function UploadValuesTaskAsync (address As Uri, data As NameValueCollection) As Task(Of Byte())

매개 변수

address
Uri

컬렉션을 받을 리소스의 URI입니다.

data
NameValueCollection

리소스에 보낼 NameValueCollection입니다.

반환

Task<Byte[]>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다. 작업 개체의 Result 속성은 서버에서 전송한 응답이 포함된 Byte 배열을 반환합니다.

특성

예외

address 매개 변수가 null인 경우

또는

data 매개 변수가 null인 경우

BaseAddressaddress를 조합하여 만든 URI가 잘못된 경우

또는

스트림을 여는 동안 오류가 발생한 경우

또는

리소스를 호스팅하는 서버에서 응답이 없는 경우

또는

Content-type 헤더 값이 nullapplication/x-www-form-urlencoded가 아닌 경우

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 이름/값 컬렉션이 리소스에 업로드된 후 완료됩니다. 이름/값 컬렉션은 스레드 풀에서 자동으로 할당되는 스레드 리소스를 사용하여 비동기적으로 전송됩니다.

.NET Framework 및 .NET Core 1.0에서는 메서드를 호출 CancelAsync 하여 완료되지 않은 비동기 작업을 취소할 수 있습니다.

서버에서 기본 요청을 이해하지 못하는 경우 기본 프로토콜 클래스는 어떤 일이 발생하는지 결정합니다. 일반적으로 WebException 는 오류를 나타내기 위해 속성이 설정된 상태에서 Status throw됩니다.

Content-type 헤더가 이면 이 메서드는 null이를 "application/x-www-form-urlencoded"로 설정합니다.

속성이 BaseAddress 빈 문자열("")이 아니고 address 절대 URI를 포함하지 않는 경우 는 요청된 데이터의 절대 URI address 를 형성하기 위해 와 BaseAddress 결합된 상대 URI여야 합니다. 속성이 QueryString 빈 문자열이 아니면 에 추가됩니다 address.

이 메서드는 STOR 명령을 사용하여 FTP 리소스를 업로드합니다. HTTP 리소스의 경우 POST 메서드가 사용됩니다.

참고

애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다. 자세한 내용은 .NET Framework 네트워크 추적을 참조하세요.

적용 대상

UploadValuesTaskAsync(Uri, String, NameValueCollection)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

작업 개체를 사용하여 지정된 이름/값 컬렉션을 지정된 URI로 식별된 리소스로 비동기 작업으로 업로드합니다.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, string method, System.Collections.Specialized.NameValueCollection data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, string method, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesTaskAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
Public Function UploadValuesTaskAsync (address As Uri, method As String, data As NameValueCollection) As Task(Of Byte())

매개 변수

address
Uri

컬렉션을 받을 리소스의 URI입니다.

method
String

리소스에 컬렉션을 보내는 데 사용되는 HTTP 메서드입니다. null인 경우 http의 기본값은 POST이고 ftp의 기본값은 STOR입니다.

data
NameValueCollection

리소스에 보낼 NameValueCollection입니다.

반환

Task<Byte[]>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다. 작업 개체의 Result 속성은 서버에서 전송한 응답이 포함된 Byte 배열을 반환합니다.

특성

예외

address 매개 변수가 null인 경우

또는

data 매개 변수가 null인 경우

BaseAddressaddress를 조합하여 만든 URI가 잘못된 경우

또는

method는 콘텐츠를 보내는 데 사용할 수 없습니다.

또는

리소스를 호스팅하는 서버에서 응답이 없는 경우

또는

스트림을 여는 동안 오류가 발생한 경우

또는

Content-type 헤더가 null 또는 "application/x-www-form-urlencoded"가 아닌 경우

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 이름/값 컬렉션이 리소스에 업로드된 후 완료됩니다. 이름/값 컬렉션은 스레드 풀에서 자동으로 할당되는 스레드 리소스를 사용하여 비동기적으로 전송됩니다.

.NET Framework 및 .NET Core 1.0에서는 메서드를 호출 CancelAsync 하여 완료되지 않은 비동기 작업을 취소할 수 있습니다.

서버에서 기본 요청을 이해하지 못하는 경우 기본 프로토콜 클래스는 어떤 일이 발생하는지 결정합니다. 일반적으로 WebException 는 오류를 나타내기 위해 속성이 설정된 상태에서 Status throw됩니다.

Content-type 헤더가 이면 이 메서드는 null이를 "application/x-www-form-urlencoded"로 설정합니다.

속성이 BaseAddress 빈 문자열("")이 아니고 address 절대 URI를 포함하지 않는 경우 는 요청된 데이터의 절대 URI address 를 형성하기 위해 와 BaseAddress 결합된 상대 URI여야 합니다. 속성이 QueryString 빈 문자열이 아니면 에 추가됩니다 address.

이 메서드는 STOR 명령을 사용하여 FTP 리소스를 업로드합니다. HTTP 리소스의 경우 POST 메서드가 사용됩니다.

참고

애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다. 자세한 내용은 .NET Framework 네트워크 추적을 참조하세요.

적용 대상