Peer.GetObjects Metodo

Definizione

Spazio dei nomi:

System.Net.PeerToPeer.Collaboration

Assembly:

System.Net.dll

Ottiene l'insieme di oggetti dati registrati dal peer da una cache locale.

Overload

GetObjects()	Ottiene l'insieme di oggetti dati da una cache locale.
GetObjects(Guid)	Ottiene dall'oggetto Peer l'oggetto Guid associato all'oggetto PeerObjectCollection fornito.

Commenti

Questa funzionalità è esposta solo nella PeerContact classe . Questa funzionalità non viene esposta in alcun altro tipo di peer per motivi di sicurezza.

Se non viene trovato alcun oggetto per l'endpoint, viene restituita una raccolta di dimensioni pari a zero (0).

GetObjects()

Ottiene l'insieme di oggetti dati da una cache locale.

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

Restituisce

PeerObjectCollection

Insieme PeerObject relativo al peer o all'endpoint specificato dall'istanza corrente.

Attributi

SecurityCriticalAttribute

Eccezioni

InvalidOperationException

Il chiamante non ha sottoscritto l'endpoint o non ha ancora chiamato il metodo RefreshData().

PeerToPeerException

Il metodo non è in grado di completare la propria esecuzione a causa di un errore nell'infrastruttura di collaborazione fra peer sottostante.

Commenti

Questa funzionalità è esposta solo nella PeerContact classe . Questa funzionalità non viene esposta in alcun altro tipo di peer per motivi di sicurezza.

Se la sessione di collaborazione peer non ha creato un'istanza di Unrestrictedcon , PermissionState questo metodo non può accedere agli oggetti nel computer locale. Lo stesso vale per le applicazioni registrate nella sessione di collaborazione.

La raccolta di oggetti peer è costituita da informazioni sull'applicazione, sull'oggetto dati e sulla presenza per il peer o l'endpoint specificato da questa istanza. Se non viene trovato alcun oggetto per l'endpoint, viene restituita una raccolta di dimensioni pari a zero (0). Se il peer chiamante viene sottoscritto a questo endpoint, la cache viene aggiornata automaticamente; in caso contrario RefreshData , deve essere chiamato prima di chiamare questo metodo.

Per completare correttamente questo metodo, non è necessario che il chiamante sia connesso all'infrastruttura di collaborazione. Una chiamata riuscita a RefreshData o uno dei Subscribe metodi deve essere stata completata mentre il chiamante è stato connesso in precedenza per chiamare questo metodo.

NOTA: nella classe vengono definiti Peer overload aggiuntivi anziché le sottoclassi PeerContact e PeerNearMe.

Vedi anche

• RefreshDataAsync(Object)
• RequestCachePolicy

GetObjects(Guid)

Ottiene dall'oggetto Peer l'oggetto Guid associato all'oggetto PeerObjectCollection fornito.

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

Parametri

objectId

Guid

Oggetto Guid dell'oggetto Peer da recuperare dall'insieme.

Restituisce

PeerObjectCollection

Oggetto Peer associato all'oggetto Guid fornito. Se non viene rilevato alcun oggetto, viene restituito un insieme avente dimensioni nulle.

Attributi

SecurityCriticalAttribute

Eccezioni

ArgumentNullException

L'oggetto ID è null.

InvalidOperationException

Il chiamante non ha sottoscritto l'oggetto PeerEndPoint o non ha ancora chiamato il metodo RefreshData() per tale oggetto.

PeerToPeerException

Si è verificato un errore durante l'ottenimento delle informazioni sull'oggetto dal peer.

Commenti

Questa funzionalità è esposta solo nella PeerContact classe . Questa funzionalità non viene esposta in alcun altro tipo di peer per motivi di sicurezza.

La raccolta di oggetti peer è costituita da informazioni sull'applicazione, sull'oggetto dati e sulla presenza per il peer o l'endpoint specificato da questa istanza. Se non viene trovato alcun oggetto per l'endpoint, viene restituita una raccolta di dimensioni pari a zero (0). Quando il peer chiamante viene sottoscritto a questo endpoint, la cache viene aggiornata automaticamente; in caso contrario RefreshData , deve essere chiamato prima di chiamare questo metodo.

Per completare correttamente questo metodo, non è necessario che il chiamante sia connesso all'infrastruttura di collaborazione. Una chiamata riuscita a RefreshData o uno dei Subscribe metodi deve essere stata completata mentre il chiamante è stato connesso in precedenza per chiamare questo metodo. Per chiamare questo metodo è necessario un PermissionState oggetto .Unrestricted Questo stato viene creato all'inizio della sessione di collaborazione.

NOTA: nella classe vengono definiti Peer overload aggiuntivi anziché le classi PeerContact derivate e PeerNearMe.

Vedi anche

• GetApplications
• Guid
• RefreshDataAsync(Object)