Peer.GetObjects Metodo

Definizione

Ottiene l'insieme di oggetti dati registrati dal peer da una cache locale.Gets the collection of data objects that were registered by the peer from a local cache.

Overload

GetObjects()

Ottiene l'insieme di oggetti dati da una cache locale.Gets the collection of data objects from a local cache.

GetObjects(Guid)

Ottiene dall'oggetto Peer l'oggetto Guid associato all'oggetto PeerObjectCollection fornito.Gets the Peer object associated with the supplied Guid from the PeerObjectCollection.

Commenti

Questa funzionalità è esposta solo sulla PeerContact classe.This functionality is only exposed on the PeerContact class. Questa funzionalità non è esposta ad altri tipi di peer per motivi di sicurezza.This functionality is not exposed on any other type of peer for security reasons.

Se non viene trovato alcun oggetto per l'endpoint, viene restituita una raccolta di dimensioni pari a zero (0).If no objects are found for the endpoint, a collection of size zero (0) is returned.

GetObjects()

Ottiene l'insieme di oggetti dati da una cache locale.Gets the collection of data objects from a local cache.

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

Restituisce

Insieme PeerObject relativo al peer o all'endpoint specificato dall'istanza corrente.The PeerObject collection for the peer or endpoint specified by this instance.

Attributi

Eccezioni

Il chiamante non ha sottoscritto l'endpoint o non ha ancora chiamato il metodo RefreshData().The caller is not subscribed to the endpoint or has not yet called RefreshData().

Il metodo non è in grado di completare la propria esecuzione a causa di un errore nell'infrastruttura di collaborazione fra peer sottostante.The method is unable to complete due to an error in the underlying Peer Collaboration infrastructure.

Commenti

Questa funzionalità è esposta solo sulla PeerContact classe.This functionality is only exposed on the PeerContact class. Questa funzionalità non è esposta ad altri tipi di peer per motivi di sicurezza.This functionality is not exposed on any other type of peer for security reasons.

Se la sessione PermissionState di collaborazione tra peer non ha creato un'istanza Unrestricteddi, questo metodo non può accedere agli oggetti nel computer locale.If the peer collaboration session did not instantiate with a PermissionState of Unrestricted, this method cannot access objects on the local computer. Lo stesso vale per le applicazioni registrate nella sessione di collaborazione.The same is true of the applications registered into the collaboration session.

La raccolta di oggetti peer è costituita da informazioni su applicazione, oggetto dati e presenza per il peer o l'endpoint specificato da questa istanza.The collection of peer objects consists of application, data object, and presence information for the peer or endpoint specified by this instance. Se non viene trovato alcun oggetto per l'endpoint, viene restituita una raccolta di dimensioni pari a zero (0).If no objects are found for the endpoint, a collection of size zero (0) is returned. Se il peer chiamante ha effettuato la sottoscrizione a questo endpoint, la cache viene aggiornata automaticamente. in RefreshData caso contrario, deve essere chiamato prima di chiamare questo metodo.If the calling peer is subscribed to this endpoint, the cache is automatically updated; otherwise RefreshData must be called prior to calling this method.

Il chiamante non deve essere connesso all'infrastruttura di collaborazione affinché questo metodo venga completato correttamente.The caller is not required to be signed into the collaboration infrastructure for this method to complete successfully. Una chiamata riuscita a RefreshData o a uno Subscribe dei metodi deve essere stata completata mentre il chiamante ha eseguito l'accesso precedente alla chiamata a questo metodo.A successful call to RefreshData or one of the Subscribe methods must have been completed while the caller was signed in previous to calling this method.

NOTA: Per la Peer classe vengono definiti overload aggiuntivi anziché le PeerContact sottoclassi e PeerNearMe.NOTE: Additional overloads are defined on the Peer class instead of the subclasses PeerContact and PeerNearMe.

Vedi anche

GetObjects(Guid)

Ottiene dall'oggetto Peer l'oggetto Guid associato all'oggetto PeerObjectCollection fornito.Gets the Peer object associated with the supplied Guid from the PeerObjectCollection.

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

Parametri

objectId
Guid

Oggetto Guid dell'oggetto Peer da recuperare dall'insieme.The Guid of the Peer object to be retrieved from the collection

Restituisce

Oggetto Peer associato all'oggetto Guid fornito.Peer object associated with the supplied Guid. Se non viene rilevato alcun oggetto, viene restituito un insieme avente dimensioni nulle.If an object is not found, a collection of size zero (0) is returned.

Attributi

Eccezioni

L'oggetto ID è null.The object ID is null.

Il chiamante non ha sottoscritto l'oggetto PeerEndPoint o non ha ancora chiamato il metodo RefreshData() per tale oggetto.The caller is not subscribed to the PeerEndPoint or has not yet called RefreshData() against it.

Si è verificato un errore durante l'ottenimento delle informazioni sull'oggetto dal peer.An error occurred when getting object information from the peer.

Commenti

Questa funzionalità è esposta solo sulla PeerContact classe.This functionality is only exposed on the PeerContact class. Questa funzionalità non è esposta ad altri tipi di peer per motivi di sicurezza.This functionality is not exposed on any other type of peer for security reasons.

La raccolta di oggetti peer è costituita da informazioni su applicazione, oggetto dati e presenza per il peer o l'endpoint specificato da questa istanza.The collection of peer objects consists of application, data object, and presence information for the peer or endpoint specified by this instance. Se non viene trovato alcun oggetto per l'endpoint, viene restituita una raccolta di dimensioni pari a zero (0).If no objects are found for the endpoint, a collection of size zero (0) is returned. Quando il peer chiamante ha effettuato la sottoscrizione a questo endpoint, la cache viene aggiornata automaticamente. in RefreshData caso contrario, deve essere chiamato prima di chiamare questo metodo.When the calling peer is subscribed to this endpoint, the cache is automatically updated; otherwise RefreshData must be called prior to calling this method.

Il chiamante non deve essere connesso all'infrastruttura di collaborazione affinché questo metodo venga completato correttamente.The caller is not required to be signed into the collaboration infrastructure for this method to complete successfully. Una chiamata riuscita a RefreshData o a uno Subscribe dei metodi deve essere stata completata mentre il chiamante ha eseguito l'accesso precedente alla chiamata a questo metodo.A successful call to RefreshData or one of the Subscribe methods must have been completed while the caller was signed in previous to calling this method. La chiamata a questo metodo PermissionState richiede Unrestrictedun di.Calling this method requires a PermissionState of Unrestricted. Questo stato viene creato all'inizio della sessione di collaborazione.This state is created when the collaboration session begins.

NOTA: Per la Peer classe vengono definiti overload aggiuntivi anziché le classi PeerContact derivate e PeerNearMe.NOTE: Additional overloads are defined on the Peer class instead of the derived classes PeerContact and PeerNearMe.

Vedi anche

Si applica a