PeerCollaboration.GetPeersNearMe Méthode

Définition

Espace de noms:

System.Net.PeerToPeer.Collaboration

Assembly:

System.Net.dll

Retourne une collection de tous les points de terminaison de PeerCollaboration actuellement connectés sur le sous-réseau du réseau de l'homologue appelant.

public:
 static System::Net::PeerToPeer::Collaboration::PeerNearMeCollection ^ GetPeersNearMe();

[System.Security.SecurityCritical]
public static System.Net.PeerToPeer.Collaboration.PeerNearMeCollection GetPeersNearMe ();

[<System.Security.SecurityCritical>]
static member GetPeersNearMe : unit -> System.Net.PeerToPeer.Collaboration.PeerNearMeCollection

Public Shared Function GetPeersNearMe () As PeerNearMeCollection

Retours

PeerNearMeCollection

Un PeerNearMeCollection qui contient tous les points de terminaison PeerCollaboration actuellement connectés dans la portée 'NearMe'.

Si les homologues ne sont pas détectés sur le sous-réseau, une collection de taille zéro (0) est retournée.

Attributs

SecurityCriticalAttribute

Exceptions

InvalidOperationException

L'homologue n'est pas connecté dans la portée 'NearMe'.

PeerToPeerException

Une valeur non valide a été retournée lorsque cette méthode a essayé d'énumérer tous les points de terminaison connus du Voisinage immédiat.

Exemples

L’exemple de code suivant montre comment récupérer PeersNearMe en tant que PeerNearMeCollection :

//This function retrieves the peers near me as a PeerNearMeCollection.
public static PeerNearMeCollection GetPeersNearMe()
{
    PeerNearMeCollection peers = null;
    try
    {
        peers = PeerCollaboration.GetPeersNearMe();
        if (peers == null ||
            peers.Count == 0)
        {
            Console.WriteLine("There are no peers near me.");
        }
        foreach (PeerNearMe pnm in peers)
        {
            Console.WriteLine("Getting the peers near me: {0}, nickname {1}, isOnline {2}",
                pnm.ToString(),
                pnm.Nickname,
                pnm.IsOnline);
        }
    }
    catch (PeerToPeerException p2pEx)
    {
        Console.WriteLine("Could not obtain an enumeration of the peers near me: {0}", p2pEx.Message);
    }
    catch (InvalidOperationException ioEx)
    {
        Console.WriteLine("The application is no longer signed into the Peer Collaboration Infrastructure: {0}",
            ioEx.Message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Unexpected exception caught when trying to enumerate the peers near me: {0}",
            ex.Message);
    }

    return peers;
}

Remarques

Le retour d’un remplissage complet PeerNearMeCollection via cette méthode peut nécessiter une durée indéterminée après la connexion en fonction de la topologie du réseau et de la latence.

L’appel de cette méthode nécessite un PermissionState de Unrestricted. Cet état est créé au début de la Peer session de collaboration.