PeerContact PeerContact PeerContact PeerContact Class

Definizione

Rappresenta un peer da cui un utente ha recuperato informazioni estese.Represents a peer for which a user has retrieved extended information.

public ref class PeerContact : System::Net::PeerToPeer::Collaboration::Peer, IEquatable<System::Net::PeerToPeer::Collaboration::PeerContact ^>, System::Runtime::Serialization::ISerializable
[System.Serializable]
public class PeerContact : System.Net.PeerToPeer.Collaboration.Peer, IEquatable<System.Net.PeerToPeer.Collaboration.PeerContact>, System.Runtime.Serialization.ISerializable
type PeerContact = class
    inherit Peer
    interface IEquatable<PeerContact>
    interface ISerializable
Public Class PeerContact
Inherits Peer
Implements IEquatable(Of PeerContact), ISerializable
Ereditarietà
PeerContactPeerContactPeerContactPeerContact
Attributi
Implementazioni

Commenti

Un contatto rappresenta un peer attendibile.A contact represents a trusted peer. È PeerContact necessario creare un oggetto per un peer remoto o PeerNearMe per un utente per collaborare con il peer remoto quando è esterno all'ambito "persone nelle vicinanze".A PeerContact object must be created for a remote peer or PeerNearMe for a user to collaborate with the remote peer when it is outside of the "People Near Me" scope. Un PeerContact oggetto può essere presente come un'applicazione in esecuzione in un computer remoto o l'utente di un computer remoto.A PeerContact object can exist as either an application running on a remote computer, or the user of a remote computer. È possibile aggiungere un'istanza di questa classe a ContactManager che archivia le informazioni di contatto in modo permanente.An instance of this class can be added to the ContactManager which stores the contact information in a persistent manner.

Un invito dell'applicazione da PeerContact un è autenticato e crittografato.An application invitation from a PeerContact is both authenticated and encrypted. La finestra di dialogo dell'interfaccia utente per accettare o rifiutare un invito da un contatto peer indica anche che l'invito è attendibile.The UI dialog to accept or reject an invitation from a peer contact also indicates that the inviter is trusted.

La sottoscrizione di un PeerContact oggetto indica che un peer remoto può visualizzare le applicazioni registrate, gli oggetti e le informazioni sulla presenza.Subscribing to a PeerContact object means a remote peer can see its registered applications, objects and presence information. Per sottoscrivere un PeerContact, il chiamante deve essere connesso all'infrastruttura di collaborazione peer tramite SignIn o connesso tramite l'interfaccia utente di Windows.To subscribe to a PeerContact, the caller must be signed in to the peer collaboration infrastructure via SignIn or signed in via the Windows UI. Tutte le altre operazioni non richiedono l'accesso.All other operations do not require sign-in.

Costruttori

PeerContact(SerializationInfo, StreamingContext) PeerContact(SerializationInfo, StreamingContext) PeerContact(SerializationInfo, StreamingContext) PeerContact(SerializationInfo, StreamingContext)

Per questa classe non è definito alcun costruttore pubblico.No public constructor is defined for this class.

Proprietà

Credentials Credentials Credentials Credentials

Ottiene o imposta il certificato X509Certificate (contenente la chiave pubblica) del peer identificato dall'istanza corrente della classe PeerContact.Gets or sets the X509Certificate (public key) for the peer identified by this PeerContact instance.

DisplayName DisplayName DisplayName DisplayName

Ottiene o imposta una stringa che rappresenta il nome visualizzato dell'oggetto PeerContact.Gets or sets a string which represents the display name of the PeerContact.

EmailAddress EmailAddress EmailAddress EmailAddress

Ottiene o imposta l'indirizzo di posta elettronica associato all'oggetto PeerContact.Gets or sets the email address associated with the PeerContact.

IsOnline IsOnline IsOnline IsOnline

Ottiene un valore che specifica se l'oggetto Peer è attualmente "online".Gets a value specifying if the Peer is currently 'online'.

(Inherited from Peer)
IsSubscribed IsSubscribed IsSubscribed IsSubscribed

Ottiene o imposta un valore che specifica se l'oggetto PeerContact corrente ha eseguito o ha annullato la sottoscrizione a un endpoint.Gets or sets a value specifying whether the current PeerContact is subscribed or unsubscribed to an endpoint. In alternativa, questa proprietà ottiene o imposta un valore che specifica se l'host peer o l'applicazione host corrente ha eseguito o ha annullato la sottoscrizione all'oggetto PeerContact.Alternatively, this property gets or sets a value specifying whether the current peer host or hosting application has subscribed or unsubscribed to this PeerContact.

Nickname Nickname Nickname Nickname

Ottiene o imposta una stringa che rappresenta l'oggetto Nickname del contatto PeerContact.Gets or sets a string which represents the Nickname of the PeerContact.

PeerEndPoints PeerEndPoints PeerEndPoints PeerEndPoints

Ottiene l'oggetto PeerEndPointCollection associato a questo oggetto PeerContact.Gets the PeerEndPointCollection associated with this PeerContact.

PeerName PeerName PeerName PeerName

Ottiene o imposta l'oggetto PeerName associato a PeerContact.Gets or sets the PeerName associated with the PeerContact.

SubscribeAllowed SubscribeAllowed SubscribeAllowed SubscribeAllowed

Ottiene o imposta un valore che specifica se l'oggetto PeerContact è esposto agli eventi di collaborazione associati al peer o all'applicazione proprietaria dell'oggetto ContactManager contenente tale PeerContact.Gets or sets a value that specifies whether the PeerContact is exposed to the collaboration events associated with the peer or application that has ownership of the ContactManager in which this PeerContact object resides.

SynchronizingObject SynchronizingObject SynchronizingObject SynchronizingObject

Quando si imposta questo valore di proprietà, i gestori eventi di tutti gli eventi non generati a seguito di un'operazione asincrona verranno richiamati nel thread che ha creato l'oggetto SynchronizingObject specifico.When this property value is set, all events not fired as the result of an asynchronous operation will have the associated event handlers called back on the thread that created the specific SynchronizingObject.

(Inherited from Peer)

Metodi

Dispose() Dispose() Dispose() Dispose()

Rilascia tutte le risorse usate dall'oggetto Peer.Releases all resources used by the Peer object.

(Inherited from Peer)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Rilascia le risorse non gestite ed eventualmente le risorse gestite usate dall'oggetto PeerApplication.Releases the unmanaged resources and optionally releases the managed resources used by the PeerApplication object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Confronta l'istanza della classe PeerContact con l'oggetto specificato.Compares the PeerContact instance to the specified object.

Equals(Object, Object) Equals(Object, Object) Equals(Object, Object) Equals(Object, Object)

Determina se le istanze di PeerContact specificate sono considerate uguali.Determines whether the specified PeerContact instances are considered equal.

Equals(Peer) Equals(Peer) Equals(Peer) Equals(Peer)

Esegue un confronto con distinzione tra maiuscole e minuscole fra l'oggetto Peer corrente e il peer specificato.Performs a case-sensitive comparison of the current Peer and the specified peer.

(Inherited from Peer)
Equals(PeerContact) Equals(PeerContact) Equals(PeerContact) Equals(PeerContact)

Confronta l'oggetto PeerContact con l'istanza specificata della classe PeerContact.Compares the PeerContact to the specified PeerContact instance.

FromXml(String) FromXml(String) FromXml(String) FromXml(String)

Crea un'istanza della classe PeerContact basata sui dati XML forniti.Creates a PeerContact instance based on provided XML data.

GetApplications() GetApplications() GetApplications() GetApplications()

Recupera gli oggetti PeerApplication registrati dal peer remoto nella cache locale.Retrieves the PeerApplication objects that were registered by the remote peer into the local cache.

GetApplications(Guid) GetApplications(Guid) GetApplications(Guid) GetApplications(Guid)

Ottiene l'insieme di oggetti PeerApplication aventi l'oggetto Guid specificato recuperato dalla cache locale.Gets the collection of PeerApplication objects with the specified Guid from the local cache.

GetApplications(PeerEndPoint) GetApplications(PeerEndPoint) GetApplications(PeerEndPoint) GetApplications(PeerEndPoint)

Ottiene l'oggetto PeerApplicationCollection associato all'oggetto PeerEndPoint specificato.Gets the PeerApplicationCollection associated with the specified PeerEndPoint.

GetApplications(PeerEndPoint, Guid) GetApplications(PeerEndPoint, Guid) GetApplications(PeerEndPoint, Guid) GetApplications(PeerEndPoint, Guid)

Ottiene l'oggetto PeerApplicationCollection associato all'oggetto PeerEndPoint specificato.Gets the PeerApplicationCollection associated with the specified PeerEndPoint.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Restituisce il codice hash di un'istanza della classe PeerContact.Returns the hash code for a PeerContact instance.

GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Popola un oggetto SerializationInfo con i dati necessari per serializzare PeerContact.Populates a SerializationInfo object with the data needed to serialize the PeerContact.

GetObjects() GetObjects() GetObjects() GetObjects()

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

(Inherited from Peer)
GetObjects(Guid) GetObjects(Guid) GetObjects(Guid) 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.

(Inherited from Peer)
GetObjects(PeerEndPoint) GetObjects(PeerEndPoint) GetObjects(PeerEndPoint) GetObjects(PeerEndPoint)

Ottiene l'oggetto PeerObjectCollection registrato dall'oggetto PeerEndPoint specificato e archiviato nella cache locale.Gets the PeerObjectCollection registered by the specified PeerEndPoint and stored in the local cache.

GetObjects(PeerEndPoint, Guid) GetObjects(PeerEndPoint, Guid) GetObjects(PeerEndPoint, Guid) GetObjects(PeerEndPoint, Guid)

Ottiene l'insieme di oggetti peer registrati dall'oggetto PeerEndPoint specificato e registrati nell'oggetto PeerApplication identificata dall'oggetto Guid indicato.Gets the collection of peer objects registered by the specified PeerEndPoint and registered in the PeerApplication identified by the specified Guid.

GetPresenceInfo(PeerEndPoint) GetPresenceInfo(PeerEndPoint) GetPresenceInfo(PeerEndPoint) GetPresenceInfo(PeerEndPoint)

Ottiene le informazioni disponibili sulla presenza di un PeerEndPoint.Gets the available presence information for a PeerEndPoint.

(Inherited from Peer)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
Invite() Invite() Invite() Invite()

Invia un invito a partecipare alla sessione di collaborazione fra peer sponsorizzata dal mittente.Sends an invitation to join into peer collaboration sponsored by the sender.

Invite(PeerApplication, String, Byte[]) Invite(PeerApplication, String, Byte[]) Invite(PeerApplication, String, Byte[]) Invite(PeerApplication, String, Byte[])

Invia l'invito specificato a partecipare all'oggetto PeerApplication indicato sponsorizzato dal mittente.Sends the specified invitation to join into the specified PeerApplication sponsored by the sender.

Invite(PeerEndPoint) Invite(PeerEndPoint) Invite(PeerEndPoint) Invite(PeerEndPoint)

Invia a un endpoint specifico un invito a partecipare a una sessione di collaborazione fra peer con il mittente dell'invito.Sends an invitation to a specific endpoint to join into peer collaboration with the sender of the invitation.

Invite(PeerEndPoint, PeerApplication, String, Byte[]) Invite(PeerEndPoint, PeerApplication, String, Byte[]) Invite(PeerEndPoint, PeerApplication, String, Byte[]) Invite(PeerEndPoint, PeerApplication, String, Byte[])

Invia all'oggetto PeerEndPoint indicato l'invito specificato a partecipare all'oggetto PeerCollaboration fornita sponsorizzata dal mittente.Sends the specified invitation to the specified PeerEndPoint to join into the specified PeerCollaboration application sponsored by the sender.

InviteAsync(Object) InviteAsync(Object) InviteAsync(Object) InviteAsync(Object)

Inizia un'operazione asincrona per invitare un endpoint a partecipare a un'applicazione PeerCollaboration sponsorizzata dal mittente dell'invito.Begins an asynchronous invitation operation for an endpoint to join a PeerCollaboration application sponsored by the sender of the invitation. L'invito è identificato dall'istanza di Object specificata.The invitation is identified using the specified Object.

InviteAsync(PeerApplication, String, Byte[], Object) InviteAsync(PeerApplication, String, Byte[], Object) InviteAsync(PeerApplication, String, Byte[], Object) InviteAsync(PeerApplication, String, Byte[], Object)

Inizia un'operazione asincrona per invitare gli endpoint peer specificati a partecipare a una determinata applicazione PeerApplication di collaborazione sponsorizzata dal mittente dell'invito.Begins an asynchronous invitation operation for the specified peer endpoints to join the specified collaboration PeerApplication sponsored by the sender of the invitation.

InviteAsync(PeerEndPoint, Object) InviteAsync(PeerEndPoint, Object) InviteAsync(PeerEndPoint, Object) InviteAsync(PeerEndPoint, Object)

Inizia un'operazione asincrona per invitare l'endpoint peer specificato a partecipare a un'applicazione PeerCollaboration sponsorizzata dal mittente dell'invito.Begins an asynchronous invitation operation for the specified peer endpoint to join a PeerCollaboration application sponsored by the sender of the invitation. L'invito è identificato dall'istanza di Object specificata.The invitation is identified using the specified Object.

InviteAsync(PeerEndPoint, String, Byte[], PeerApplication, Object) InviteAsync(PeerEndPoint, String, Byte[], PeerApplication, Object) InviteAsync(PeerEndPoint, String, Byte[], PeerApplication, Object) InviteAsync(PeerEndPoint, String, Byte[], PeerApplication, Object)

Inizia un'operazione asincrona per invitare gli oggetti peerEndPoint specificati a partecipare a una determinata applicazione PeerApplication di collaborazione sponsorizzata dal mittente dell'invito.Begins an asynchronous invitation operation for the specified peerEndPoint to join the specified collaboration PeerApplication sponsored by the sender of the invitation.

InviteAsyncCancel(Object) InviteAsyncCancel(Object) InviteAsyncCancel(Object) InviteAsyncCancel(Object)

Annulla l'invito inviato tramite il metodo InviteAsync(PeerApplication, String, Byte[], Object).Cancels the invitation that was sent with the InviteAsync(PeerApplication, String, Byte[], Object) method.

(Inherited from Peer)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
OnApplicationChanged(ApplicationChangedEventArgs) OnApplicationChanged(ApplicationChangedEventArgs) OnApplicationChanged(ApplicationChangedEventArgs) OnApplicationChanged(ApplicationChangedEventArgs)

Genera l'evento ApplicationChanged.Raises the ApplicationChanged event.

OnInviteCompleted(InviteCompletedEventArgs) OnInviteCompleted(InviteCompletedEventArgs) OnInviteCompleted(InviteCompletedEventArgs) OnInviteCompleted(InviteCompletedEventArgs)

Genera l'evento InviteCompleted.Raises the InviteCompleted event.

(Inherited from Peer)
OnObjectChanged(ObjectChangedEventArgs) OnObjectChanged(ObjectChangedEventArgs) OnObjectChanged(ObjectChangedEventArgs) OnObjectChanged(ObjectChangedEventArgs)

Genera l'evento ObjectChanged quando un oggetto PeerObject viene aggiunto, aggiornato o rimosso da un peer remoto.Raises the ObjectChanged event when a PeerObject is added, updated or removed by a remote peer.

OnPresenceChanged(PresenceChangedEventArgs) OnPresenceChanged(PresenceChangedEventArgs) OnPresenceChanged(PresenceChangedEventArgs) OnPresenceChanged(PresenceChangedEventArgs)

Genera l'evento PresenceChanged quando l'oggetto PeerPresenceInfo di un peer è stato modificato.Raises the PresenceChanged event when the PeerPresenceInfo of a peer has changed.

OnSubscribeCompleted(SubscribeCompletedEventArgs) OnSubscribeCompleted(SubscribeCompletedEventArgs) OnSubscribeCompleted(SubscribeCompletedEventArgs) OnSubscribeCompleted(SubscribeCompletedEventArgs)

Genera l'evento SubscribeCompleted.Raises the SubscribeCompleted event.

Subscribe() Subscribe() Subscribe() Subscribe()

Esegue la sottoscrizione del peer chiamante all'oggetto PeerContact e, di conseguenza, il peer riceverà gli eventi PeerCollaboration futuri associati all'oggetto PeerContact.Subscribes the calling peer to the PeerContact, and as a result, the peer will receive any future PeerCollaboration events associated with the PeerContact.

SubscribeAsync(Object) SubscribeAsync(Object) SubscribeAsync(Object) SubscribeAsync(Object)

Esegue la sottoscrizione asincrona del peer chiamante all'oggetto PeerContact e, di conseguenza, il peer riceverà gli eventi PeerCollaboration futuri associati all'oggetto PeerContact.Asynchronously subscribes the calling peer to the PeerContact, and as a result, the peer will receive any future PeerCollaboration events associated with the PeerContact.

ToString() ToString() ToString() ToString()

Restituisce una rappresentazione di tipo String dell'oggetto DisplayName associato all'oggetto PeerContact.Returns a String representation of the DisplayName associated with the PeerContact.

ToXml() ToXml() ToXml() ToXml()

Serializza l'oggetto PeerContact in una stringa XML per eseguirne l'archiviazione persistente o il trasferimento su rete.Serializes the PeerContact to an XML string for persistent storage or network transfer.

Unsubscribe() Unsubscribe() Unsubscribe() Unsubscribe()

Rimuove la sottoscrizione all'oggetto PeerContact. Di conseguenza, il peer chiamante non riceverà più gli eventi relativi all'oggetto PeerCollaboration associati all'oggetto PeerContact.Removes a subscription to the PeerContact and as a result the calling peer no longer receives PeerCollaboration events associated with the PeerContact.

Eventi

ApplicationChanged ApplicationChanged ApplicationChanged ApplicationChanged

Questo evento viene generato ogni volta che un'applicazione associata all'oggetto PeerContact viene modificata.This event is raised whenever an application associated with the PeerContact has changed.

InviteCompleted InviteCompleted InviteCompleted InviteCompleted

Generato quando il processo di invito relativo a un peer remoto è stato completato.Raised when the invitation process for a remote peer has completed.

(Inherited from Peer)
ObjectChanged ObjectChanged ObjectChanged ObjectChanged

Questo evento viene segnalato ogni volta che un PeerObject associato all'oggetto PeerContact viene modificato.This event is signaled whenever a PeerObject associated with the PeerContact has changed.

PresenceChanged PresenceChanged PresenceChanged PresenceChanged

Questo evento viene generato ogni volta che l'oggetto PeerContact modifica il proprio stato di presenza.This event is raised whenever the PeerContact has changed its presence status.

SubscribeCompleted SubscribeCompleted SubscribeCompleted SubscribeCompleted

Viene generato al termine di un'operazione di sottoscrizione.Raised when a subscription operation has completed.

Implementazioni dell'interfaccia esplicita

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Implementa l'interfaccia ISerializable e restituisce i dati necessari a serializzare l'istanza di PeerContact.Implements the ISerializable interface and returns the data needed to serialize the PeerContact instance.

Si applica a

Vedi anche