Windows.Networking Spazio dei nomi
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce l'accesso ai nomi host e agli endpoint usati dalle app di rete.
Classi
| Nome | Descrizione |
|---|---|
| EndpointPair |
Rappresenta un'associazione di identificatori host/servizio locali e remoti (nome host o IP più nome o porta) usati per avviare o descrivere una connessione di rete. |
| HostName |
Rappresenta un nome host o un indirizzo IP (dominio, IPv4, IPv6 o Bluetooth) usato dalle API di rete Windows. |
Enumerazioni
| Nome | Descrizione |
|---|---|
| DomainNameType |
Tipo di dominio dell'oggetto HostName quando HostNameType è un nome di dominio. |
| HostNameSortOptions |
Opzioni per l'ordinamento di un elenco di oggetti EndpointPair . |
| HostNameType |
Tipo di un oggetto HostName . |
Commenti
Annotazioni
Compatibilità del framework app: Windows. Le API di rete sono disponibili per le app di SDK per app di Windows (WinUI 3) e le app desktop Win32, non solo per le app UWP. Le app desktop possono usare oggetti HostName e EndpointPair tramite C#/WinRT o C++/WinRT. Per le app desktop in pacchetto, le funzionalità di rete vengono dichiarate nel manifesto dell'app come per le app UWP. Per impostazione predefinita, le app desktop non in pacchetto hanno accesso alla rete senza restrizioni. Per informazioni dettagliate, vedere Chiamare le API Windows Runtime nelle app desktop.
Windows. Lo spazio dei nomi Rete fornisce classi usate per inizializzare e fornire dati per un nome host o un indirizzo IP e per una coppia di endpoint di rete usata nelle app di rete. Gli oggetti HostName ed EndpointPair vengono usati da molte classi in altri spazi dei nomi correlati. Questi includono:
- Classi nel Windows. Spazio dei nomi Networking.Sockets usato per le app di rete tramite socket e WebSocket.
- Classe NetworkInformation nel Windows. Spazio dei nomi Networking.Connectivity.
In Windows Server 2012 il Windows.Networking.dll che implementa le classi nel Windows. Lo spazio dei nomi di rete non verrà caricato a meno che non sia abilitata la funzionalità Media Foundation. Di conseguenza, le app che usano classi nel Windows. Lo spazio dei nomi di rete avrà esito negativo se la funzionalità Media Foundation è disabilitata (impostazione predefinita in Windows Server 2012).
La funzionalità Media Foundation può essere abilitata in Windows Server 2012 usando Server Manager o immettendo il comando seguente in una finestra CMD o in uno script.
dism /online /enable-feature /featurename:ServerMediaFoundation All'utente viene richiesto di riavviare dopo l'abilitazione della funzionalità Media Foundation in Windows Server 2012. Dopo il riavvio del computer, le classi nel Windows. Lo spazio dei nomi di rete funzionerà come previsto.
Uso dell'isolamento di rete
La funzionalità di isolamento della rete in Windows consente a uno sviluppatore di controllare completamente l'accesso alla rete di un'app in pacchetto (inclusa la piattaforma UWP e le app desktop in pacchetto SDK per app di Windows (WinUI 3). Non tutte le app potrebbero richiedere l'accesso alla rete. Tuttavia, per le app che lo fanno, Windows fornisce diversi livelli di accesso alla rete che possono essere abilitati selezionando le funzionalità appropriate.
L'isolamento della rete consente a uno sviluppatore di definire per ogni app l'ambito dell'accesso di rete necessario. A un'app senza l'ambito appropriato definito viene impedito di accedere al tipo di rete specificato e al tipo specifico di richiesta di rete indicato (richieste in uscita avviate dal client oppure sia richieste in ingresso non sollecitate sia richieste in uscita avviate dal client). La possibilità di impostare e applicare l'isolamento della rete garantisce che, se un'app viene compromessa, può accedere solo alle reti in cui l'app ha concesso in modo esplicito l'accesso. In questo modo si riduce significativamente l'ambito dell'impatto su altre app e sulle Windows.
L'isolamento della rete influisce su qualsiasi metodo e proprietà nella Windows. Networking.Sockets, Windows. Networking.BackgroundTransfer, Windows. Web.AtomPub e Windows. Spazi dei nomi Web.Syndication che tentano di accedere alla rete. Windows applica attivamente l'isolamento di rete. Una chiamata a un metodo o a qualsiasi accesso a una proprietà in questi spazi dei nomi che comporta un accesso alla rete potrebbe non riuscire a causa dell'isolamento di rete se la funzionalità di rete appropriata non è stata abilitata.
Le funzionalità di rete per un'app vengono configurate nel manifesto dell'app al momento della compilazione dell'app. Le funzionalità di rete vengono in genere aggiunte usando Microsoft Visual Studio 2012 durante lo sviluppo dell'app. Le funzionalità di rete possono anche essere impostate manualmente nel file manifesto dell'app usando un editor di testo.
Per informazioni più dettagliate sull'isolamento di rete, vedere Come configurare le funzionalità di isolamento della rete.