FtpWebResponse.ContentLength Propriedade

Definição

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

Obtém o comprimento dos dados recebidos do servidor FTP.

public:
 virtual property long ContentLength { long get(); };
public override long ContentLength { get; }
member this.ContentLength : int64
Public Overrides ReadOnly Property ContentLength As Long

Valor de Propriedade

Int64

Um Int64 valor que contém o número de bytes de dados recebidos do servidor FTP.

Exemplos

O exemplo de código seguinte descarrega um ficheiro do servidor FTP especificado. Esta propriedade contém o número de bytes no ficheiro descarregado.

public static bool DownloadFileFromServer(Uri serverUri, string localFileName)
{
    // The serverUri parameter should start with the ftp:// scheme.
    if (serverUri.Scheme != Uri.UriSchemeFtp)
    {
        return false;
    }
    // Get the object used to communicate with the server.
    // Note that the cast to FtpWebRequest is done only
    // for the purposes of illustration. If your application
    // does not set any properties other than those defined in the
    // System.Net.WebRequest class, you can use the following line instead:
    // WebRequest request = WebRequest.Create(serverUri);
    //
    FtpWebRequest request = (FtpWebRequest)WebRequest.Create(serverUri);
    request.Method = WebRequestMethods.Ftp.DownloadFile;

    FtpWebResponse response = (FtpWebResponse) request.GetResponse();

    Stream responseStream = null;
    StreamReader readStream = null;
    StreamWriter writeStream = null;
    try
    {
        responseStream = response.GetResponseStream();
        readStream = new StreamReader(responseStream, System.Text.Encoding.UTF8);
        // Display information about the data received from the server.
        Console.WriteLine("Bytes received: {0}",response.ContentLength);

        Console.WriteLine("Message from server: {0}", response.StatusDescription);
        Console.WriteLine("Resource: {0}", response.ResponseUri);

        // Write the bytes received from the server to the local file.
        if (readStream != null)
        {
            writeStream = new StreamWriter(localFileName, false);
            writeStream.Write(readStream.ReadToEnd());
        }
    }
    finally
    {
        if (readStream != null)
        {
            readStream.Close();
        }
        if (response != null)
        {
            response.Close();
        }
        if (writeStream != null)
        {
            writeStream.Close();
        }
    }
    return true;
}

Observações

Quando um fluxo de resposta é devolvido pelo servidor FTP, a ContentLength propriedade contém o número de bytes no fluxo. ContentLength devolve −1 se não forem devolvidos dados na resposta ou se o servidor não enviou informação sobre o comprimento do conteúdo. O valor de retorno é maior ou igual a zero se os dados foram ou deveriam ter sido devolvidos. Por exemplo, para pedidos que utilizam o ListDirectory campo, a ContentLength propriedade devolve sempre −1. Para pedidos que utilizam o UploadFile método, a ContentLength propriedade é sempre zero. Para pedidos que utilizam o DownloadFile método, a propriedade é maior que zero se o ficheiro descarregado contiver dados e é zero se estiver vazio.

Para pedidos que utilizam o GetFileSize método, ContentLength devolve o tamanho do ficheiro especificado no servidor.

Aplica-se a

Ver também