PeerCollaboration.GetPeersNearMe Metode

Definisi

Ruang nama:

System.Net.PeerToPeer.Collaboration

Rakitan:

System.Net.dll

Mengembalikan kumpulan semua PeerCollaboration titik akhir yang saat ini masuk pada subnet jaringan serekan panggilan.

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

Mengembalikan

PeerNearMeCollection

yang PeerNearMeCollection berisi semua PeerCollaboration titik akhir yang saat ini masuk ke lingkup 'Near Me'.

Jika serekan tidak ditemukan di subnet, kumpulan ukuran nol (0) dikembalikan.

Atribut

SecurityCriticalAttribute

Pengecualian

InvalidOperationException

Serekan tidak masuk ke cakupan 'Near Me'.

PeerToPeerException

Nilai yang tidak valid dikembalikan ketika metode ini mencoba menghitung semua titik akhir Orang Near Me yang diketahui.

Contoh

Contoh kode berikut mengilustrasikan cara mengambil PeersNearMe sebagai 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;
}

Keterangan

Pengembalian yang diisi PeerNearMeCollection sepenuhnya melalui metode ini dapat memerlukan jumlah waktu yang tidak ditentukan setelah masuk tergantung pada topologi dan latensi jaringan.

Memanggil metode ini membutuhkan PermissionState dari Unrestricted. Status ini dibuat saat Peer sesi kolaborasi dimulai.