# QNetworkProxyFactory Class Reference ## [[QtNetwork](index.htm) module] 該QNetworkProxyFactory類提供細粒度的代理選擇。[More...](#details) ### Methods * `__init__ (self)` * `__init__ (self, QNetworkProxyFactory)` * `list-of-QNetworkProxy queryProxy (self, QNetworkProxyQuery?query?=?QNetworkProxyQuery())` ### Static Methods * `list-of-QNetworkProxy proxyForQuery (QNetworkProxyQuery?query)` * `setApplicationProxyFactory (QNetworkProxyFactory?factory)` * `setUseSystemConfiguration (bool?enable)` * `list-of-QNetworkProxy systemProxyForQuery (QNetworkProxyQuery?query?=?QNetworkProxyQuery())` * * * ## Detailed Description 該QNetworkProxyFactory類提供細粒度的代理選擇。 QNetworkProxyFactory是一個擴展[QNetworkProxy](qnetworkproxy.html)，允許應用程序有一個更細粒度控制哪些代理服務器使用，這取決于插座請求代理。這使得應用程序可以應用不同的設置，根據該協議或目的地的主機名，例如。 QNetworkProxyFactory可以全局設置的應用程序，在這種情況下，它會復蓋設置任何全局代理[QNetworkProxy.setApplicationProxy](qnetworkproxy.html#setApplicationProxy)（ ） 。如果全局設置，使用Qt創建的套接字將查詢的工廠，以確定要使用的代理服務器。 一個工廠也可以支持多個連接特定的框架，比如設置[QNetworkAccessManager](qnetworkaccessmanager.html)。當這樣的對象設置，該工廠將被詢問只有該框架創建的套接字。 ### System Proxies 您可以配置一個工廠使用系統代理設置。調用[setUseSystemConfiguration](qnetworkproxyfactory.html#setUseSystemConfiguration)（ ）函數真正要啟用此行為，或虛假禁用它。 同樣，您可以使用一個工廠通過調用進行查詢，直接到系統代理其[systemProxyForQuery](qnetworkproxyfactory.html#systemProxyForQuery)（）函數。 **Warning:**根據用戶的系統配置，使用在某些平臺上系統代理的功能可能會受到限制。該[systemProxyForQuery](qnetworkproxyfactory.html#systemProxyForQuery)（ ）文檔中包含的這些限制對于那些受影響的平臺列表。 * * * ## Method Documentation ``` QNetworkProxyFactory.__init__ (self) ``` 創建[QNetworkProxyFactory](qnetworkproxyfactory.html)對象。 自[QNetworkProxyFactory](qnetworkproxyfactory.html)是一個抽象類，你不能創建類型的對象[QNetworkProxyFactory](qnetworkproxyfactory.html)直接。 ``` QNetworkProxyFactory.__init__ (self, QNetworkProxyFactory) ``` ``` list-of-QNetworkProxy QNetworkProxyFactory.proxyForQuery (QNetworkProxyQuery?query) ``` 這個函數接受查詢請求，_query_，檢查插座或請求的類型的詳細信息，并返回一個列表[QNetworkProxy](qnetworkproxy.html)對象表示要使用的代理服務器，按優先順序。 ``` list-of-QNetworkProxy QNetworkProxyFactory.queryProxy (self, QNetworkProxyQuery?query?=?QNetworkProxyQuery()) ``` 這種方法是抽象的，應在任何子類中重新實現。 這個函數接受查詢請求，_query_，檢查插座或請求的類型的詳細信息，并返回一個列表[QNetworkProxy](qnetworkproxy.html)對象表示要使用的代理服務器，按優先順序。 當重新實現這個類，照顧到返回至少一個元素。 如果你不能確定一個更好的指標替代，使用[QNetworkProxy.DefaultProxy](qnetworkproxy.html#ProxyType-enum)，它告訴在查詢代理來使用更高的替代的代碼。舉例來說，如果這家工廠被設置為[QNetworkAccessManager](qnetworkaccessmanager.html)對象， DefaultProxy會告訴它來查詢應用程序級代理設置。 如果這家工廠被設置為應用程序代理工廠， DefaultProxy和NoProxy將具有相同的含義。 ``` QNetworkProxyFactory.setApplicationProxyFactory (QNetworkProxyFactory?factory) ``` 該_factory_說法有它的所有權轉移給Qt的。 設置應用程序范圍內的代理工廠是_factory_。此功能需要該對象的所有權，并在必要時將其刪除。 應用范圍的代理作為最后手段時返回的所有其他選擇代理請求[QNetworkProxy.DefaultProxy](qnetworkproxy.html#ProxyType-enum)。例如，[QTcpSocket](qtcpsocket.html)對象可以有一個代理設置QTcpSocket.setProxy ，但如果沒有設置，代理工廠類在此項功能設置將會被查詢。 如果您設置了代理工廠使用此功能，設置QNetworkProxy.setApplicationProxy任何應用程序級代理將被改寫。 **See also** [QNetworkProxy.setApplicationProxy](qnetworkproxy.html#setApplicationProxy)（ ）[QAbstractSocket.proxy](qabstractsocket.html#proxy)（）和[QAbstractSocket.setProxy](qabstractsocket.html#setProxy)（ ） 。 ``` QNetworkProxyFactory.setUseSystemConfiguration (bool?enable) ``` 允許使用特定于平臺的代理服務器設置，只有那些。看[systemProxyForQuery](qnetworkproxyfactory.html#systemProxyForQuery)（ ）獲取更多信息。 在內部，與調用時這個方法（_enable_設置為True ）設置一個應用程序范圍的代理工廠。由于這個原因，這種方法是相互排斥的[setApplicationProxyFactory](qnetworkproxyfactory.html#setApplicationProxyFactory)（ ） ：調用[setApplicationProxyFactory](qnetworkproxyfactory.html#setApplicationProxyFactory)（ ）會復蓋系統的使用范圍內的代理，并調用setUseSystemConfiguration （）將復蓋先前設置的任何應用程序代理或代理工廠。 **Note:**請參閱[systemProxyForQuery](qnetworkproxyfactory.html#systemProxyForQuery)（）文檔中的限制與使用系統代理列表。 此功能被引入Qt的4.6 。 ``` list-of-QNetworkProxy QNetworkProxyFactory.systemProxyForQuery (QNetworkProxyQuery?query?=?QNetworkProxyQuery()) ``` 這個函數接受查詢請求，_query_，檢查插座或請求的類型的詳細信息，并返回一個列表[QNetworkProxy](qnetworkproxy.html)對象表示要使用的代理服務器，按優先順序。 此功能可用于確定特定于平臺的代理服務器設置。此函數將使用由操作系統提供的庫來確定代理對于一個給定的連接，如果這樣的庫存。如果他們不這樣做，這個函數將只返回一個[QNetworkProxy](qnetworkproxy.html)類型[QNetworkProxy.NoProxy](qnetworkproxy.html#ProxyType-enum)。 在Windows上，這個功能將使用WinHTTP的DLL函數。盡管它的名字，微軟建議使用它需要網絡連接的所有應用程序，而不僅限于HTTP 。這將尊重注冊表與Proxycfg.exe工具設定的代理服務器設置。如果找不到這些設置，此功能將嘗試獲取Internet Explorer的設置和使用它們。 在MacOS X ，這個函數將使用來自蘋果的SystemConfiguration中框架獲得代理設置。它將應用FTP，HTTP和HTTPS代理配置包含協議標籤“ ftp”的疑問， “ http”和“ https”開頭，分別為。如果SOCKS代理在該配置中啟用，該功能將使用SOCKS服務器的所有查詢。如果SOCKS沒有啟用，它會使用HTTPS代理所有的TCPSocket和的URLRequest查詢。 黑莓，這個函數獲取代理服務器設置為使用系統配置的默認配置。類型將根據協議標籤“ http”的設定，以“https ”，“ ftp”的分別。默認情況下，它假定HTTP類型。代理服務器的用戶名和密碼，使用系統配置在查詢過程中也設置。 在其他系統上，此功能將拿起代理設置從“ HTTP_PROXY ”環境變量。此變量必須使用下列方案之一的URL ： “ HTTP ” ， “ SOCKS5 ”或“ socks5h ” 。 #### Limitations 這些都為這功能的當前版本的限制。 Qt的未來版本可能會解除一些在這里列出的限制。 * On MacOS X, this function will ignore the Proxy Auto Configuration settings, since it cannot execute the associated ECMAScript code. * On Windows platforms, this function may take several seconds to execute depending on the configuration of the user's system. **`\li`**黑莓，只有的URLRequest和的TCPSocket查詢的支持。不支持SOCKS 。該代理憑據僅擷取的默認配置。