Peer.GetObjects Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Net.PeerToPeer.Collaboration
Zestaw:
System.Net.dll

Pobiera kolekcję obiektów danych zarejestrowanych przez element równorzędny z lokalnej pamięci podręcznej.

Przeciążenia

GetObjects()

Pobiera kolekcję obiektów danych z lokalnej pamięci podręcznej.
GetObjects(Guid)

Peer Pobiera obiekt skojarzony z podanym Guid elementem z elementu PeerObjectCollection.

Uwagi

Ta funkcja jest uwidoczniona tylko w PeerContact klasie. Ta funkcja nie jest widoczna dla żadnego innego typu elementu równorzędnego ze względów bezpieczeństwa.

Jeśli żaden obiekt nie zostanie znaleziony dla punktu końcowego, zwracana jest kolekcja o zerowym rozmiarze (0).

GetObjects()

Pobiera kolekcję obiektów danych z lokalnej pamięci podręcznej.

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

Zwraca

PeerObjectCollection

Kolekcja PeerObject elementu równorzędnego lub punktu końcowego określonego przez to wystąpienie.

Atrybuty
SecurityCriticalAttribute

Wyjątki

InvalidOperationException

Obiekt wywołujący nie jest subskrybowany do punktu końcowego lub nie został jeszcze wywołany RefreshData().

PeerToPeerException

Metoda nie może zakończyć się z powodu błędu w bazowej infrastrukturze współpracy równorzędnej.

Uwagi

Ta funkcja jest uwidoczniona tylko w PeerContact klasie. Ta funkcja nie jest widoczna dla żadnego innego typu elementu równorzędnego ze względów bezpieczeństwa.

Jeśli sesja współpracy równorzędnej nie tworzy wystąpienia z elementem , PermissionStateUnrestrictedta metoda nie może uzyskać dostępu do obiektów na komputerze lokalnym. To samo dotyczy aplikacji zarejestrowanych w sesji współpracy.

Kolekcja obiektów równorzędnych składa się z aplikacji, obiektu danych i informacji o obecności elementu równorzędnego lub punktu końcowego określonego przez to wystąpienie. Jeśli żaden obiekt nie zostanie znaleziony dla punktu końcowego, zwracana jest kolekcja o zerowym rozmiarze (0). Jeśli wywołujący element równorzędny jest subskrybowany do tego punktu końcowego, pamięć podręczna zostanie automatycznie zaktualizowana; w przeciwnym razie RefreshData należy wywołać metodę przed wywołaniem tej metody.

Obiekt wywołujący nie musi być zalogowany do infrastruktury współpracy, aby ta metoda została pomyślnie ukończona. Pomyślne wywołanie metody RefreshData lub jedna z Subscribe metod musi zostać ukończona, gdy obiekt wywołujący został zalogowany wcześniej, aby wywołać tę metodę.

UWAGA: Dodatkowe przeciążenia są definiowane w Peer klasie zamiast podklas PeerContact i PeerNearMe.

Zobacz też

Dotyczy

GetObjects(Guid)

Peer Pobiera obiekt skojarzony z podanym Guid elementem z elementu PeerObjectCollection.

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

Parametry

objectId
Guid

Peer ObiektGuid, który ma zostać pobrany z kolekcji.

Zwraca

PeerObjectCollection

Peer obiekt skojarzony z podanym Guidelementem . Jeśli obiekt nie zostanie znaleziony, zwracana jest kolekcja o rozmiarze zerowym (0).

Atrybuty
SecurityCriticalAttribute

Wyjątki

ArgumentNullException

Identyfikator obiektu to null.

InvalidOperationException

Obiekt wywołujący nie jest subskrybowany do PeerEndPoint elementu lub nie został jeszcze wywołany przeciwko RefreshData() niemu.

PeerToPeerException

Wystąpił błąd podczas pobierania informacji o obiekcie z elementu równorzędnego.

Uwagi

Ta funkcja jest uwidoczniona tylko w PeerContact klasie. Ta funkcja nie jest widoczna dla żadnego innego typu elementu równorzędnego ze względów bezpieczeństwa.

Kolekcja obiektów równorzędnych składa się z aplikacji, obiektu danych i informacji o obecności elementu równorzędnego lub punktu końcowego określonego przez to wystąpienie. Jeśli żaden obiekt nie zostanie znaleziony dla punktu końcowego, zwracana jest kolekcja o zerowym rozmiarze (0). Gdy element równorzędny wywołujący jest subskrybowany do tego punktu końcowego, pamięć podręczna jest automatycznie aktualizowana; w przeciwnym razie RefreshData należy wywołać metodę przed wywołaniem tej metody.

Obiekt wywołujący nie musi być zalogowany do infrastruktury współpracy, aby ta metoda została pomyślnie ukończona. Pomyślne wywołanie metody RefreshData lub jedna z Subscribe metod musi zostać ukończona, gdy obiekt wywołujący został zalogowany wcześniej, aby wywołać tę metodę. Wywołanie tej metody wymaga wartości PermissionState .Unrestricted Ten stan jest tworzony po rozpoczęciu sesji współpracy.

UWAGA: Dodatkowe przeciążenia są definiowane w Peer klasie zamiast klas PeerContact pochodnych i PeerNearMe.

Zobacz też

Dotyczy