FtpWebRequest.ContentOffset Свойство

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

Значение свойства

Экземпляр, указывающий Int64 смещение файла в байтах. Значение по умолчанию равно нулю.

Исключения

Примеры

В следующем примере кода демонстрируется скачивание части файла с сервера и добавление загруженных данных в локальный файл.

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

Комментарии

Задайте свойство при скачивании ContentOffset файла с FTP-сервера. Это смещение указывает положение в файле сервера, которое отмечает начало загрузки данных. Смещение указывается как число байтов с начала файла; смещение первого байта равно нулю.

Параметр ContentOffset приводит FtpWebRequest к отправке команды перезапуска (REST) на сервер. Эта команда игнорируется большинством реализаций FTP-сервера, если вы отправляете данные на сервер.

Изменение ContentOffset после вызова методов GetRequestStream, BeginGetRequestStream, GetResponse или BeginGetResponse вызывает исключение InvalidOperationException.

См. также раздел

• FtpWebResponse
• FtpStatusCode
• WebRequestMethods.Ftp
• WebRequest
• WebResponse
• WebClient