FtpWebRequest.GetRequestStream Methode

Definition

Ruft den Stream ab, der zum Hochladen von Daten auf einen FTP-Server verwendet wird.Retrieves the stream used to upload data to an FTP server.

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

Gibt zurück

Eine nicht schreibgeschützte Stream-Instanz, die zum Speichern von Daten verwendet wird, die durch die aktuelle Anforderung an den Server gesendet werden.A writable Stream instance used to store data to be sent to the server by the current request.

Ausnahmen

BeginGetRequestStream(AsyncCallback, Object) wurde aufgerufen und nicht abgeschlossen.BeginGetRequestStream(AsyncCallback, Object) has been called and has not completed.

Oder-or- Ein HTTP-Proxy ist aktiviert, und Sie haben versucht, einen anderen FTP-Befehl als DownloadFile, ListDirectory oder ListDirectoryDetails zu verwenden.An HTTP proxy is enabled, and you attempted to use an FTP command other than DownloadFile, ListDirectory, or ListDirectoryDetails.

Es konnte keine Verbindung mit dem FTP-Server hergestellt werden.A connection to the FTP server could not be established.

Die Method-Eigenschaft ist nicht auf UploadFile oder AppendFile festgelegt.The Method property is not set to UploadFile or AppendFile.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Datei in den Datenstrom einer Anforderung kopiert und eine Anforderung an den Server gesendet wird, um die Daten hochzuladen und an eine Datei anzufügen.The following code example demonstrates copying a file to a request's data stream and sending a request to the server to upload the data and append it to a file.

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

Hinweise

Legen Sie die Anforderungs Eigenschaften vor dem Aufrufen der GetRequestStream-Methode fest.Set the request properties before calling the GetRequestStream method. Nachdem Sie die Daten in den Stream geschrieben haben, müssen Sie den Stream vor dem Senden der Anforderung schließen.After writing the data to the stream, you must close the stream prior to sending the request.

Wenn Sie die Method-Eigenschaft nicht auf UploadFile oder AppendFilefestgelegt haben, können Sie den Stream nicht erhalten.If you have not set the Method property to UploadFile or AppendFile, you cannot get the stream.

GetRequestStream Blöcke beim Warten auf den Stream.GetRequestStream blocks while waiting for the stream. Um dies zu verhindern, müssen Sie die BeginGetRequestStream-Methode anstelle von GetRequestStreamaufzurufen.To prevent this, call the BeginGetRequestStream method in place of GetRequestStream.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerk Ablauf Verfolgung in der .NET Framework.For more information, see Network Tracing in the .NET Framework.

Hinweise für Aufrufer

Diese Methode generiert Netzwerk Datenverkehr.This method generates network traffic.

Gilt für:

Siehe auch