Skip to main content
StreamSocketListener Class

Supporta l'ascolto di una connessione di rete in ingresso mediante un socket di flusso TCP o Bluetooth RFCOMM.

Sintassi


var streamSocketListener = new Windows.Networking.Sockets.StreamSocketListener();

public sealed class StreamSocketListener : IDisposable

Public NotInheritable Class StreamSocketListener
    Implements IDisposable

public ref class StreamSocketListener sealed : IClosable

Attributi

[ DualApiPartition()]
[ MarshalingBehavior(Agile)]
[ Threading(Both)]
[ Version(0x06020000)]

Membri

StreamSocketListenerClasse include questi tipi di membri:

Costruttori

StreamSocketListenerClasse include questi costruttori.

CostruttoreDescrizione
StreamSocketListener Creates a new StreamSocketListener object.

 

Eventi

StreamSocketListenerClasse include questi eventi.

EventoDescrizione
ConnectionReceived An event that indicates that a connection was received on the StreamSocketListener object.

 

Metodi

The StreamSocketListener Classe dispone di tali metodi. In C#, Visual Basic e C++, eredita inoltre i metodi da Object Classe.

MetodoDescrizione
BindEndpointAsync Starts a bind operation on a StreamSocketListener to a local hostname and a local service name.
BindServiceNameAsync(String) Starts a bind operation on a StreamSocketListener to a local service name.
BindServiceNameAsync(String, SocketProtectionLevel) Starts a bind operation on a StreamSocketListener to a local service name with a specified SocketProtectionLevel to set on any bound sockets.
BindServiceNameAsync(String, SocketProtectionLevel, NetworkAdapter) Starts a socket bind operation on a StreamSocketListener to a local service name on a specified network adapter with a specified SocketProtectionLevel to set on any bound sockets.
Close [C++, JavaScript]Closes the StreamSocketListener object.
Dispose [C#, VB]Performs tasks associated with freeing, releasing, or resetting unmanaged resources.

 

Proprietà

Classe dispone di tali proprietà. di StreamSocketListener

ProprietàTipo di accessoDescrizione

Control

Sola letturaGets socket control data on a StreamSocketListener object.

Information

Sola letturaGets socket information for the StreamSocketListener object.

 

Note

La classe StreamSocketListener supporta l'ascolto di una connessione di rete in ingresso mediante un socket di flusso TCP e accettando la connessione.

L'ordine tipico delle operazioni è il seguente:

Gestione delle eccezioni

È necessario scrivere il codice per gestire eccezioni quando si chiamano metodi asincroni nella classe StreamSocketListener. Le eccezioni possono derivare da errori di convalida dei parametri, errori di risoluzione dei nomi ed errori di rete. Le eccezioni dovute ad errori di rete, ad esempio perdita di connettività, errori di connessione ed errori del server, possono verificarsi in qualsiasi momento. Questi errori causano eccezioni. Se l'eccezione non viene gestita dall'app, è possibile che l'intera app venga terminata dal runtime.

Lo spazio dei nomi Windows.Networking.Sockets dispone di un metodo di supporto e di un'enumerazione utili per gestire gli errori durante l'utilizzo di socket. Può essere utile per gestire le eccezioni di rete specifiche in modo diverso nell'applicazione. Un'applicazione può inoltre utilizzare HRESULT dall'eccezione negli errori di convalida del parametro per ottenere informazioni dettagliate sull'errore che ha causato l'eccezione.

Per ulteriori informazioni sulle possibili eccezioni e su come gestirle, vedere Gestione delle eccezioni nelle app di rete.

Utilizzo di StreamSocketListener in Windows Server 2012

In Windows Server 2012 e Windows Server 2012 R2, l'oggetto Windows.Networking.dll che implementa la maggior parte delle classi nello spazio dei nomi Windows.Networking.Sockets non verrà caricato a meno che sia abilitata la funzionalità Media Foundation. Di conseguenza, le applicazioni che utilizzano StreamSocketListener e le classi del socket correlate nello spazio dei nomi Windows.Networking.Sockets avranno esito negativo se viene disabilitata la funzionalità Media Foundation. Windows Server 2012 o Windows Server 2012 R2 viene installato con la funzionalità Media Foundation disabilitata.

La funzionalità Media Foundation può essere attivata in Windows Server 2012 o Windows Server 2012 R2 tramite Server Manager o inserendo il testo seguente in un prompt dei comandi o in uno script:

dism /online /enable-feature /featurename:ServerMediaFoundation

Dopo l'abilitazione della funzionalità Media Foundation, all'utente viene richiesto di riavviare. Dopo il riavvio del computer, le classi per socket e WebSocket nello spazio dei nomi Windows.Networking.Sockets funzioneranno come previsto.

Requisiti

Client supportato minimo

Windows 8 [Applicazioni Windows Store, applicazioni desktop]

Server supportato minimo

Windows Server 2012 [Applicazioni Windows Store, applicazioni desktop]

Telefono supportato minimo

Windows Phone 8

Spazio dei nomi

Windows.Networking.Sockets
Windows::Networking::Sockets [C++]

Metadati

Windows.winmd

DLL

Windows.Networking.dll

Capabilities

internetClientServer
privateNetworkClientServer
ID_CAP_NETWORKING [Windows Phone]

Vedere anche

Altre risorse
Connessione ai servizi di rete (app Windows Store che utilizzano JavaScript e HTML)
Connessione ai servizi di rete (app Windows Store che utilizzano C#/VB/C++ e XAML)
Gestione delle eccezioni nelle applicazioni di rete
Come utilizzare controlli socket avanzati (app di Windows Store che utilizzano JavaScript e HTML)
Come utilizzare controlli socket avanzati (app di Windows Store che utilizzano C#/VB/C++ e XAML)
Guida rapida: connessione a una risorsa di rete con un socket di flusso (app di Windows Store che utilizzano JavaScript e HTML)
Risoluzione dei problemi e debug delle connessioni di rete
Riferimento
IClosable
Object
StreamSocket
StreamSocketListenerConnectionReceivedEventArgs
StreamSocketListenerControl
StreamSocketListenerInformation

 

 

Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di. Se si sceglie di partecipare, quando si lascia il sito Web di verrà visualizzato il sondaggio in linea.

Si desidera partecipare?