FtpWebRequest.GetRequestStream Método

Referência

Definição

Namespace:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Origem:: FtpWebRequest.cs

Origem:: FtpWebRequest.cs

Origem:: FtpWebRequest.cs

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.

Recupera o fluxo usado para carregar dados para um servidor FTP.

public:
 override System::IO::Stream ^ GetRequestStream();

public override System.IO.Stream GetRequestStream ();

override this.GetRequestStream : unit -> System.IO.Stream

Public Overrides Function GetRequestStream () As Stream

Retornos

Stream

Uma instância Stream gravável usada para armazenar dados a serem enviados para o servidor pela solicitação atual.

Exceções

InvalidOperationException

BeginGetRequestStream(AsyncCallback, Object) foi chamado e não foi concluído.

- ou -

Um proxy HTTP está habilitado e você tentou usar um comando FTP diferente de DownloadFile, ListDirectory ou ListDirectoryDetails.

WebException

Não foi possível estabelecer uma conexão com o servidor FTP.

ProtocolViolationException

A propriedade Method não foi definida como UploadFile ou AppendFile.

Exemplos

O exemplo de código a seguir demonstra como copiar um arquivo para o fluxo de dados de uma solicitação e enviar uma solicitação ao servidor para carregar os dados e acrescentá-los a um arquivo.

static bool AppendFileOnServer( String^ fileName, Uri^ serverUri )
{
   // The URI described by serverUri should use the ftp:// scheme.
   // It contains the name of the file on the server.
   // Example: ftp://contoso.com/someFile.txt. 
   // The fileName parameter identifies the file containing 
   // the data to be appended to the file on the server.
   if ( serverUri->Scheme != Uri::UriSchemeFtp )
   {
      return false;
   }

   // Get the object used to communicate with the server.
   FtpWebRequest^ request = dynamic_cast<FtpWebRequest^>(WebRequest::Create( serverUri ));
   request->Method = WebRequestMethods::Ftp::AppendFile;
   StreamReader^ sourceStream = gcnew StreamReader( fileName );
   array<Byte>^fileContents = Encoding::UTF8->GetBytes( sourceStream->ReadToEnd() );
   sourceStream->Close();
   request->ContentLength = fileContents->Length;

   // This example assumes the FTP site uses anonymous logon.
   request->Credentials = gcnew NetworkCredential( "anonymous","janeDoe@contoso.com" );
   Stream^ requestStream = request->GetRequestStream();
   requestStream->Write( fileContents, 0, fileContents->Length );
   requestStream->Close();
   FtpWebResponse^ response = dynamic_cast<FtpWebResponse^>(request->GetResponse());
   Console::WriteLine( "Append status: {0}", response->StatusDescription );
   response->Close();
   return true;
}

public static bool AppendFileOnServer(string fileName, Uri serverUri)
{
    // The URI described by serverUri should use the ftp:// scheme.
    // It contains the name of the file on the server.
    // Example: ftp://contoso.com/someFile.txt.
    // The fileName parameter identifies the file containing
    // the data to be appended to the file on the server.

    if (serverUri.Scheme != Uri.UriSchemeFtp)
    {
        return false;
    }
    // Get the object used to communicate with the server.
    FtpWebRequest request = (FtpWebRequest)WebRequest.Create(serverUri);
    request.Method = WebRequestMethods.Ftp.AppendFile;

    StreamReader sourceStream = new StreamReader(fileName);
    byte [] fileContents = Encoding.UTF8.GetBytes(sourceStream.ReadToEnd());
    sourceStream.Close();
    request.ContentLength = fileContents.Length;

    // This example assumes the FTP site uses anonymous logon.
    request.Credentials = new NetworkCredential ("anonymous","janeDoe@contoso.com");
    Stream requestStream = request.GetRequestStream();
    requestStream.Write(fileContents, 0, fileContents.Length);
    requestStream.Close();
    FtpWebResponse response = (FtpWebResponse) request.GetResponse();

    Console.WriteLine("Append status: {0}",response.StatusDescription);

    response.Close();
    return true;
}

Comentários

Defina as propriedades da solicitação antes de chamar o GetRequestStream método . Depois de gravar os dados no fluxo, você deve fechar o fluxo antes de enviar a solicitação.

Se você não tiver definido a Method propriedade como UploadFile ou AppendFile, não poderá obter o fluxo.

GetRequestStream bloqueia enquanto aguarda o fluxo. Para evitar isso, chame o BeginGetRequestStream método no lugar de GetRequestStream.

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 no .NET Framework.

Notas aos Chamadores

Esse método gera tráfego de rede.

Aplica-se a

Partilhar via