Peer.GetObjects Méthode

Définition

Espace de noms:

System.Net.PeerToPeer.Collaboration

Assembly:

System.Net.dll

Obtient la collection des objets de donnée inscrits par l'homologue d'un cache local.

Surcharges

GetObjects()	Obtient la collection des objets de données d'un cache local.
GetObjects(Guid)	Obtient l'objet Peer associé au Guid fourni à partir du PeerObjectCollection.

Remarques

Cette fonctionnalité n’est exposée que sur la PeerContact classe . Cette fonctionnalité n’est exposée sur aucun autre type d’homologue pour des raisons de sécurité.

Si aucun objet n’est trouvé pour le point de terminaison, une collection de taille zéro (0) est retournée.

GetObjects()

Obtient la collection des objets de données d'un cache local.

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

Retours

PeerObjectCollection

Collection PeerObject pour l'homologue ou le point de terminaison spécifié par cette instance.

Attributs

SecurityCriticalAttribute

Exceptions

InvalidOperationException

L'appelant n'est pas abonné au point de terminaison ou n'a pas encore appelé RefreshData().

PeerToPeerException

La méthode ne peut pas se terminer en raison d'une erreur dans l'infrastructure de collaboration pair à pair sous-jacente.

Remarques

Cette fonctionnalité n’est exposée que sur la PeerContact classe . Cette fonctionnalité n’est exposée sur aucun autre type d’homologue pour des raisons de sécurité.

Si la session de collaboration d’homologue n’a pas instancié avec un PermissionState de Unrestricted, cette méthode ne peut pas accéder aux objets sur l’ordinateur local. Il en va de même pour les applications inscrites dans la session de collaboration.

La collection d’objets homologues se compose d’informations d’application, d’objet de données et de présence pour l’homologue ou le point de terminaison spécifié par cette instance. Si aucun objet n’est trouvé pour le point de terminaison, une collection de taille zéro (0) est retournée. Si l’homologue appelant est abonné à ce point de terminaison, le cache est automatiquement mis à jour ; dans le cas contraire RefreshData , vous devez être appelé avant d’appeler cette méthode.

L’appelant n’est pas obligé d’être connecté à l’infrastructure de collaboration pour que cette méthode se termine correctement. Un appel réussi à ou à RefreshData l’une Subscribe des méthodes doit avoir été effectué pendant que l’appelant a été connecté avant d’appeler cette méthode.

REMARQUE : Des surcharges supplémentaires sont définies sur la Peer classe au lieu des sous-classes PeerContact et PeerNearMe.

Voir aussi

• RefreshDataAsync(Object)
• RequestCachePolicy

GetObjects(Guid)

Obtient l'objet Peer associé au Guid fourni à partir du 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

Paramètres

objectId

Guid

Guid de l’objet Peer à récupérer à partir de la collection.

Retours

PeerObjectCollection

Objet Peer associé au Guid fourni. Si un objet est introuvable, une collection de taille zéro (0) est retournée.

Attributs

SecurityCriticalAttribute

Exceptions

ArgumentNullException

L'ID d'objet est null.

InvalidOperationException

L'appelant n'est pas abonné au PeerEndPoint ou n'a pas encore appelé RefreshData().

PeerToPeerException

Une erreur s'est produite lors de l'obtention des informations d'objet de l'homologue.

Remarques

Cette fonctionnalité n’est exposée que sur la PeerContact classe . Cette fonctionnalité n’est exposée sur aucun autre type d’homologue pour des raisons de sécurité.

La collection d’objets homologues se compose d’informations d’application, d’objet de données et de présence pour l’homologue ou le point de terminaison spécifié par cette instance. Si aucun objet n’est trouvé pour le point de terminaison, une collection de taille zéro (0) est retournée. Lorsque l’homologue appelant est abonné à ce point de terminaison, le cache est automatiquement mis à jour ; dans le cas contraire RefreshData , vous devez être appelé avant d’appeler cette méthode.

L’appelant n’est pas obligé d’être connecté à l’infrastructure de collaboration pour que cette méthode se termine correctement. Un appel réussi à ou à RefreshData l’une Subscribe des méthodes doit avoir été effectué pendant que l’appelant a été connecté avant d’appeler cette méthode. L’appel de cette méthode nécessite un PermissionState de Unrestricted. Cet état est créé lorsque la session de collaboration commence.

REMARQUE : Des surcharges supplémentaires sont définies sur la Peer classe au lieu des classes PeerContact dérivées et PeerNearMe.

Voir aussi

• GetApplications
• Guid
• RefreshDataAsync(Object)