FtpWebRequest.ContentOffset Propriedade

Definição

Espaço de Nomes:
System.Net
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Recebe ou define um desvio de byte no ficheiro que está a ser descarregado por este pedido.

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

Valor de Propriedade

Int64

Uma Int64 instância que especifica o deslocamento do ficheiro, em bytes. O valor padrão é zero.

Exceções

InvalidOperationException

Foi especificado um novo valor para esta propriedade para um pedido que já está em curso.

ArgumentOutOfRangeException

O valor especificado para esta propriedade é menor que zero.

Exemplos

O exemplo de código seguinte demonstra o download de parte de um ficheiro a partir de um servidor e a anexação dos dados descarregados a um ficheiro local.

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

Observações

Define a ContentOffset propriedade ao descarregar um ficheiro de um servidor FTP. Este deslocamento indica a posição no ficheiro do servidor que indica o início dos dados a serem descarregados. O deslocamento é especificado como o número de bytes a partir do início do ficheiro; o deslocamento do primeiro byte é zero.

A configuração ContentOffset faz com que FtpWebRequest envie um comando de reinício (REST) para o servidor. Este comando é ignorado pela maioria das implementações de servidores FTP se estiver a carregar dados para o servidor.

Alterar ContentOffset após chamar os métodos GetRequestStream, BeginGetRequestStream, GetResponse ou BeginGetResponse causa uma exceção InvalidOperationException.

Aplica-se a

Ver também