PeerCollaboration.GetPeersNearMe Metoda

Definice

Obor názvů:

System.Net.PeerToPeer.Collaboration

Sestavení:

System.Net.dll

Vrátí kolekci všech PeerCollaboration koncových bodů aktuálně přihlášených v síťové podsíti volajícího partnera.

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

Návraty

PeerNearMeCollection

A PeerNearMeCollection , který obsahuje všechny PeerCollaboration koncové body aktuálně přihlášené k oboru Near Me.

Pokud se v podsíti nezjistí partnerské vztahy, vrátí se kolekce s nulovou velikostí (0).

Atributy

SecurityCriticalAttribute

Výjimky

InvalidOperationException

Partnerský uzel není přihlášený k oboru Blízko mě.

PeerToPeerException

Když se tato metoda pokusila vytvořit výčet všech známých koncových bodů Lidé Near Me, vrátila se neplatná hodnota.

Příklady

Následující příklad kódu ukazuje, jak načíst PeersNearMe jako 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;
}

Poznámky

Vrácení plně naplněného PeerNearMeCollection objektu pomocí této metody může vyžadovat neurčitou dobu po přihlášení v závislosti na topologii sítě a latenci.

Volání této metody vyžaduje .PermissionStateUnrestricted Tento stav se vytvoří při Peer zahájení relace spolupráce.