QFtp Class Reference · PyQt4 中文文檔

# QFtp Class Reference ## [[QtNetwork](index.htm) module] 該QFtp類提供FTP協議的客戶端的實現。[More...](#details) 繼承[QObject](qobject.html)。 ### Types * `enum Command { None_, SetTransferMode, SetProxy, ConnectToHost, ..., RawCommand }` * `enum Error { NoError, UnknownError, HostNotFound, ConnectionRefused, NotConnected }` * `enum State { Unconnected, HostLookup, Connecting, Connected, LoggedIn, Closing }` * `enum TransferMode { Active, Passive }` * `enum TransferType { Binary, Ascii }` ### Methods * `__init__ (self, QObject?parent?=?None)` * `abort (self)` * `int bytesAvailable (self)` * `int cd (self, QString?directory)` * `clearPendingCommands (self)` * `int close (self)` * `int connectToHost (self, QString?host, int?port?=?21)` * `Command currentCommand (self)` * `QIODevice currentDevice (self)` * `int currentId (self)` * `Error error (self)` * `QString errorString (self)` * `int get (self, QString?file, QIODevice?device?=?None, TransferType?type?=?QFtp.Binary)` * `bool hasPendingCommands (self)` * `int list (self, QString?directory?=?QString())` * `int login (self, QString?user?=?QString(), QString?password?=?QString())` * `int mkdir (self, QString?dir)` * `int put (self, QByteArray?data, QString?file, TransferType?type?=?QFtp.Binary)` * `int put (self, QIODevice?device, QString?file, TransferType?type?=?QFtp.Binary)` * `int rawCommand (self, QString?command)` * `str read (self, int?maxlen)` * `QByteArray readAll (self)` * `int remove (self, QString?file)` * `int rename (self, QString?oldname, QString?newname)` * `int rmdir (self, QString?dir)` * `int setProxy (self, QString?host, int?port)` * `int setTransferMode (self, TransferMode?mode)` * `State state (self)` ### Qt Signals * `void commandFinished (int,bool)` * `void commandStarted (int)` * `void dataTransferProgress (qint64,qint64)` * `void done (bool)` * `void listInfo (const QUrlInfo&)` * `void rawCommandReply (int,const QString&)` * `void readyRead ()` * `void stateChanged (int)` * * * ## Detailed Description 該QFtp類提供FTP協議的客戶端的實現。這個類提供了一個直接接口到FTP ，讓您擁有更多的控制權的要求。然而，對于新的應用程序，它是推薦使用[QNetworkAccessManager](qnetworkaccessmanager.html)和[QNetworkReply](qnetworkreply.html)作為這些類具有一個簡單，但更強大的API 。類以異步方式工作，所以沒有阻擋功能。如果操作不能被立即執行，該函數將仍然返回直線距離，操作將被安排在以后執行。調度操作的結果通過信號報告。這種方法依賴于事件循環運行之中。可以計劃的操作（它們在文檔其馀部分被稱為“命令” ）有以下幾種：[connectToHost](qftp.html#connectToHost)（）[login](qftp.html#login)（）[close](qftp.html#close)（）[list](qftp.html#list)（）[cd](qftp.html#cd)（）[get](qftp.html#get)（）[put](qftp.html#put)（）[remove](qftp.html#remove)（）[mkdir](qftp.html#mkdir)（）[rmdir](qftp.html#rmdir)（）[rename](qftp.html#rename)（）和[rawCommand](qftp.html#rawCommand)（）。所有這些命令都返回一個唯一的標識符，它允許你跟蹤當前正在執行的命令。當一個指令的執行開始時，[commandStarted](qftp.html#commandStarted)（）信號與命令的識別碼被發射。當命令完成后，[commandFinished](qftp.html#commandFinished)（）信號發出的命令的標識符和一個布爾值，表示該命令是否有錯誤完成。在某些情況下，您可能要執行的命令序列，例如：如果你想連接并登錄到FTP服務器。這是簡單的實現： ``` QFtp *ftp = new QFtp(parent); ftp->connectToHost("ftp.qt.nokia.com"); ftp->login(); ``` 在這種情況下，兩個FTP命令已排定。當最后一個調度命令已完成，一[done](qftp.html#done)（）信號被發射一個布爾參數，它告訴你的序列是否有錯誤完成。如果其中一個命令在命令序列的執行過程中發生了錯誤，所有掛起的命令（即預定的，但尚未執行的命令）被清零，并且沒有信號發射它們。一些命令，例如[list](qftp.html#list)（），發出額外的信號來報告他們的成果。例如：如果你想從Qt的FTP服務器上下載安裝文件，你會這樣寫： ``` ftp->connectToHost("ftp.qt.nokia.com"); // id == 1 ftp->login(); // id == 2 ftp->cd("qt"); // id == 3 ftp->get("INSTALL"); // id == 4 ftp->close(); // id == 5 ``` 在這個例子中的信號按以下順序發出（以小的變化，這取決于網絡的流量等）： ``` start(1) stateChanged(HostLookup) stateChanged(Connecting) stateChanged(Connected) finished(1, false) start(2) stateChanged(LoggedIn) finished(2, false) start(3) finished(3, false) start(4) dataTransferProgress(0, 3798) dataTransferProgress(2896, 3798) readyRead() dataTransferProgress(3798, 3798) readyRead() finished(4, false) start(5) stateChanged(Closing) stateChanged(Unconnected) finished(5, false) done(false) ``` 該[dataTransferProgress](qftp.html#dataTransferProgress)如果要顯示在上面的例子（）信號是有用的一[progress bar](qprogressbar.html)以通知用戶有關下載的進度。該[readyRead](qftp.html#readyRead)（）信號告訴你，有數據準備好讀。可被查詢的數據量，然后與[bytesAvailable](qftp.html#bytesAvailable)（）函數，它可以讀取與該[read](qftp.html#read)（）或[readAll](qftp.html#readAll)（）函數。如果登錄失敗對于上面的例子中，信號是這樣的： ``` start(1) stateChanged(HostLookup) stateChanged(Connecting) stateChanged(Connected) finished(1, false) start(2) finished(2, true) done(true) ``` 然后，您可以獲取與錯誤的詳細信息[error](qftp.html#error)（）和[errorString](qftp.html#errorString)（）函數。對于文件傳輸， QFtp可以同時使用主動或被動模式，并使用被動傳輸文件的默認模式，見文檔[setTransferMode](qftp.html#setTransferMode)（），以便了解更多的細節。 Call [setProxy](qftp.html#setProxy)（）使QFtp通過FTP代理服務器進行連接。該功能[currentId](qftp.html#currentId)（）和[currentCommand](qftp.html#currentCommand)（）提供有關當前正在執行的命令的詳細信息。該功能[hasPendingCommands](qftp.html#hasPendingCommands)（）和[clearPendingCommands](qftp.html#clearPendingCommands)（）允許您查詢和清除掛起的命令的列表。如果你是一個有經驗的網絡程序員，并希望有完全的控制，您可以使用[rawCommand](qftp.html#rawCommand)（）來執行任意FTP命令。 **Warning:**QFtp的當前版本不完全支持非Unix的FTP服務器。 * * * ## Type Documentation ``` QFtp.Command ``` 該枚舉被用作返回值[currentCommand](qftp.html#currentCommand)（）函數。這可以讓你執行特定命令的具體行動，例如：在FTP客戶端，你可能想清除的目錄視圖時，[list](qftp.html#list)如果在這種情況下，你可以簡單地檢查連接到啟動的插槽（）信號，（）命令啟動[currentCommand](qftp.html#currentCommand)（）是`List`。 | Constant | Value | Description | | --- | --- | --- | | `QFtp.None` | `0` | 正在執行任何命令。 | | `QFtp.SetTransferMode` | `1` | 設置[transfer](qftp.html#TransferMode-enum)模式。 | | `QFtp.SetProxy` | `2` | 打開或關閉代理。 | | `QFtp.ConnectToHost` | `3` | [connectToHost](qftp.html#connectToHost)（）被執行。 | | `QFtp.Login` | `4` | [login](qftp.html#login)（）被執行。 | | `QFtp.Close` | `5` | [close](qftp.html#close)（）被執行。 | | `QFtp.List` | `6` | [list](qftp.html#list)（）被執行。 | | `QFtp.Cd` | `7` | [cd](qftp.html#cd)（）被執行。 | | `QFtp.Get` | `8` | [get](qftp.html#get)（）被執行。 | | `QFtp.Put` | `9` | [put](qftp.html#put)（）被執行。 | | `QFtp.Remove` | `10` | [remove](qftp.html#remove)（）被執行。 | | `QFtp.Mkdir` | `11` | [mkdir](qftp.html#mkdir)（）被執行。 | | `QFtp.Rmdir` | `12` | [rmdir](qftp.html#rmdir)（）被執行。 | | `QFtp.Rename` | `13` | [rename](qftp.html#rename)（）被執行。 | | `QFtp.RawCommand` | `14` | [rawCommand](qftp.html#rawCommand)（）被執行。 | **See also** [currentCommand](qftp.html#currentCommand)（）。 ``` QFtp.Error ``` 這個枚舉標識所發生的錯誤。 | Constant | Value | Description | | --- | --- | --- | | `QFtp.NoError` | `0` | 未發生錯誤。 | | `QFtp.HostNotFound` | `2` | 該主機名查找失敗。 | | `QFtp.ConnectionRefused` | `3` | 服務器拒絕連接。 | | `QFtp.NotConnected` | `4` | 試圖發送一個命令，但有一個服務器的任何連接。 | | `QFtp.UnknownError` | `1` | 發生錯誤比上述指定的。 | **See also** [error](qftp.html#error)（）。 ``` QFtp.State ``` 這個枚舉變量定義的連接狀態： | Constant | Value | Description | | --- | --- | --- | | `QFtp.Unconnected` | `0` | 還有就是主機的連接。 | | `QFtp.HostLookup` | `1` | 主機名查找正在進行中。 | | `QFtp.Connecting` | `2` | 連接到主機的嘗試正在進行中。 | | `QFtp.Connected` | `3` | 到主機的連接已經完成。 | | `QFtp.LoggedIn` | `4` | 連接和用戶登錄已經實現。 | | `QFtp.Closing` | `5` | 連接被關閉了，但它尚未關閉。（該狀態將是`Unconnected`當連接關閉。） | **See also** [stateChanged](qftp.html#stateChanged)（）和[state](qftp.html#state)（）。 ``` QFtp.TransferMode ``` FTP使用兩種套接字連接，一個用于命令和另一個用于傳輸數據。而總是由客戶端發起命令連接，第二連接可以通過在客戶端或服務器來啟動。這個枚舉定義了客戶端（被動模式）或服務器（主動模式）是否應該建立數據連接。 | Constant | Value | Description | | --- | --- | --- | | `QFtp.Passive` | `1` | 客戶端連接到服務器傳送數據。 | | `QFtp.Active` | `0` | 該服務器連接到客戶端發送其數據。 | ``` QFtp.TransferType ``` 這個枚舉標識與get和put命令中使用的數據傳輸類型。 | Constant | Value | Description | | --- | --- | --- | | `QFtp.Binary` | `0` | 這些數據將被傳輸二進制模式。 | | `QFtp.Ascii` | `1` | 這些數據將被轉移在ASCII模式和新行字符將被轉換為本地格式。 | * * * ## Method Documentation ``` QFtp.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個[QFtp](qftp.html)與給定對象_parent_。 ``` QFtp.abort (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void abort()`。中止當前命令，并刪除所有已計劃的命令。如果有一個未完成的命令（即命令的量，[commandStarted](qftp.html#commandStarted)（）信號已被發射，但是該[commandFinished](qftp.html#commandFinished)（）信號沒有被發射的），該函數發送一個`ABORT`命令給服務器。當服務器回復該命令被中止，[commandFinished](qftp.html#commandFinished)（）的信號與`error`參數設置為`true`發出該命令。由于定時問題，有可能在命令已經完成之前中止請求到達服務器，在這種情況下，該[commandFinished](qftp.html#commandFinished)（）信號被發射的`error`參數設置為`false`。對于那些受中止（）其他所有的命令，沒有信號發射。如果你不開始進一步直接中止后FTP命令（），將不會有任何計劃的命令和[done](qftp.html#done)（）信號被發射。 **Warning:**有些FTP服務器，例如BSD的FTP守護程序（ 0.3版本），返回錯誤已經發生中止，即使一個肯定的答復。對于這些服務器的[commandFinished](qftp.html#commandFinished)（）信號有錯誤標志設置為`false`，即使命令沒有成功完成。 **See also** [clearPendingCommands](qftp.html#clearPendingCommands)（）。 ``` int QFtp.bytesAvailable (self) ``` 返回可從數據套接字中讀取的時刻的字節數。 **See also** [get](qftp.html#get)（）[readyRead](qftp.html#readyRead)（）[read](qftp.html#read)（）和[readAll](qftp.html#readAll)（）。 ``` int QFtp.cd (self, QString?directory) ``` 改變了服務器的工作目錄_dir_。該功能不會阻止，并立即返回。該命令是預定的，并且是異步執行的執行。該函數返回一個唯一的標識符，它是由通過[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。當命令開始[commandStarted](qftp.html#commandStarted)（）信號被發射。當它完成時的[commandFinished](qftp.html#commandFinished)（）信號被發射。 **See also** [commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。 ``` QFtp.clearPendingCommands (self) ``` 刪除所有掛起的命令從預定的命令列表。這并不會影響正在執行的命令。如果你想停止這一點，使用[abort](qftp.html#abort)（）。 **See also** [hasPendingCommands](qftp.html#hasPendingCommands)（）和[abort](qftp.html#abort)（）。 ``` int QFtp.close (self) ``` 關閉連接到FTP服務器。該[stateChanged](qftp.html#stateChanged)（）信號被發射時，在連接過程的狀態變化，例如至`Closing`，然后`Unconnected`。該功能不會阻止，并立即返回。該命令是預定的，并且是異步執行的執行。該函數返回一個唯一的標識符，它是由通過[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。當命令開始[commandStarted](qftp.html#commandStarted)（）信號被發射。當它完成時的[commandFinished](qftp.html#commandFinished)（）信號被發射。 **See also** [stateChanged](qftp.html#stateChanged)（）[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。 ``` int QFtp.connectToHost (self, QString?host, int?port?=?21) ``` 連接到FTP服務器_host_使用端口_port_。該[stateChanged](qftp.html#stateChanged)（）信號被發射時，在連接過程的狀態變化，例如至`HostLookup`，然后`Connecting`，然后`Connected`。該功能不會阻止，并立即返回。該命令是預定的，并且是異步執行的執行。該函數返回一個唯一的標識符，它是由通過[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。當命令開始[commandStarted](qftp.html#commandStarted)（）信號被發射。當它完成時的[commandFinished](qftp.html#commandFinished)（）信號被發射。 **See also** [stateChanged](qftp.html#stateChanged)（）[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。 ``` Command QFtp.currentCommand (self) ``` [ 返回FTP命令被執行的命令類型或`None`如果沒有命令被執行。 ](qftp.html#Command-enum) [**See also**](qftp.html#Command-enum) [currentId](qftp.html#currentId)（）。 ``` QIODevice QFtp.currentDevice (self) ``` [](qiodevice.html) [返回](qiodevice.html)[QIODevice](qiodevice.html)指針所使用的FTP命令來讀取數據或存儲數據。如果有正在執行無電流的FTP命令，或者如果命令不使用的IO設備，該函數返回0 。此功能可用于刪除的[QIODevice](qiodevice.html)在連接到插槽[commandFinished](qftp.html#commandFinished)（）信號。 **See also** [get](qftp.html#get)（）和[put](qftp.html#put)（）。 ``` int QFtp.currentId (self) ``` 返回正在執行FTP命令或標識符0 ，如果沒有命令被執行。 **See also** [currentCommand](qftp.html#currentCommand)（）。 ``` Error QFtp.error (self) ``` [](qftp.html#Error-enum) [返回所發生的最后一個錯誤。接收時，此功能非常有用，找出什么地方出了錯一](qftp.html#Error-enum)[commandFinished](qftp.html#commandFinished)（）或一[done](qftp.html#done)（）的信號與`error`參數設置為`true`。如果你開始一個新的命令，錯誤狀態重置為`NoError`。 ``` QString QFtp.errorString (self) ``` 返回上次發生錯誤的人類可讀的描述。接收時，這是用于呈現錯誤信息給用戶有用的一[commandFinished](qftp.html#commandFinished)（）或一[done](qftp.html#done)（）的信號與`error`參數設置為`true`。錯誤字符串通常是（但不總是）??從服務器的應答，因此它并不總是可能的翻譯的字符串。如果消息來自Qt中，字符串已通過[tr](qobject.html#tr)（）。 ``` int QFtp.get (self, QString?file, QIODevice?device?=?None, TransferType?type?=?QFtp.Binary) ``` 下載文件_file_從服務器。 If _dev_是0，則[readyRead](qftp.html#readyRead)當有數據可供讀取（）信號被發射。然后，您可以與讀取數據[read](qftp.html#read)（）或[readAll](qftp.html#readAll)（）函數。 If _dev_不為0時，數據被直接寫入設備_dev_。確保_dev_指針是有效的操作的持續時間（它是安全的刪除當[commandFinished](qftp.html#commandFinished)（）信號被發射）。在這種情況下[readyRead](qftp.html#readyRead)（）信號是_not_發出的，你不能與讀取數據[read](qftp.html#read)（）或[readAll](qftp.html#readAll)（）函數。如果不立即讀取數據變得可用，即當[readyRead](qftp.html#readyRead)（）信號被發射，它仍然是可用的，直到下一個指令開始。例如，如果你想盡快有一些可用的數據呈現給用戶，連接到[readyRead](qftp.html#readyRead)（）信號，并立即讀出的數據。在另一方面，如果只想用完整的數據來工作，你可以連接到[commandFinished](qftp.html#commandFinished)（）信號和讀取時的get （）命令完成的數據。這取決于價值的數據作為二進制或ASCII_type_。該功能不會阻止，并立即返回。該命令是預定的，并且是異步執行的執行。該函數返回一個唯一的標識符，它是由通過[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。當命令開始[commandStarted](qftp.html#commandStarted)（）信號被發射。當它完成時的[commandFinished](qftp.html#commandFinished)（）信號被發射。 [commandFinished](qftp.html#commandFinished)（） **See also** [readyRead](qftp.html#readyRead)（）[dataTransferProgress](qftp.html#dataTransferProgress)（）和[commandStarted](qftp.html#commandStarted)（）。 ``` bool QFtp.hasPendingCommands (self) ``` 返回True如果有尚未被執行計劃的任何命令，否則返回False 。正在執行的命令是_not_視為一個調度命令。 **See also** [clearPendingCommands](qftp.html#clearPendingCommands)（）[currentId](qftp.html#currentId)（）和[currentCommand](qftp.html#currentCommand)（）。 ``` int QFtp.list (self, QString?directory?=?QString()) ``` 列出目錄的內容_dir_在FTP服務器上。如果_dir_是空的，它會列出當前目錄的內容。該[listInfo](qftp.html#listInfo)（）信號被發射對找到的每個目錄項。該功能不會阻止，并立即返回。該命令是預定的，并且是異步執行的執行。該函數返回一個唯一的標識符，它是由通過[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。當命令開始[commandStarted](qftp.html#commandStarted)（）信號被發射。當它完成時的[commandFinished](qftp.html#commandFinished)（）信號被發射。 **See also** [listInfo](qftp.html#listInfo)（）[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。 ``` int QFtp.login (self, QString?user?=?QString(), QString?password?=?QString()) ``` 登錄到FTP服務器的用戶名_user_和密碼_password_。該[stateChanged](qftp.html#stateChanged)（）信號被發射時，在連接過程的狀態變化，例如至`LoggedIn`。該功能不會阻止，并立即返回。該命令是預定的，并且是異步執行的執行。該函數返回一個唯一的標識符，它是由通過[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。當命令開始[commandStarted](qftp.html#commandStarted)（）信號被發射。當它完成時的[commandFinished](qftp.html#commandFinished)（）信號被發射。 **See also** [commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。 ``` int QFtp.mkdir (self, QString?dir) ``` 創建一個名為目錄_dir_在服務器上。該功能不會阻止，并立即返回。該命令是預定的，并且是異步執行的執行。該函數返回一個唯一的標識符，它是由通過[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。當命令開始[commandStarted](qftp.html#commandStarted)（）信號被發射。當它完成時的[commandFinished](qftp.html#commandFinished)（）信號被發射。 **See also** [commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。 ``` int QFtp.put (self, QByteArray?data, QString?file, TransferType?type?=?QFtp.Binary) ``` 讀取IO設備中的數據_dev_，并將其寫入到被調用的文件_file_在服務器上。讀取數據從IO設備的塊，所以此重載允許您傳輸大量的數據，而不需要讀取所有的數據到內存中一次。這取決于價值的數據作為二進制或ASCII_type_。確保_dev_指針是有效的操作的持續時間（它是安全的刪除當[commandFinished](qftp.html#commandFinished)（）被發射）。 ``` int QFtp.put (self, QIODevice?device, QString?file, TransferType?type?=?QFtp.Binary) ``` 這是一個重載函數。寫入給定的一個副本_data_要調用的文件_file_在服務器上。上傳的進度報告的[dataTransferProgress](qftp.html#dataTransferProgress)（）信號。這取決于價值的數據作為二進制或ASCII_type_。該功能不會阻止，并立即返回。該命令是預定的，并且是異步執行的執行。該函數返回一個唯一的標識符，它是由通過[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。當命令開始[commandStarted](qftp.html#commandStarted)（）信號被發射。當它完成時的[commandFinished](qftp.html#commandFinished)（）信號被發射。由于該功能需要的副本_data_，你可以放棄自己的副本時，該函數返回。 **See also** [dataTransferProgress](qftp.html#dataTransferProgress)（）[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。 ``` int QFtp.rawCommand (self, QString?command) ``` 將原始的FTP命令_command_到FTP服務器。這是低層次的FTP訪問有用的。如果你想執行的操作具有等效[QFtp](qftp.html)的功能，我們建議使用該功能，而不是原始的FTP命令，因為功能更容易，更安全。該功能不會阻止，并立即返回。該命令是預定的，并且是異步執行的執行。該函數返回一個唯一的標識符，它是由通過[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。當命令開始[commandStarted](qftp.html#commandStarted)（）信號被發射。當它完成時的[commandFinished](qftp.html#commandFinished)（）信號被發射。 **See also** [rawCommandReply](qftp.html#rawCommandReply)（）[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。 ``` str QFtp.read (self, int?maxlen) ``` 閱讀_maxlen_從數據插座成字節_data_并返回讀取的字節數。返回-1，如果發生了錯誤。 **See also** [get](qftp.html#get)（）[readyRead](qftp.html#readyRead)（）[bytesAvailable](qftp.html#bytesAvailable)（）和[readAll](qftp.html#readAll)（）。 ``` QByteArray QFtp.readAll (self) ``` [ 讀取所有可用的數據套接字的字節數，并返回它們。 ](qbytearray.html) [**See also**](qbytearray.html) [get](qftp.html#get)（）[readyRead](qftp.html#readyRead)（）[bytesAvailable](qftp.html#bytesAvailable)（）和[read](qftp.html#read)（）。 ``` int QFtp.remove (self, QString?file) ``` 刪除的文件稱為_file_從服務器。該功能不會阻止，并立即返回。該命令是預定的，并且是異步執行的執行。該函數返回一個唯一的標識符，它是由通過[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。當命令開始[commandStarted](qftp.html#commandStarted)（）信號被發射。當它完成時的[commandFinished](qftp.html#commandFinished)（）信號被發射。 **See also** [commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。 ``` int QFtp.rename (self, QString?oldname, QString?newname) ``` 所謂重命名文件_oldname_至_newname_在服務器上。該功能不會阻止，并立即返回。該命令是預定的，并且是異步執行的執行。該函數返回一個唯一的標識符，它是由通過[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。當命令開始[commandStarted](qftp.html#commandStarted)（）信號被發射。當它完成時的[commandFinished](qftp.html#commandFinished)（）信號被發射。 **See also** [commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。 ``` int QFtp.rmdir (self, QString?dir) ``` 所謂刪除的目錄_dir_從服務器。該功能不會阻止，并立即返回。該命令是預定的，并且是異步執行的執行。該函數返回一個唯一的標識符，它是由通過[commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。當命令開始[commandStarted](qftp.html#commandStarted)（）信號被發射。當它完成時的[commandFinished](qftp.html#commandFinished)（）信號被發射。 **See also** [commandStarted](qftp.html#commandStarted)（）和[commandFinished](qftp.html#commandFinished)（）。 ``` int QFtp.setProxy (self, QString?host, int?port) ``` 允許主機使用FTP代理的_host_和端口_port_。調用此函數_host_空禁用代理。 [QFtp](qftp.html)不支持FTP環比HTTP代理服務器。使用[QNetworkAccessManager](qnetworkaccessmanager.html)這一點。 ``` int QFtp.setTransferMode (self, TransferMode?mode) ``` 設置當前FTP傳輸模式_mode_。默認值是[QFtp.Passive](qftp.html#TransferMode-enum)。 **See also** [QFtp.TransferMode](qftp.html#TransferMode-enum)。 ``` State QFtp.state (self) ``` [](qftp.html#State-enum) [返回該對象的當前狀態。當狀態改變時，](qftp.html#State-enum)[stateChanged](qftp.html#stateChanged)（）信號被發射。 **See also** [State](qftp.html#State-enum)和[stateChanged](qftp.html#stateChanged)（）。 * * * ## Qt Signal Documentation ``` void commandFinished (int,bool) ``` 這是該信號的默認超載。處理確定的命令時，這個信號被發射_id_已完成。_error_是真的，如果在處理過程中發生錯誤，否則_error_是假的。 **See also** [commandStarted](qftp.html#commandStarted)（）[done](qftp.html#done)（）[error](qftp.html#error)（）和[errorString](qftp.html#errorString)（）。 ``` void commandStarted (int) ``` 這是該信號的默認超載。處理確定的命令時，這個信號被發射_id_開始。 **See also** [commandFinished](qftp.html#commandFinished)（）和[done](qftp.html#done)（）。 ``` void dataTransferProgress (qint64,qint64) ``` 這是該信號的默認超載。此信號響應于被發射[get](qftp.html#get)（）或[put](qftp.html#put)（）請求指示下載或上傳的當前進度。 _done_是數據的一個已經被轉移及金額_total_是數據要被讀出或寫入的總量。它是可能的[QFtp](qftp.html)類是不能夠確定數據應該被轉移的總量，在此情況_total_為0。（如果這個信號連接到[QProgressBar](qprogressbar.html)，進度條顯示一個繁忙的指標，如果總為0 ）。 **Warning:** _done_和_total_不一定以字節為單位的大小，因為對于大文件的這些值可能需要被“縮放”，以避免溢出。 **See also** [get](qftp.html#get)（）[put](qftp.html#put)（）和[QProgressBar](qprogressbar.html)。 ``` void done (bool) ``` 這是該信號的默認超載。這個信號被發射時的最后等候命令完成（這是后發出的最后一個命令的[commandFinished](qftp.html#commandFinished)（）信號）。_error_是真的，如果在處理過程中發生錯誤，否則_error_是假的。 **See also** [commandFinished](qftp.html#commandFinished)（）[error](qftp.html#error)（）和[errorString](qftp.html#errorString)（）。 ``` void listInfo (const QUrlInfo&) ``` 這是該信號的默認超載。這個信號被發射的每個目錄項的[list](qftp.html#list)（）命令的發現。條目的詳細信息存儲在_i_。 **See also** [list](qftp.html#list)（）。 ``` void rawCommandReply (int,const QString&) ``` 這是該信號的默認超載。此信號響應于所述發射[rawCommand](qftp.html#rawCommand)（）函數。_replyCode_是3位數字應答碼和_detail_是遵循應答碼的文本。 **See also** [rawCommand](qftp.html#rawCommand)（）。 ``` void readyRead () ``` 這是該信號的默認超載。此信號響應于被發射[get](qftp.html#get)（）命令時有新的數據讀取。如果指定的設備如在第二個參數[get](qftp.html#get)（）命令，該信號是_not_射出，而是將數據直接寫入到設備。您可以使用讀取數據[readAll](qftp.html#readAll)（）或[read](qftp.html#read)（）函數。如果你想，只要它成為可用在處理大塊數據這個信號是非常有用的。如果你只關心在完整的數據，只需連接到[commandFinished](qftp.html#commandFinished)（）信號并讀取數據，然后代替。 **See also** [get](qftp.html#get)（）[read](qftp.html#read)（）[readAll](qftp.html#readAll)（）和[bytesAvailable](qftp.html#bytesAvailable)（）。 ``` void stateChanged (int) ``` 這是該信號的默認超載。這個信號被發射時的連接狀態發生改變。這個論點_state_是該連接的新的狀態，它是一個[State](qftp.html#State-enum)值。它通常是在響應于發射[connectToHost](qftp.html#connectToHost)（）或[close](qftp.html#close)（）命令，但它也可以被發射的“自發地” ，例如當服務器意外關閉連接。 **See also** [connectToHost](qftp.html#connectToHost)（）[close](qftp.html#close)（）[state](qftp.html#state)（）和[State](qftp.html#State-enum)。