Peer.GetObjects Метод

  • Ссылка

Определение

Пространство имен:
System.Net.PeerToPeer.Collaboration
Сборка:
System.Net.dll

Возвращает из локального кэша коллекцию объектов данных, зарегистрированных одноранговым узелом.

Перегрузки

GetObjects()

Возвращает коллекцию объектов данных из локального кэша.
GetObjects(Guid)

Возвращает объект Peer, связанный с заданным идентификатором Guid, из коллекции PeerObjectCollection.

Комментарии

Эта функция предоставляется только в PeerContact классе . Эта функция не предоставляется ни одному другому типу одноранговых узлов по соображениям безопасности.

Если объекты для конечной точки не найдены, возвращается коллекция нулевого размера (0).

GetObjects()

Возвращает коллекцию объектов данных из локального кэша.

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

Возвращаемое значение

PeerObjectCollection

Коллекция объектов PeerObject для однорангового узла или конечной точки, заданной этим экземпляром.

Атрибуты
SecurityCriticalAttribute

Исключения

InvalidOperationException

Вызывающий узел не подписан на конечную точку или еще не выполнял вызов метода RefreshData().

PeerToPeerException

Не удается завершить работу метода из-за ошибки в инфраструктуре совместной работы в одноранговой сети.

Комментарии

Эта функция предоставляется только в PeerContact классе . Эта функция не предоставляется ни одному другому типу одноранговых узлов по соображениям безопасности.

Если в одноранговом сеансе совместной работы не был создан экземпляр с PermissionStateUnrestricted, этот метод не может получить доступ к объектам на локальном компьютере. То же самое относится и к приложениям, зарегистрированным в сеансе совместной работы.

Коллекция одноранговых объектов состоит из приложения, объекта данных и сведений о присутствии для однорангового узла или конечной точки, указанных этим экземпляром. Если объекты для конечной точки не найдены, возвращается коллекция нулевого размера (0). Если вызывающий одноранговый узел подписан на эту конечную точку, кэш обновляется автоматически; в противном случае RefreshData должен вызываться перед вызовом этого метода.

Для успешного выполнения этого метода не требуется вход вызывающего объекта в инфраструктуру совместной работы. Успешный вызов RefreshData или один из Subscribe методов должен быть завершен, пока вызывающий объект выполнял вход до вызова этого метода.

ПРИМЕЧАНИЕ. Дополнительные перегрузки определяются в Peer классе вместо подклассов PeerContact и PeerNearMe.

См. также раздел

Применяется к

GetObjects(Guid)

Возвращает объект Peer, связанный с заданным идентификатором Guid, из коллекции 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

Параметры

objectId
Guid

Объект Guid объекта, Peer извлекаемого из коллекции.

Возвращаемое значение

PeerObjectCollection

Объект Peer, связанный с заданным идентификатором Guid. Если объект не найден, возвращается коллекция размера нуль (0) записей.

Атрибуты
SecurityCriticalAttribute

Исключения

ArgumentNullException

Идентификатор объекта равен пустой ссылке (null).

InvalidOperationException

Вызывающий узел не подписан на объект PeerEndPoint или еще не вызывал для конечной точки метод RefreshData().

PeerToPeerException

Произошла ошибка при получении от однорангового узла сведений об объекте.

Комментарии

Эта функция предоставляется только в PeerContact классе . Эта функция не предоставляется ни одному другому типу одноранговых узлов по соображениям безопасности.

Коллекция одноранговых объектов состоит из приложения, объекта данных и сведений о присутствии для однорангового узла или конечной точки, указанных этим экземпляром. Если объекты для конечной точки не найдены, возвращается коллекция нулевого размера (0). Когда вызывающий одноранговый узел подписан на эту конечную точку, кэш обновляется автоматически; в противном случае RefreshData должен вызываться перед вызовом этого метода.

Для успешного выполнения этого метода не требуется вход вызывающего объекта в инфраструктуру совместной работы. Успешный вызов RefreshData или один из Subscribe методов должен быть завершен, пока вызывающий объект выполнял вход до вызова этого метода. Для вызова этого метода требуется .PermissionStateUnrestricted Это состояние создается при запуске сеанса совместной работы.

ПРИМЕЧАНИЕ. Дополнительные перегрузки определяются в Peer классе вместо производных классов PeerContact и PeerNearMe.

См. также раздел

Применяется к