Peer.GetObjects Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Net.PeerToPeer.Collaboration
Bütünleştirilmiş Kod:
System.Net.dll

Yerel önbellekten eş tarafından kaydedilen veri nesnelerinin koleksiyonunu alır.

Aşırı Yüklemeler

GetObjects()

Yerel önbellekten veri nesnelerinin koleksiyonunu alır.
GetObjects(Guid)

Peer öğesinden PeerObjectCollectionsağlanan Guid ile ilişkili nesneyi alır.

Açıklamalar

Bu işlev yalnızca sınıfında kullanıma sunulur PeerContact . Bu işlevsellik, güvenlik nedeniyle başka bir eş türünde kullanıma sunulmaz.

Uç nokta için hiçbir nesne bulunamazsa, sıfır (0) boyutunda bir koleksiyon döndürülür.

GetObjects()

Yerel önbellekten veri nesnelerinin koleksiyonunu alır.

public:
 System::Net::PeerToPeer::Collaboration::PeerObjectCollection ^ GetObjects();
[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerObjectCollection GetObjects ();
[<System.Security.SecurityCritical>]
member this.GetObjects : unit -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection
Public Function GetObjects () As PeerObjectCollection

Döndürülenler

PeerObjectCollection

PeerObject Bu örnek tarafından belirtilen eş veya uç nokta koleksiyonu.

Öznitelikler
SecurityCriticalAttribute

Özel durumlar

InvalidOperationException

Çağıran uç noktaya abone değil veya henüz çağırmadı RefreshData().

PeerToPeerException

Temel alınan Eş İşbirliği altyapısındaki bir hata nedeniyle yöntem tamamlanamıyor.

Açıklamalar

Bu işlev yalnızca sınıfında kullanıma sunulur PeerContact . Bu işlevsellik, güvenlik nedeniyle başka bir eş türünde kullanıma sunulmaz.

Eş işbirliği oturumu ile PermissionStateUnrestrictedörneği oluşturmadıysa, bu yöntem yerel bilgisayardaki nesnelere erişemez. Aynı durum, işbirliği oturumuna kaydedilen uygulamalar için de geçerlidir.

Eş nesneleri koleksiyonu, bu örnek tarafından belirtilen eş veya uç nokta için uygulama, veri nesnesi ve iletişim durumu bilgilerinden oluşur. Uç nokta için hiçbir nesne bulunamazsa, sıfır (0) boyutunda bir koleksiyon döndürülür. Çağıran eş bu uç noktaya abone olursa önbellek otomatik olarak güncelleştirilir; aksi takdirde RefreshData , bu yöntemi çağırmadan önce çağrılmalıdır.

Bu yöntemin başarıyla tamamlanması için çağıranın işbirliği altyapısında oturum açması gerekmez. Çağıran bu yöntemi çağırmak Subscribe için RefreshData daha önce oturum açmışken başarılı bir çağrısının veya yöntemlerden birinin tamamlanmış olması gerekir.

NOT: Ve alt sınıfları yerine sınıfında ek aşırı yüklemeler PeerContactPeerNearMetanımlanırPeer.

Ayrıca bkz.

Şunlara uygulanır

GetObjects(Guid)

Peer öğesinden PeerObjectCollectionsağlanan Guid ile ilişkili nesneyi alır.

public:
 System::Net::PeerToPeer::Collaboration::PeerObjectCollection ^ GetObjects(Guid objectId);
[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerObjectCollection GetObjects (Guid objectId);
[<System.Security.SecurityCritical>]
member this.GetObjects : Guid -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection
Public Function GetObjects (objectId As Guid) As PeerObjectCollection

Parametreler

objectId
Guid

GuidPeer Koleksiyondan alınacak nesnenin öğesi.

Döndürülenler

PeerObjectCollection

Peer nesnesi, sağlanan Guidile ilişkilidir. Bir nesne bulunamazsa, sıfır (0) boyutunda bir koleksiyon döndürülür.

Öznitelikler
SecurityCriticalAttribute

Özel durumlar

ArgumentNullException

Nesne kimliği şeklindedir null.

InvalidOperationException

Çağıran öğesine abone PeerEndPoint değil veya henüz buna karşı çağırmadı RefreshData() .

PeerToPeerException

Eşten nesne bilgileri alırken bir hata oluştu.

Açıklamalar

Bu işlev yalnızca sınıfında kullanıma sunulur PeerContact . Bu işlevsellik, güvenlik nedeniyle başka bir eş türünde kullanıma sunulmaz.

Eş nesneleri koleksiyonu, bu örnek tarafından belirtilen eş veya uç nokta için uygulama, veri nesnesi ve iletişim durumu bilgilerinden oluşur. Uç nokta için hiçbir nesne bulunamazsa, sıfır (0) boyutunda bir koleksiyon döndürülür. Çağıran eş bu uç noktaya abone olduğunda önbellek otomatik olarak güncelleştirilir; aksi takdirde RefreshData , bu yöntemi çağırmadan önce çağrılmalıdır.

Bu yöntemin başarıyla tamamlanması için çağıranın işbirliği altyapısında oturum açması gerekmez. Çağıran bu yöntemi çağırmak Subscribe için RefreshData daha önce oturum açmışken başarılı bir çağrısının veya yöntemlerden birinin tamamlanmış olması gerekir. Bu yöntemin çağrılması için bir PermissionState gerekir Unrestricted. Bu durum, işbirliği oturumu başladığında oluşturulur.

NOT: Türetilmiş sınıflar PeerContact ve PeerNearMeyerine sınıfında ek aşırı yüklemeler tanımlanırPeer.

Ayrıca bkz.

Şunlara uygulanır