Peer.GetObjects Methode

  • Referenz

Definition

Namespace:
System.Net.PeerToPeer.Collaboration
Assembly:
System.Net.dll

Ruft die Auflistung von Datenobjekten ab, die vom Peer aus einem lokalen Cache registriert wurden.

Überlädt

GetObjects()

Ruft die Auflistung von Datenobjekten aus einem lokalen Cache ab.
GetObjects(Guid)

Ruft das Peer-Objekt ab, das der aus der Guid bereitgestellten PeerObjectCollection zugeordnet ist.

Hinweise

Diese Funktionalität wird nur für die PeerContact -Klasse verfügbar gemacht. Diese Funktionalität wird aus Sicherheitsgründen auf keinem anderen Peertyp verfügbar gemacht.

Wenn keine Objekte für den Endpunkt gefunden werden, wird eine Auflistung der Größe 0 (0) zurückgegeben.

GetObjects()

Ruft die Auflistung von Datenobjekten aus einem lokalen Cache ab.

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

Gibt zurück

PeerObjectCollection

Die PeerObject-Auflistung für den von dieser Instanz angegebenen Peer oder Endpunkt.

Attribute
SecurityCriticalAttribute

Ausnahmen

InvalidOperationException

Der Aufrufer ist nicht für den Endpunkt abonniert oder hat noch nicht RefreshData() aufgerufen.

PeerToPeerException

Die Methode kann aufgrund eines Fehlers in der zugrunde liegenden Peerzusammenarbeitsinfrastruktur nicht abgeschlossen werden.

Hinweise

Diese Funktionalität wird nur für die PeerContact -Klasse verfügbar gemacht. Diese Funktionalität wird aus Sicherheitsgründen auf keinem anderen Peertyp verfügbar gemacht.

Wenn die Peerzusammenarbeitssitzung nicht mit einem PermissionState instanziieren wurde Unrestricted, kann diese Methode nicht auf Objekte auf dem lokalen Computer zugreifen. Das gleiche gilt für die Anwendungen, die in der Zusammenarbeitssitzung registriert wurden.

Die Sammlung von Peerobjekten besteht aus Anwendungs-, Datenobjekt- und Anwesenheitsinformationen für den Peer oder Endpunkt, der von diesem instance angegeben wird. Wenn keine Objekte für den Endpunkt gefunden werden, wird eine Auflistung der Größe 0 (0) zurückgegeben. Wenn der aufrufende Peer diesen Endpunkt abonniert hat, wird der Cache automatisch aktualisiert. andernfalls RefreshData muss vor dem Aufrufen dieser Methode aufgerufen werden.

Der Aufrufer muss nicht bei der Zusammenarbeitsinfrastruktur angemeldet werden, damit diese Methode erfolgreich abgeschlossen werden kann. Ein erfolgreicher Aufruf RefreshData von oder einer der Subscribe Methoden muss abgeschlossen sein, während der Aufrufer zuvor angemeldet wurde, um diese Methode aufzurufen.

HINWEIS: Zusätzliche Überladungen werden für die Peer -Klasse anstelle der Unterklassen PeerContact und PeerNearMedefiniert.

Weitere Informationen

Gilt für:

GetObjects(Guid)

Ruft das Peer-Objekt ab, das der aus der Guid bereitgestellten PeerObjectCollection zugeordnet ist.

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

Parameter

objectId
Guid

Der Guid des -Objekts, das Peer aus der Auflistung abgerufen werden soll.

Gibt zurück

PeerObjectCollection

Das Peer-Objekt, das der bereitgestellten Guid zugeordnet ist. Wenn ein Objekt nicht gefunden wurde, wird eine Auflistung der Größe 0 (null) zurückgegeben.

Attribute
SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

Die Objekt-ID ist null.

InvalidOperationException

Der Aufrufer ist nicht für den PeerEndPoint abonniert oder hat noch nicht RefreshData() für den Endpunkt aufgerufen.

PeerToPeerException

Fehler beim Abrufen von Objektinformationen aus dem Peer.

Hinweise

Diese Funktionalität wird nur für die PeerContact -Klasse verfügbar gemacht. Diese Funktionalität wird aus Sicherheitsgründen auf keinem anderen Peertyp verfügbar gemacht.

Die Sammlung von Peerobjekten besteht aus Anwendungs-, Datenobjekt- und Anwesenheitsinformationen für den Peer oder Endpunkt, der von diesem instance angegeben wird. Wenn keine Objekte für den Endpunkt gefunden werden, wird eine Auflistung der Größe 0 (0) zurückgegeben. Wenn der aufrufende Peer diesen Endpunkt abonniert hat, wird der Cache automatisch aktualisiert. andernfalls RefreshData muss vor dem Aufrufen dieser Methode aufgerufen werden.

Der Aufrufer muss nicht bei der Zusammenarbeitsinfrastruktur angemeldet werden, damit diese Methode erfolgreich abgeschlossen werden kann. Ein erfolgreicher Aufruf RefreshData von oder einer der Subscribe Methoden muss abgeschlossen sein, während der Aufrufer zuvor angemeldet wurde, um diese Methode aufzurufen. Für das Aufrufen dieser Methode ist eine PermissionState von Unrestrictederforderlich. Dieser Zustand wird erstellt, wenn die Zusammenarbeitssitzung beginnt.

HINWEIS: Zusätzliche Überladungen werden für die Peer -Klasse anstelle der abgeleiteten Klassen PeerContact und PeerNearMedefiniert.

Weitere Informationen

Gilt für: