PeerCollaboration.GetPeersNearMe Yöntem

Tanım

Ad Alanı:

System.Net.PeerToPeer.Collaboration

Bütünleştirilmiş Kod:

System.Net.dll

Çağıran eşin PeerCollaboration ağ alt ağında oturum açmış durumda olan tüm uç noktaların bir koleksiyonunu döndürür.

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

Döndürülenler

PeerNearMeCollection

PeerNearMeCollection Şu anda 'YakınımdaPeerCollaboration' kapsamında oturum açmış olan tüm uç noktaları içeren bir.

Alt ağda eşler bulunmazsa, sıfır (0) boyutunda bir koleksiyon döndürülür.

Öznitelikler

SecurityCriticalAttribute

Özel durumlar

InvalidOperationException

Eş , 'Yakınımdaki' kapsamında oturum açmamış.

PeerToPeerException

Bu yöntem bilinen tüm Yakınım Kişiler uç noktalarını listelemeye çalıştığında geçersiz bir değer döndürüldü.

Örnekler

Aşağıdaki kod örneği, PeerNearMe'nin PeerNearMeCollection olarak nasıl alınıyor olduğunu gösterir:

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

Açıklamalar

Bu yöntem aracılığıyla tamamen doldurulan PeerNearMeCollection bir değerin döndürülmesi, ağ topolojisine ve gecikme süresine bağlı olarak oturum açmadan sonra belirsiz bir süre gerektirebilir.

Bu yöntemin çağrılması için bir PermissionState gerekir Unrestricted. Bu durum, işbirliği oturumu başladığında oluşturulur Peer .