Windows.Networking 命名空間

編輯

提供網路應用程式所使用的主機名和端點存取權。

類別

名稱 Description
EndpointPair

代表一組本地與遠端主機/服務識別碼（主機名稱或 IP 加上服務名稱或埠口），用於發起或描述網路連線。
HostName

代表 Windows 網路 API 使用的主機名稱或 IP 位址（網域、IPv4、IPv6 或藍牙）。

列舉

名稱 Description
DomainNameType

當HostNameType是網域名稱時，HostName物件的網域類型。
HostNameSortOptions

關於如何排序 EndpointPair 物件清單的選項。
HostNameType

HostName 物件的類型。

備註

備註

應用程式框架相容性：Windows。網路 API 可用於 Windows 應用程式 SDK（WinUI 3）應用程式及 Win32 桌面應用程式，而非僅限於 UWP 應用程式。 桌面應用程式可以透過 C#/WinRT 或 C++/WinRT 使用 HostName 和 EndpointPair 物件。 對於打包式桌面應用程式，網路能力會在應用程式清單中宣告，方式與 UWP 應用程式相同。 未封裝的桌面應用程式預設擁有不受限制的網路存取權限。 詳情請參閱桌面應用程式中的呼叫 Windows 執行階段 API。

Windows。網路命名空間提供用於初始化及提供主機名稱或 IP 位址資料的類別，以及網路應用程式中使用的網路端點對。 HostName 與 EndpointPair 物件被其他相關命名空間中的許多類別使用。 這些包括下列各項：

在 Windows Server 2012，實作 Windows 中類別的 Windows.Networking.dll。除非啟用 Media Foundation 功能，否則網路命名空間將無法載入。 因此，應用程式在 Windows 中使用 classs。如果關閉 Media Foundation 功能（Windows Server 2012 的預設功能），網路命名空間將會失敗。

媒體基礎功能可在 Windows Server 2012 上使用 伺服器管理員 啟用，或在 CMD 視窗或腳本中輸入 follow 指令。

dism /online /enable-feature /featurename:ServerMediaFoundation 在 Windows Server 2012 啟用 Media Foundation 功能後，使用者會被提示重新啟動。 電腦重啟後，Windows 的類別。網路命名空間會如預期運作。

使用網路隔離

Windows 的網路隔離功能讓開發者能完全控制已封裝應用程式（包括 UWP 及封裝版 Windows 應用程式 SDK（WinUI 3）桌面應用程式）的網路存取。 並非所有應用程式都需要存取網路。 然而，對於那些具備這些功能的應用程式，Windows 提供了不同層級的網路存取權限，並可透過選擇適當的功能來啟用。

網路隔離讓開發者能為每個應用程式定義所需的網路存取範圍。 未定義適當範圍的應用程式將無法存取指定類型的網路，以及特定類型的網路請求（如由用戶端發起的外部請求，或同時包含非請求請求與用戶端發起的外部請求）。 設定並執行網路隔離的能力確保若應用程式遭到入侵，只能存取該應用程式明確授權的網路。 這大大減少了對其他應用程式及 Windows 的影響範圍。

網路隔離會影響 Windows 中的所有方法和屬性。Networking.Sockets，Windows。Networking.BackgroundTransfer，Windows。Web.AtomPub 和 Windows。Web.Syndication 命名空間嘗試存取網路。 Windows 會積極執行網路隔離。 若未啟用適當的網路能力，呼叫這些命名空間中的方法或任何屬性存取，若未啟用適當的網路功能，可能導致網路隔離而失敗。

應用程式的網路能力會在應用程式建置時的應用程式清單中設定。 網路功能通常會在開發應用程式時加入Microsoft Visual Studio 2012。 網路能力也可透過應用程式清單檔案的文字編輯器手動設定。

欲了解更多網路隔離的詳細資訊，請參閱 「如何配置網路隔離能力」。

另請參閱