PeerCollaboration.GetPeersNearMe Methode

Definition

Namespace:

System.Net.PeerToPeer.Collaboration

Assembly:

System.Net.dll

Gibt eine Auflistung aller PeerCollaboration-Endpunkte zurück, die gegenwärtig am Netzwerkteilnetz des aufrufenden Peers angemeldet sind.

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

Gibt zurück

PeerNearMeCollection

Eine PeerNearMeCollection mit allen PeerCollaboration-Endpunkten, die gegenwärtig im Bereich "Personen in meiner Umgebung" angemeldet sind.

Wenn keine Peers im Teilnetz gefunden werden, wird eine Auflistung der Größe 0 (null) zurückgegeben.

Attribute

SecurityCriticalAttribute

Ausnahmen

InvalidOperationException

Der Peer ist nicht im Bereich "Personen in meiner Umgebung" angemeldet.

PeerToPeerException

Beim Versuch dieser Methode, alle bekannten Endpunkte in Personen in meiner Umgebung aufzulisten, wurde ein ungültiger Wert zurückgegeben.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie PeersNearMe als PeerNearMeCollection abgerufen wird:

//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;
}

Hinweise

Die Rückgabe einer vollständig über diese Methode gefüllten PeerNearMeCollection Methode kann eine unbestimmte Zeit nach der Anmeldung je nach Netzwerktopologie und Latenz erfordern.

Das Aufrufen dieser Methode erfordert eine PermissionState von Unrestricted. Dieser Zustand wird erstellt, wenn die Peer Zusammenarbeitssitzung beginnt.