FtpWebRequest.ContentOffset Propriedade
Definição
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.
Obtém ou define um deslocamento de bytes no arquivo que está sendo baixado por essa solicitação.
public:
property long ContentOffset { long get(); void set(long value); };public long ContentOffset { get; set; }member this.ContentOffset : int64 with get, setPublic Property ContentOffset As LongValor da propriedade
Uma instância de Int64 que especifica o deslocamento do arquivo, em bytes. O valor padrão é zero.
Exceções
Um novo valor foi especificado para essa propriedade referente a uma solicitação já em andamento.
O valor especificado para essa propriedade é menor que zero.
Exemplos
O exemplo de código a seguir demonstra como baixar parte de um arquivo de um servidor e acrescentar os dados baixados a um arquivo 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;
}
Comentários
Defina a ContentOffset propriedade ao baixar um arquivo de um servidor FTP. Esse deslocamento indica a posição no arquivo do servidor que marca o início dos dados a serem baixados. O deslocamento é especificado como o número de bytes desde o início do arquivo; o deslocamento do primeiro byte é zero.
A configuração ContentOffset faz com que o FtpWebRequest envie um comando de reinicialização (REST) para o servidor. Esse comando será ignorado pela maioria das implementações do servidor FTP se você estiver carregando dados no servidor.
Alterar ContentOffset depois de chamar o GetRequestStreammétodo , BeginGetRequestStreamGetResponse, ou BeginGetResponse causa uma exceçãoInvalidOperationException.
