FtpWebRequest.ContentOffset 속성

정의

네임스페이스:

System.Net

어셈블리:

System.Net.Requests.dll

Source:

FtpWebRequest.cs

이 요청으로 다운로드할 파일의 바이트 오프셋을 가져오거나 설정합니다.

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

파일 오프셋을 바이트 단위로 지정하는 Int64 인스턴스입니다. 기본값은 영입니다.

예외

InvalidOperationException

이미 진행 중인 요청의 이 속성에 새 값이 지정된 경우

ArgumentOutOfRangeException

이 속성에 지정된 값이 0보다 작은 경우

예제

다음 코드 예제에서는 서버에서 파일의 일부를 다운로드하고 다운로드한 데이터를 로컬 파일에 추가하는 방법을 보여 줍니다.

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

설명

ContentOffset FTP 서버에서 파일을 다운로드할 때 속성을 설정합니다. 이 오프셋은 다운로드할 데이터의 시작을 표시하는 서버 파일의 위치를 나타냅니다. 오프셋은 파일의 시작부터 바이트 수로 지정됩니다. 첫 번째 바이트의 오프셋은 0입니다.

를 설정 ContentOffset 하면 가 FtpWebRequest 서버에 다시 시작(REST) 명령을 보냅니다. 이 명령은 서버에 데이터를 업로드하는 경우 대부분의 FTP 서버 구현에서 무시됩니다.

, , GetResponse또는 메서드를 호출한 GetRequestStream후 를 변경 ContentOffset 하면 예외가 발생합니다InvalidOperationException.BeginGetResponseBeginGetRequestStream

추가 정보

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