WebClient.UploadFile Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Faz upload de um arquivo local para um recurso com o URI especificado.
Sobrecargas
| UploadFile(String, String) |
Carrega o arquivo local especificado para u recurso com o URI especificado. |
| UploadFile(Uri, String) |
Carrega o arquivo local especificado para u recurso com o URI especificado. |
| UploadFile(String, String, String) |
Carrega o arquivo local especificado no recurso especificado, usando o método especificado. |
| UploadFile(Uri, String, String) |
Carrega o arquivo local especificado no recurso especificado, usando o método especificado. |
UploadFile(String, String)
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
Carrega o arquivo local especificado para u recurso com o URI especificado.
public:
cli::array <System::Byte> ^ UploadFile(System::String ^ address, System::String ^ fileName);public byte[] UploadFile (string address, string fileName);member this.UploadFile : string * string -> byte[]Public Function UploadFile (address As String, fileName As String) As Byte()Parâmetros
- address
- String
O URI do recurso que receberá o arquivo. Por exemplo, ftp://localhost/samplefile.txt.
- fileName
- String
O arquivo a ser enviado para o recurso. Por exemplo, "samplefile.txt".
Retornos
Uma matriz Byte que contém o corpo da resposta do recurso.
Exceções
O URI formado pela combinação de BaseAddress e address é inválido.
- ou -
fileName é null, é Empty, contém caracteres inválidos ou não existe.
- ou -
Ocorreu um erro ao carregar o arquivo.
- ou -
Não houve resposta do servidor que hospeda o recurso.
- ou -
O cabeçalho Content-type começa com multipart.
Exemplos
O exemplo de código a seguir carrega o arquivo especificado no URI especificado usando UploadFile. Qualquer resposta retornada pelo servidor é exibida no console.
Console::Write( "\nPlease enter the URI to post data to : " );
String^ uriString = Console::ReadLine();
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "\nPlease enter the fully qualified path of the file to be uploaded to the URI" );
String^ fileName = Console::ReadLine();
Console::WriteLine( "Uploading {0} to {1} ...", fileName, uriString );
// Upload the file to the URI.
// The 'UploadFile(uriString, fileName)' method implicitly uses HTTP POST method.
array<Byte>^responseArray = myWebClient->UploadFile( uriString, fileName );
// Decode and display the response.
Console::WriteLine( "\nResponse Received::The contents of the file uploaded are: \n {0}",
System::Text::Encoding::ASCII->GetString( responseArray ) );
Console.Write("\nPlease enter the URI to post data to : ");
String uriString = Console.ReadLine();
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
Console.WriteLine("\nPlease enter the fully qualified path of the file to be uploaded to the URI");
string fileName = Console.ReadLine();
Console.WriteLine("Uploading {0} to {1} ...",fileName,uriString);
// Upload the file to the URI.
// The 'UploadFile(uriString,fileName)' method implicitly uses HTTP POST method.
byte[] responseArray = myWebClient.UploadFile(uriString,fileName);
// Decode and display the response.
Console.WriteLine("\nResponse Received. The contents of the file uploaded are:\n{0}",
System.Text.Encoding.ASCII.GetString(responseArray));
Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
Dim uriString As String = Console.ReadLine()
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
Console.WriteLine(ControlChars.Cr & _
"Please enter the fully qualified path of the file to be uploaded to the URI")
Dim fileName As String = Console.ReadLine()
Console.WriteLine("Uploading {0} to {1} ...", fileName, uriString)
' Upload the file to the URI.
' The 'UploadFile(uriString,fileName)' method implicitly uses HTTP POST method.
Dim responseArray As Byte() = myWebClient.UploadFile(uriString, fileName)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr & "Response Received. The contents of the file uploaded are: " & _
ControlChars.Cr & "{0}", System.Text.Encoding.ASCII.GetString(responseArray))
O exemplo de código a seguir mostra uma página ASP.NET que pode aceitar arquivos postados e é adequada para uso com o UploadFile método . A página deve residir em um servidor Web. Seu endereço fornece o valor para o address parâmetro do UploadFile método .
<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>
<Script language="C#" runat=server>
void Page_Load(object sender, EventArgs e) {
foreach(string f in Request.Files.AllKeys) {
HttpPostedFile file = Request.Files[f];
file.SaveAs("c:\\inetpub\\test\\UploadedFiles\\" + file.FileName);
}
}
</Script>
<html>
<body>
<p> Upload complete. </p>
</body>
</html>
<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>
<Script language="VB" runat=server>
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
Dim f As String
Dim file
For Each f In Request.Files.AllKeys
file = Request.Files(f)
file.SaveAs("c:\inetpub\test\UploadedFiles\" & file.FileName)
Next f
End Sub
</Script>
<html>
<body>
<p> Upload complete. </p>
</body>
</html>
Comentários
O UploadFile método envia um arquivo local para um recurso. Esse método usa o comando STOR para carregar um recurso FTP. Para um recurso HTTP, o método POST é usado.
Esse método bloqueia ao carregar o arquivo. Para continuar a execução enquanto aguarda a resposta do servidor, use um dos UploadFileAsync métodos .
O POST método é definido por HTTP. Se a solicitação subjacente não usar HTTP e POST não for compreendida pelo servidor, as classes de protocolo subjacentes determinarão o que ocorre. Normalmente, um WebException é gerado com a Status propriedade definida para indicar o erro.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede em .NET Framework.
Aplica-se a
UploadFile(Uri, String)
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
Carrega o arquivo local especificado para u recurso com o URI especificado.
public:
cli::array <System::Byte> ^ UploadFile(Uri ^ address, System::String ^ fileName);public byte[] UploadFile (Uri address, string fileName);member this.UploadFile : Uri * string -> byte[]Public Function UploadFile (address As Uri, fileName As String) As Byte()Parâmetros
- address
- Uri
O URI do recurso que receberá o arquivo. Por exemplo, ftp://localhost/samplefile.txt.
- fileName
- String
O arquivo a ser enviado para o recurso. Por exemplo, "samplefile.txt".
Retornos
Uma matriz Byte que contém o corpo da resposta do recurso.
Exceções
O URI formado pela combinação de BaseAddress e address é inválido.
- ou -
fileName é null, é Empty, contém caracteres inválidos ou não existe.
- ou -
Ocorreu um erro ao carregar o arquivo.
- ou -
Não houve resposta do servidor que hospeda o recurso.
- ou -
O cabeçalho Content-type começa com multipart.
Comentários
O UploadFile método envia um arquivo local para um recurso. Esse método usa o comando STOR para carregar um recurso FTP. Para um recurso HTTP, o método POST é usado.
Esse método bloqueia ao carregar o arquivo. Para continuar a execução enquanto aguarda a resposta do servidor, use um dos UploadFileAsync métodos .
O POST método é definido por HTTP. Se a solicitação subjacente não usar HTTP e POST não for compreendida pelo servidor, as classes de protocolo subjacentes determinarão o que ocorre. Normalmente, um WebException é gerado com a Status propriedade definida para indicar o erro.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede em .NET Framework.
Aplica-se a
UploadFile(String, String, String)
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
Carrega o arquivo local especificado no recurso especificado, usando o método especificado.
public:
cli::array <System::Byte> ^ UploadFile(System::String ^ address, System::String ^ method, System::String ^ fileName);public byte[] UploadFile (string address, string? method, string fileName);public byte[] UploadFile (string address, string method, string fileName);member this.UploadFile : string * string * string -> byte[]Public Function UploadFile (address As String, method As String, fileName As String) As Byte()Parâmetros
- address
- String
O URI do recurso que receberá o arquivo.
- method
- String
O método usado para enviar o arquivo para o recurso. Se for null, o padrão será POST para http e STOR para ftp.
- fileName
- String
O arquivo a ser enviado para o recurso.
Retornos
Uma matriz Byte que contém o corpo da resposta do recurso.
Exceções
O URI formado pela combinação de BaseAddress e address é inválido.
- ou -
fileName é null, é Empty, contém caracteres inválidos ou não existe.
- ou -
Ocorreu um erro ao carregar o arquivo.
- ou -
Não houve resposta do servidor que hospeda o recurso.
- ou -
O cabeçalho Content-type começa com multipart.
Exemplos
O exemplo de código a seguir carrega o arquivo especificado no URI especificado usando UploadFile. Qualquer resposta retornada pelo servidor é exibida no console.
Console::Write( "\nPlease enter the URL to post data to : " );
String^ uriString = Console::ReadLine();
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine
("\nPlease enter the fully qualified path of the file to be uploaded to the URL" );
String^ fileName = Console::ReadLine();
Console::WriteLine( "Uploading {0} to {1} ...", fileName, uriString );
// Upload the file to the URL using the HTTP 1.0 POST.
array<Byte>^responseArray = myWebClient->UploadFile( uriString, "POST", fileName );
// Decode and display the response.
Console::WriteLine( "\nResponse Received::The contents of the file uploaded are: \n {0}",
System::Text::Encoding::ASCII->GetString( responseArray ));
Console.Write("\nPlease enter the URL to post data to : ");
String uriString = Console.ReadLine();
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
Console.WriteLine("\nPlease enter the fully qualified path of the file to be uploaded to the URL");
string fileName = Console.ReadLine();
Console.WriteLine("Uploading {0} to {1} ...",fileName,uriString);
// Upload the file to the URL using the HTTP 1.0 POST.
byte[] responseArray = myWebClient.UploadFile(uriString,"POST",fileName);
// Decode and display the response.
Console.WriteLine("\nResponse Received. The contents of the file uploaded are:\n{0}",
System.Text.Encoding.ASCII.GetString(responseArray));
Console.Write(ControlChars.Cr + "Please enter the URL to post data to : ")
Dim uriString As String = Console.ReadLine()
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
Console.WriteLine(ControlChars.Cr & _
"Please enter the fully qualified path of the file to be uploaded to the URL")
Dim fileName As String = Console.ReadLine()
Console.WriteLine("Uploading {0} to {1} ...", fileName, uriString)
' Upload the file to the Url using the HTTP 1.0 POST.
Dim responseArray As Byte() = myWebClient.UploadFile(uriString, "POST", fileName)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response Received. The contents of the file uploaded are: " & _
ControlChars.Cr & "{0}", System.Text.Encoding.ASCII.GetString(responseArray))
O exemplo de código a seguir mostra uma página ASP.NET que pode aceitar arquivos postados e é adequada para uso com o UploadFile método . A página deve residir em um servidor Web. Seu endereço fornece o valor para o address parâmetro do UploadFile método .
<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>
<Script language="C#" runat=server>
void Page_Load(object sender, EventArgs e) {
foreach(string f in Request.Files.AllKeys) {
HttpPostedFile file = Request.Files[f];
file.SaveAs("c:\\inetpub\\test\\UploadedFiles\\" + file.FileName);
}
}
</Script>
<html>
<body>
<p> Upload complete. </p>
</body>
</html>
<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>
<Script language="VB" runat=server>
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
Dim f As String
Dim file
For Each f In Request.Files.AllKeys
file = Request.Files(f)
file.SaveAs("c:\inetpub\test\UploadedFiles\" & file.FileName)
Next f
End Sub
</Script>
<html>
<body>
<p> Upload complete. </p>
</body>
</html>
Comentários
Quando address especifica um recurso HTTP, o UploadFile método envia um arquivo local para um recurso usando o método HTTP especificado no method parâmetro e retorna qualquer resposta do servidor. Esse método bloqueia ao carregar o arquivo. Para continuar a execução enquanto aguarda a resposta do servidor, use um dos UploadFileAsync métodos .
Se o method parâmetro especificar um verbo que não é compreendido pelo servidor ou pelo address recurso, as classes de protocolo subjacentes determinarão o que ocorre. Normalmente, um WebException é gerado com a Status propriedade definida para indicar o erro.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede em .NET Framework.
Aplica-se a
UploadFile(Uri, String, String)
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
Carrega o arquivo local especificado no recurso especificado, usando o método especificado.
public:
cli::array <System::Byte> ^ UploadFile(Uri ^ address, System::String ^ method, System::String ^ fileName);public byte[] UploadFile (Uri address, string? method, string fileName);public byte[] UploadFile (Uri address, string method, string fileName);member this.UploadFile : Uri * string * string -> byte[]Public Function UploadFile (address As Uri, method As String, fileName As String) As Byte()Parâmetros
- address
- Uri
O URI do recurso que receberá o arquivo.
- method
- String
O método usado para enviar o arquivo para o recurso. Se for null, o padrão será POST para http e STOR para ftp.
- fileName
- String
O arquivo a ser enviado para o recurso.
Retornos
Uma matriz Byte que contém o corpo da resposta do recurso.
Exceções
O URI formado pela combinação de BaseAddress e address é inválido.
- ou -
fileName é null, é Empty, contém caracteres inválidos ou não existe.
- ou -
Ocorreu um erro ao carregar o arquivo.
- ou -
Não houve resposta do servidor que hospeda o recurso.
- ou -
O cabeçalho Content-type começa com multipart.
Comentários
Quando address especifica um recurso HTTP, o UploadFile método envia um arquivo local para um recurso usando o método HTTP especificado no method parâmetro e retorna qualquer resposta do servidor. Esse método bloqueia ao carregar o arquivo. Para continuar a execução enquanto aguarda a resposta do servidor, use um dos UploadFileAsync métodos .
Se o method parâmetro especificar um verbo que não é compreendido pelo servidor ou pelo address recurso, as classes de protocolo subjacentes determinarão o que ocorre. Normalmente, um WebException é gerado com a Status propriedade definida para indicar o erro.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede em .NET Framework.
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de