PeerCollaboration.GetPeersNearMe Methode

Referenz

Definition

Namespace:: System.Net.PeerToPeer.Collaboration

Assembly:: System.Net.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 ausgefüllten PeerNearMeCollection über diese Methode kann abhängig von der Netzwerktopologie und Latenz eine unbestimmte Zeit nach der Anmeldung erfordern.

Für den Aufruf dieser Methode ist eine PermissionState von Unrestrictederforderlich. Dieser Zustand wird erstellt, wenn die Peer Zusammenarbeitssitzung beginnt.

Gilt für: