FtpWebRequest.ContentOffset Vlastnost

  • Reference

Definice

Obor názvů:
System.Net
Sestavení:
System.Net.Requests.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll
Zdroj:
FtpWebRequest.cs
Zdroj:
FtpWebRequest.cs
Zdroj:
FtpWebRequest.cs

Získá nebo nastaví posun bajtů do souboru staženého tímto požadavkem.

public:
 property long ContentOffset { long get(); void set(long value); };
public long ContentOffset { get; set; }
member this.ContentOffset : int64 with get, set
Public Property ContentOffset As Long

Hodnota vlastnosti

Int64

Instance Int64 , která určuje posun souboru v bajtech. Výchozí hodnota je nula.

Výjimky

InvalidOperationException

Byla zadána nová hodnota pro tuto vlastnost pro požadavek, který již probíhá.

ArgumentOutOfRangeException

Hodnota zadaná pro tuto vlastnost je menší než nula.

Příklady

Následující příklad kódu ukazuje stažení části souboru ze serveru a připojení stažených dat k místnímu souboru.

public:
   // NOT Working - throws a protocolError - 350 Restarting at 8. for args shown in Main.
   static bool RestartDownloadFromServer( String^ fileName, Uri^ serverUri, long offset )
   {
      // The serverUri parameter should use the ftp:// scheme.
      // It identifies the server file that is to be appended.
      // Example: ftp://contoso.com/someFile.txt.
      // 
      // The fileName parameter identifies the local file
      //
      // The offset parameter specifies where in the server file to start reading data.
      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::DownloadFile;
      request->ContentOffset = offset;
      FtpWebResponse^ response = nullptr;
      try
      {
         response = dynamic_cast<FtpWebResponse^>(request->GetResponse());
      }
      catch ( WebException^ e ) 
      {
         Console::WriteLine( e->Status );
         Console::WriteLine( e->Message );
         return false;
      }

      Stream^ newFile = response->GetResponseStream();
      StreamReader^ reader = gcnew StreamReader( newFile );

      // Display downloaded data.
      String^ newFileData = reader->ReadToEnd();

      // Append the response data to the local file
      // using a StreamWriter.
      StreamWriter^ writer = File::AppendText(fileName);
      writer->Write(newFileData);

     // Display the status description.

     // Cleanup.
     writer->Close();
     reader->Close();
     response->Close();
     // string fileString = System.Text.Encoding.UTF8.GetString(newFileData);
     // Console::WriteLine( sr );
     Console::WriteLine("Download restart - status: {0}",response->StatusDescription);
     return true;
   }

public static bool RestartDownloadFromServer(string fileName, Uri serverUri, long offset)
{
    // The serverUri parameter should use the ftp:// scheme.
    // It identifies the server file that is to be downloaded
    // Example: ftp://contoso.com/someFile.txt.

    // The fileName parameter identifies the local file.
    //The serverUri parameter identifies the remote file.
    // The offset parameter specifies where in the server file to start reading data.

    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.DownloadFile;
    request.ContentOffset = offset;
    FtpWebResponse response = null;
    try
    {
        response = (FtpWebResponse) request.GetResponse();
    }
    catch (WebException e)
    {
        Console.WriteLine (e.Status);
        Console.WriteLine (e.Message);
        return false;
    }
    // Get the data stream from the response.
    Stream newFile = response.GetResponseStream();
    // Use a StreamReader to simplify reading the response data.
    StreamReader reader  = new StreamReader(newFile);
    string newFileData = reader.ReadToEnd();
    // Append the response data to the local file
    // using a StreamWriter.
    StreamWriter writer = File.AppendText(fileName);
    writer.Write(newFileData);
    // Display the status description.

    // Cleanup.
    writer.Close();
    reader.Close();
    response.Close();
    Console.WriteLine("Download restart - status: {0}",response.StatusDescription);
    return true;
}

Poznámky

ContentOffset Nastavte vlastnost při stahování souboru ze serveru FTP. Tento posun označuje pozici v souboru serveru, která označuje začátek dat ke stažení. Posun je určen jako počet bajtů od začátku souboru; posun prvního bajtu je nula.

Nastavení ContentOffset způsobí, že FtpWebRequest příkaz pro restartování (REST) odešle na server. Tento příkaz je ignorován většinou implementací serveru FTP, pokud nahráváte data na server.

Změna ContentOffset po volání GetRequestStreammetody , BeginGetRequestStream, GetResponsenebo BeginGetResponse způsobí InvalidOperationException výjimku.

Platí pro

Viz také