WebClient.UploadData 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 buffer de dados para um recurso com o URI especificado.
Sobrecargas
| UploadData(String, Byte[]) |
Carrega um buffer de dados em um recurso identificado por um URI. |
| UploadData(Uri, Byte[]) |
Carrega um buffer de dados em um recurso identificado por um URI. |
| UploadData(String, String, Byte[]) |
Carrega um buffer de dados no recurso especificado, usando o método especificado. |
| UploadData(Uri, String, Byte[]) |
Carrega um buffer de dados no recurso especificado, usando o método especificado. |
UploadData(String, Byte[])
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
Carrega um buffer de dados em um recurso identificado por um URI.
public:
cli::array <System::Byte> ^ UploadData(System::String ^ address, cli::array <System::Byte> ^ data);public byte[] UploadData (string address, byte[] data);member this.UploadData : string * byte[] -> byte[]Public Function UploadData (address As String, data As Byte()) As Byte()Parâmetros
- address
- String
O URI do recurso para receber os dados.
- data
- Byte[]
O buffer de dados a ser enviado para o recurso.
Retornos
Uma matriz Byte que contém o corpo da resposta do recurso.
Exceções
O parâmetro address é null.
O URI formado pela combinação de BaseAddress e address é inválido.
- ou -
data é null.
- ou -
Erro ao enviar os dados.
- ou -
Não houve resposta do servidor que hospeda o recurso.
Exemplos
O exemplo de código a seguir converte uma cadeia de caracteres inserida do console em uma Byte matriz e posta a matriz no servidor especificado usando UploadData. Qualquer resposta do 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 data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply ASCII Encoding to obtain the String* as a Byte array.
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );
Console::WriteLine( "Uploading to {0} ...", uriString );
myWebClient->Headers->Add( "Content-Type", "application/x-www-form-urlencoded" );
//UploadData implicitly sets HTTP POST as the request method.
array<Byte>^responseArray = myWebClient->UploadData( uriString, postArray );
// Decode and display the response.
Console::WriteLine( "\nResponse received was: {0}", 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 data to be posted to the URI {0}:",uriString);
string postData = Console.ReadLine();
// Apply ASCII Encoding to obtain the string as a byte array.
byte[] postArray = Encoding.ASCII.GetBytes(postData);
Console.WriteLine("Uploading to {0} ...", uriString);
myWebClient.Headers.Add("Content-Type","application/x-www-form-urlencoded");
//UploadData implicitly sets HTTP POST as the request method.
byte[] responseArray = myWebClient.UploadData(uriString,postArray);
// Decode and display the response.
Console.WriteLine("\nResponse received was :{0}", 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 data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
' Apply ASCII Encoding to obtain the string as a byte array.
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)
Console.WriteLine("Uploading to {0} ...", uriString)
myWebClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded")
' UploadData implicitly sets HTTP POST as the request method.
Dim responseArray As Byte() = myWebClient.UploadData(uriString, postArray)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :{0}", Encoding.ASCII.GetString(responseArray))
Comentários
O UploadData método envia um buffer de dados para um recurso.
Esse método usa o comando STOR para carregar um recurso FTP. Para um recurso HTTP, o método POST é usado. Se a solicitação subjacente 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.
O UploadData método envia o conteúdo de data para o servidor sem codificar. Esse método bloqueia ao carregar os dados. Para continuar a execução enquanto aguarda a resposta do servidor, use um dos UploadDataAsync métodos .
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
UploadData(Uri, Byte[])
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
Carrega um buffer de dados em um recurso identificado por um URI.
public:
cli::array <System::Byte> ^ UploadData(Uri ^ address, cli::array <System::Byte> ^ data);public byte[] UploadData (Uri address, byte[] data);member this.UploadData : Uri * byte[] -> byte[]Public Function UploadData (address As Uri, data As Byte()) As Byte()Parâmetros
- address
- Uri
O URI do recurso para receber os dados.
- data
- Byte[]
O buffer de dados a ser enviado para o recurso.
Retornos
Uma matriz Byte que contém o corpo da resposta do recurso.
Exceções
O parâmetro address é null.
O URI formado pela combinação de BaseAddress e address é inválido.
- ou -
data é null.
- ou -
Erro ao enviar os dados.
- ou -
Não houve resposta do servidor que hospeda o recurso.
Comentários
O UploadData método envia um buffer de dados para um recurso.
Esse método usa o comando STOR para carregar um recurso FTP. Para um recurso HTTP, o método POST é usado. Se a solicitação subjacente 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.
O UploadData método envia o conteúdo de data para o servidor sem codificar. Esse método bloqueia ao carregar os dados. Para continuar a execução enquanto aguarda a resposta do servidor, use um dos UploadDataAsync métodos .
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
UploadData(String, String, Byte[])
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
Carrega um buffer de dados no recurso especificado, usando o método especificado.
public:
cli::array <System::Byte> ^ UploadData(System::String ^ address, System::String ^ method, cli::array <System::Byte> ^ data);public byte[] UploadData (string address, string? method, byte[] data);public byte[] UploadData (string address, string method, byte[] data);member this.UploadData : string * string * byte[] -> byte[]Public Function UploadData (address As String, method As String, data As Byte()) As Byte()Parâmetros
- address
- String
O URI do recurso para receber os dados.
- method
- String
O método HTTP usado para enviar os dados para o recurso. Se for nulo, o padrão será POST para http e STOR para ftp.
- data
- Byte[]
O buffer de dados a ser enviado para o recurso.
Retornos
Uma matriz Byte que contém o corpo da resposta do recurso.
Exceções
O parâmetro address é null.
O URI formado pela combinação de BaseAddress e address é inválido.
- ou -
data é null.
- ou -
Erro ao carregar o arquivo.
- ou -
Não houve resposta do servidor que hospeda o recurso.
Exemplos
O exemplo de código a seguir converte uma cadeia de caracteres inserida do console em uma matriz de bytes e posta a matriz no servidor especificado usando UploadData. Qualquer resposta do servidor é exibida no console.
String^ uriString;
Console::Write( "\nPlease enter the URI to post data to {for example, http://www.contoso.com}: " );
uriString = Console::ReadLine();
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
myWebClient->Headers->Add( "Content-Type", "application/x-www-form-urlencoded" );
// Displays the headers in the request
Console::Write( "Resulting Request Headers: ");
Console::WriteLine(myWebClient->Headers);
// Apply ASCII Encoding to obtain the String^ as a Byte array.
array<Byte>^ byteArray = Encoding::ASCII->GetBytes( postData );
Console::WriteLine( "Uploading to {0} ...", uriString );
// Upload the input String* using the HTTP 1.0 POST method.
array<Byte>^responseArray = myWebClient->UploadData( uriString, "POST", byteArray );
// Decode and display the response.
Console::WriteLine( "\nResponse received was {0}",
Encoding::ASCII->GetString( responseArray ) );
string uriString;
Console.Write("\nPlease enter the URI to post data to {for example, http://www.contoso.com} : ");
uriString = Console.ReadLine();
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
string postData = Console.ReadLine();
myWebClient.Headers.Add("Content-Type","application/x-www-form-urlencoded");
// Display the headers in the request
Console.Write("Resulting Request Headers: ");
Console.WriteLine(myWebClient.Headers.ToString());
// Apply ASCII Encoding to obtain the string as a byte array.
byte[] byteArray = Encoding.ASCII.GetBytes(postData);
Console.WriteLine("Uploading to {0} ...", uriString);
// Upload the input string using the HTTP 1.0 POST method.
byte[] responseArray = myWebClient.UploadData(uriString,"POST",byteArray);
// Decode and display the response.
Console.WriteLine("\nResponse received was {0}",
Encoding.ASCII.GetString(responseArray));
Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to{for example, http://www.contoso.com} : ")
uriString = Console.ReadLine()
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
myWebClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded")
' Display the headers in the request
Console.Write("Resulting Request Headers: ")
Console.Writeline(myWebClient.Headers.ToString())
' Apply ASCII Encoding to obtain the string as a byte array.
Dim byteArray As Byte() = Encoding.ASCII.GetBytes(postData)
Console.WriteLine("Uploading to {0} ...", uriString)
' Upload the input string using the HTTP 1.0 POST method.
Dim responseArray As Byte() = myWebClient.UploadData(uriString, "POST", byteArray)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :{0}", Encoding.ASCII.GetString(responseArray))
Comentários
O UploadData método envia um buffer de dados 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 os dados. Para continuar a execução enquanto aguarda a resposta do servidor, use um dos UploadDataAsync métodos .
O UploadData método envia o conteúdo de data para o servidor sem codificar.
Se o method parâmetro especificar um verbo que não é compreendido 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
UploadData(Uri, String, Byte[])
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
Carrega um buffer de dados no recurso especificado, usando o método especificado.
public:
cli::array <System::Byte> ^ UploadData(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);public byte[] UploadData (Uri address, string? method, byte[] data);public byte[] UploadData (Uri address, string method, byte[] data);member this.UploadData : Uri * string * byte[] -> byte[]Public Function UploadData (address As Uri, method As String, data As Byte()) As Byte()Parâmetros
- address
- Uri
O URI do recurso para receber os dados.
- method
- String
O método HTTP usado para enviar os dados para o recurso. Se for nulo, o padrão será POST para http e STOR para ftp.
- data
- Byte[]
O buffer de dados a ser enviado para o recurso.
Retornos
Uma matriz Byte que contém o corpo da resposta do recurso.
Exceções
O parâmetro address é null.
O URI formado pela combinação de BaseAddress e address é inválido.
- ou -
data é null.
- ou -
Erro ao carregar o arquivo.
- ou -
Não houve resposta do servidor que hospeda o recurso.
Comentários
O UploadData método envia um buffer de dados 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 os dados. Para continuar a execução enquanto aguarda a resposta do servidor, use um dos UploadDataAsync métodos .
O UploadData método envia o conteúdo de data para o servidor sem codificar.
Se o method parâmetro especificar um verbo que não é compreendido 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
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