WebClient.UploadFileAsync 메서드

정의

지정된 로컬 파일을 지정된 리소스에 업로드합니다.Uploads the specified local file to the specified resource. 이들 메서드는 호출 스레드를 차단하지 않습니다.These methods do not block the calling thread.

오버로드

UploadFileAsync(Uri, String)

POST 메서드를 사용하여 지정된 로컬 파일을 지정된 리소스에 업로드합니다.Uploads the specified local file to the specified resource, using the POST method. 이 메서드는 호출 스레드를 차단하지 않습니다.This method does not block the calling thread.

UploadFileAsync(Uri, String, String)

POST 메서드를 사용하여 지정된 로컬 파일을 지정된 리소스에 업로드합니다.Uploads the specified local file to the specified resource, using the POST method. 이 메서드는 호출 스레드를 차단하지 않습니다.This method does not block the calling thread.

UploadFileAsync(Uri, String, String, Object)

POST 메서드를 사용하여 지정된 로컬 파일을 지정된 리소스에 업로드합니다.Uploads the specified local file to the specified resource, using the POST method. 이 메서드는 호출 스레드를 차단하지 않습니다.This method does not block the calling thread.

UploadFileAsync(Uri, String)

POST 메서드를 사용하여 지정된 로컬 파일을 지정된 리소스에 업로드합니다.Uploads the specified local file to the specified resource, using the POST method. 이 메서드는 호출 스레드를 차단하지 않습니다.This method does not block the calling thread.

public:
 void UploadFileAsync(Uri ^ address, System::String ^ fileName);
public void UploadFileAsync (Uri address, string fileName);
member this.UploadFileAsync : Uri * string -> unit
Public Sub UploadFileAsync (address As Uri, fileName As String)

매개 변수

address
Uri

파일을 받을 리소스의 URI입니다.The URI of the resource to receive the file. HTTP 리소스의 경우 이 URI는 POST 메서드로 전송되는 요청을 받아들일 수 있는 스크립트, ASP 페이지 등의 리소스를 식별해야 합니다.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

fileName
String

리소스에 보낼 파일입니다.The file to send to the resource.

예외

address 매개 변수가 null인 경우The address parameter is null.

또는-or- fileName 매개 변수가 null인 경우The fileName parameter is null.

BaseAddressaddress를 조합하여 만든 URI가 잘못된 경우The URI formed by combining BaseAddress and address is invalid.

또는-or- fileNamenull 또는 Empty이거나, 잘못된 문자를 포함하거나, 지정된 파일 경로가 없는 경우fileName is null, is Empty, contains invalid character, or the specified path to the file does not exist.

또는-or- 스트림을 여는 동안 오류가 발생한 경우An error occurred while opening the stream.

또는-or- 리소스를 호스팅하는 서버에서 응답이 없는 경우There was no response from the server hosting the resource.

또는-or- Content-type 헤더가 multipart로 시작되는 경우The Content-type header begins with multipart.

설명

파일을 비동기적으로 스레드 풀에서 자동으로 할당 된 스레드 리소스를 사용 하 여 전송 됩니다.The file is sent asynchronously using thread resources that are automatically allocated from the thread pool. 파일 업로드가 완료 되 면 알림을 수신 하는 이벤트 처리기를 추가 합니다 UploadFileCompleted 이벤트입니다.To receive notification when the file upload completes, add an event handler to the UploadFileCompleted event.

이 메서드는 파일을 보내는 동안 호출 스레드를 차단 하지 않습니다.This method does not block the calling thread while the file is being sent. 블록을 파일 서버의 응답을 대기 하는 동안에 보내려면 중 하나를 사용 합니다 UploadFile 메서드.To send a file and block while waiting for the server's response, use one of the UploadFile methods.

사용 하 여 완료 되지 않은 비동기 작업은 취소할 수는 CancelAsync 메서드.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

경우는 BaseAddress 속성이 빈 문자열이 아닙니다. (""), address 와 결합 되는 상대 URI 이어야 합니다 BaseAddress 요청된 된 데이터의 절대 URI를 구성 하 합니다.If the BaseAddress property is not an empty string (""), address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. 경우는 QueryString 속성이 빈 문자열이 아닙니다.에 추가 됩니다 address합니다.If the QueryString property is not an empty string, it is appended to address.

이 메서드는의 기본값은 STOR 명령을 사용 하 여 FTP 리소스를 업로드 합니다.This method uses the STOR command to upload an FTP resource. HTTP 리소스를 POST 메서드를 사용 합니다.For an HTTP resource, the POST method is used.

참고

애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다.This member outputs trace information when you enable network tracing in your application. 자세한 내용은 .NET Framework의 네트워크 추적합니다.For more information, see Network Tracing in the .NET Framework.

보안

FileIOPermission
로컬 파일에 액세스할 수to access the local file. 연관된 열거형: ReadAssociated enumeration: Read.

UploadFileAsync(Uri, String, String)

POST 메서드를 사용하여 지정된 로컬 파일을 지정된 리소스에 업로드합니다.Uploads the specified local file to the specified resource, using the POST method. 이 메서드는 호출 스레드를 차단하지 않습니다.This method does not block the calling thread.

public:
 void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);
public void UploadFileAsync (Uri address, string method, string fileName);
member this.UploadFileAsync : Uri * string * string -> unit
Public Sub UploadFileAsync (address As Uri, method As String, fileName As String)

매개 변수

address
Uri

파일을 받을 리소스의 URI입니다.The URI of the resource to receive the file. HTTP 리소스의 경우 이 URI는 POST 메서드로 전송되는 요청을 받아들일 수 있는 스크립트, ASP 페이지 등의 리소스를 식별해야 합니다.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

method
String

리소스에 데이터를 보내는 데 사용되는 메서드입니다.The method used to send the data to the resource. null인 경우 http의 기본값은 POST이고 ftp의 기본값은 STOR입니다.If null, the default is POST for http and STOR for ftp.

fileName
String

리소스에 보낼 파일입니다.The file to send to the resource.

예외

address 매개 변수가 null인 경우The address parameter is null.

또는-or- fileName 매개 변수가 null인 경우The fileName parameter is null.

BaseAddressaddress를 조합하여 만든 URI가 잘못된 경우The URI formed by combining BaseAddress and address is invalid.

또는-or- fileNamenull 또는 Empty이거나, 잘못된 문자를 포함하거나, 지정된 파일 경로가 없는 경우fileName is null, is Empty, contains invalid character, or the specified path to the file does not exist.

또는-or- 스트림을 여는 동안 오류가 발생한 경우An error occurred while opening the stream.

또는-or- 리소스를 호스팅하는 서버에서 응답이 없는 경우There was no response from the server hosting the resource.

또는-or- Content-type 헤더가 multipart로 시작되는 경우The Content-type header begins with multipart.

설명

파일을 비동기적으로 스레드 풀에서 자동으로 할당 된 스레드 리소스를 사용 하 여 전송 됩니다.The file is sent asynchronously using thread resources that are automatically allocated from the thread pool. 파일 업로드가 완료 되 면 알림을 수신 하는 이벤트 처리기를 추가 합니다 UploadFileCompleted 이벤트입니다.To receive notification when the file upload completes, add an event handler to the UploadFileCompleted event.

이 메서드는 파일을 보내는 동안 호출 스레드를 차단 하지 않습니다.This method does not block the calling thread while the file is being sent. 블록을 파일 서버의 응답을 대기 하는 동안에 보내려면 중 하나를 사용 합니다 UploadFile 메서드.To send a file and block while waiting for the server's response, use one of the UploadFile methods.

사용 하 여 완료 되지 않은 비동기 작업은 취소할 수는 CancelAsync 메서드.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

경우는 BaseAddress 속성이 빈 문자열이 아닙니다. (""), address 와 결합 되는 상대 URI 이어야 합니다 BaseAddress 요청된 된 데이터의 절대 URI를 구성 하 합니다.If the BaseAddress property is not an empty string (""), address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. 경우는 QueryString 속성이 빈 문자열이 아닙니다.에 추가 됩니다 address합니다.If the QueryString property is not an empty string, it is appended to address.

이 메서드는의 기본값은 STOR 명령을 사용 하 여 FTP 리소스를 업로드 합니다.This method uses the STOR command to upload an FTP resource. HTTP 리소스를 POST 메서드를 사용 합니다.For an HTTP resource, the POST method is used.

참고

애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다.This member outputs trace information when you enable network tracing in your application. 자세한 내용은 .NET Framework의 네트워크 추적합니다.For more information, see Network Tracing in the .NET Framework.

보안

FileIOPermission
로컬 파일에 액세스할 수to access the local file. 연관된 열거형: ReadAssociated enumeration: Read.

UploadFileAsync(Uri, String, String, Object)

POST 메서드를 사용하여 지정된 로컬 파일을 지정된 리소스에 업로드합니다.Uploads the specified local file to the specified resource, using the POST method. 이 메서드는 호출 스레드를 차단하지 않습니다.This method does not block the calling thread.

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);
member this.UploadFileAsync : Uri * string * string * obj -> unit
Public Sub UploadFileAsync (address As Uri, method As String, fileName As String, userToken As Object)

매개 변수

address
Uri

파일을 받을 리소스의 URI입니다.The URI of the resource to receive the file. HTTP 리소스의 경우 이 URI는 POST 메서드로 전송되는 요청을 받아들일 수 있는 스크립트, ASP 페이지 등의 리소스를 식별해야 합니다.For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.

method
String

리소스에 데이터를 보내는 데 사용되는 메서드입니다.The method used to send the data to the resource. null인 경우 http의 기본값은 POST이고 ftp의 기본값은 STOR입니다.If null, the default is POST for http and STOR for ftp.

fileName
String

리소스에 보낼 파일입니다.The file to send to the resource.

userToken
Object

비동기 작업이 완료될 때 호출되는 메서드로 전달되는 사용자 정의 개체입니다.A user-defined object that is passed to the method invoked when the asynchronous operation completes.

예외

address 매개 변수가 null인 경우The address parameter is null.

또는-or- fileName 매개 변수가 null인 경우The fileName parameter is null.

BaseAddressaddress를 조합하여 만든 URI가 잘못된 경우The URI formed by combining BaseAddress and address is invalid.

또는-or- fileNamenull 또는 Empty이거나, 잘못된 문자를 포함하거나, 지정된 파일 경로가 없는 경우fileName is null, is Empty, contains invalid character, or the specified path to the file does not exist.

또는-or- 스트림을 여는 동안 오류가 발생한 경우An error occurred while opening the stream.

또는-or- 리소스를 호스팅하는 서버에서 응답이 없는 경우There was no response from the server hosting the resource.

또는-or- Content-type 헤더가 multipart로 시작되는 경우The Content-type header begins with multipart.

설명

파일을 비동기적으로 스레드 풀에서 자동으로 할당 된 스레드 리소스를 사용 하 여 전송 됩니다.The file is sent asynchronously using thread resources that are automatically allocated from the thread pool. 파일 업로드가 완료 되 면 알림을 수신 하는 이벤트 처리기를 추가 합니다 UploadFileCompleted 이벤트입니다.To receive notification when the file upload completes, add an event handler to the UploadFileCompleted event.

이 메서드는 파일을 보내는 동안 호출 스레드를 차단 하지 않습니다.This method does not block the calling thread while the file is being sent. 블록을 파일 서버의 응답을 대기 하는 동안에 보내려면 중 하나를 사용 합니다 UploadFile 메서드.To send a file and block while waiting for the server's response, use one of the UploadFile methods.

사용 하 여 완료 되지 않은 비동기 작업은 취소할 수는 CancelAsync 메서드.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

경우는 BaseAddress 속성이 빈 문자열이 아닙니다. (""), address 와 결합 되는 상대 URI 이어야 합니다 BaseAddress 요청된 된 데이터의 절대 URI를 구성 하 합니다.If the BaseAddress property is not an empty string (""), address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. 경우는 QueryString 속성이 빈 문자열이 아닙니다.에 추가 됩니다 address합니다.If the QueryString property is not an empty string, it is appended to address.

이 메서드는의 기본값은 STOR 명령을 사용 하 여 FTP 리소스를 업로드 합니다.This method uses the STOR command to upload an FTP resource. HTTP 리소스를 POST 메서드를 사용 합니다.For an HTTP resource, the POST method is used.

참고

애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다.This member outputs trace information when you enable network tracing in your application. 자세한 내용은 .NET Framework의 네트워크 추적합니다.For more information, see Network Tracing in the .NET Framework.

보안

FileIOPermission
로컬 파일에 액세스할 수to access the local file. 연관된 열거형: ReadAssociated enumeration: Read.

적용 대상