WebClient.UploadValuesTaskAsync 메서드

정의

네임스페이스:

System.Net

어셈블리:

System.Net.WebClient.dll

작업 개체를 사용하여 지정된 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

작업 개체를 사용하여 지정된 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);

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[]>

비동기 작업을 나타내는 작업 개체입니다. 작업 개체의 Result 속성은 서버에서 보낸 응답을 포함하는 Byte 배열을 반환합니다.

예외

ArgumentNullException

address 매개 변수가 null.

-또는-

data 매개 변수가 null.

WebException

BaseAddress결합하여 형성된 URI 및 address 유효하지 않습니다.

-또는-

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

-또는-

리소스를 호스팅하는 서버의 응답이 없습니다.

-또는-

스트림을 여는 동안 오류가 발생했습니다.

-또는-

Content-type 헤더는 null 또는 "application/x-www-form-urlencoded"가 아닙니다.

설명

주의

WebRequest, HttpWebRequest, ServicePoint및 WebClient 사용되지 않으므로 새 개발에 사용하면 안 됩니다. 대신 HttpClient 사용합니다.

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

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

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

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

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

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

메모

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

UploadValuesTaskAsync(String, NameValueCollection)

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);

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[]>

비동기 작업을 나타내는 작업 개체입니다. 작업 개체의 Result 속성은 서버에서 보낸 응답을 포함하는 Byte 배열을 반환합니다.

예외

ArgumentNullException

address 매개 변수가 null.

-또는-

data 매개 변수가 null.

WebException

BaseAddress결합하여 형성된 URI 및 address 유효하지 않습니다.

-또는-

리소스를 호스팅하는 서버의 응답이 없습니다.

-또는-

스트림을 여는 동안 오류가 발생했습니다.

-또는-

Content-type 헤더는 null 또는 "application/x-www-form-urlencoded"가 아닙니다.

설명

주의

WebRequest, HttpWebRequest, ServicePoint및 WebClient 사용되지 않으므로 새 개발에 사용하면 안 됩니다. 대신 HttpClient 사용합니다.

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

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

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

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

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

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

메모

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

UploadValuesTaskAsync(Uri, NameValueCollection)

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);

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[]>

비동기 작업을 나타내는 작업 개체입니다. 작업 개체의 Result 속성은 서버에서 보낸 응답을 포함하는 Byte 배열을 반환합니다.

예외

ArgumentNullException

address 매개 변수가 null.

-또는-

data 매개 변수가 null.

WebException

BaseAddress결합하여 형성된 URI 및 address 유효하지 않습니다.

-또는-

스트림을 여는 동안 오류가 발생했습니다.

-또는-

리소스를 호스팅하는 서버의 응답이 없습니다.

-또는-

Content-type 헤더 값이 null 않으며 application/x-www-form-urlencoded않습니다.

설명

주의

WebRequest, HttpWebRequest, ServicePoint및 WebClient 사용되지 않으므로 새 개발에 사용하면 안 됩니다. 대신 HttpClient 사용합니다.

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

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

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

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

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

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

메모

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

UploadValuesTaskAsync(Uri, String, NameValueCollection)

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);

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[]>

비동기 작업을 나타내는 작업 개체입니다. 작업 개체의 Result 속성은 서버에서 보낸 응답을 포함하는 Byte 배열을 반환합니다.

예외

ArgumentNullException

address 매개 변수가 null.

-또는-

data 매개 변수가 null.

WebException

BaseAddress결합하여 형성된 URI 및 address 유효하지 않습니다.

-또는-

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

-또는-

리소스를 호스팅하는 서버의 응답이 없습니다.

-또는-

스트림을 여는 동안 오류가 발생했습니다.

-또는-

Content-type 헤더는 null 또는 "application/x-www-form-urlencoded"가 아닙니다.

설명

주의

WebRequest, HttpWebRequest, ServicePoint및 WebClient 사용되지 않으므로 새 개발에 사용하면 안 됩니다. 대신 HttpClient 사용합니다.

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

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

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

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

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

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

메모

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