PeerContact Klasse

Definition

Stellt einen Peer dar, für den ein Benutzer erweiterte Informationen abgerufen hat.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
Vererbung
PeerContact
Attribute
Implementiert

Hinweise

Ein Kontakt stellt einen vertrauenswürdigen Peer dar.A contact represents a trusted peer. Ein PeerContact -Objekt muss für einen Remotepeer erstellt PeerNearMe werden, oder ein Benutzer muss mit dem Remotepeer zusammenarbeiten, wenn er sich außerhalb des Bereichs "Personen in meiner Umgebung" befindet.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. Ein PeerContact -Objekt kann entweder als Anwendung auf einem Remote Computer oder als Benutzer eines Remote Computers vorhanden sein.A PeerContact object can exist as either an application running on a remote computer, or the user of a remote computer. Eine Instanz dieser Klasse kann dem ContactManager hinzugefügt werden, wodurch die Kontaktinformationen permanent gespeichert werden.An instance of this class can be added to the ContactManager which stores the contact information in a persistent manner.

Eine Anwendungs Einladung von einem PeerContact wird sowohl authentifiziert als auch verschlüsselt.An application invitation from a PeerContact is both authenticated and encrypted. Das Dialogfeld der Benutzeroberfläche zum akzeptieren oder ablehnen einer Einladung von einem Peer Kontakt gibt auch an, dass der einladende vertrauenswürdig ist.The UI dialog to accept or reject an invitation from a peer contact also indicates that the inviter is trusted.

Das Abonnieren eines PeerContact -Objekts bedeutet, dass ein Remotepeer seine registrierten Anwendungen, Objekte und Anwesenheits Informationen anzeigen kann.Subscribing to a PeerContact object means a remote peer can see its registered applications, objects and presence information. Um einen PeerContactzu abonnieren, muss der Aufrufer über SignIn die Windows-Benutzeroberfläche bei der Peer Kollaborations Infrastruktur angemeldet oder über die Windows-Benutzeroberfläche angemeldet sein.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. Für alle anderen Vorgänge ist keine Anmeldung erforderlich.All other operations do not require sign-in.

Konstruktoren

PeerContact(SerializationInfo, StreamingContext)

Für diese Klasse ist kein öffentlicher Konstruktor definiert.No public constructor is defined for this class.

Eigenschaften

Credentials

Ruft das X509-Zertifikat (öffentlicher Schlüssel) für den von dieser PeerContact-Instanz identifizierten Peer ab oder legt dieses fest.Gets or sets the X509Certificate (public key) for the peer identified by this PeerContact instance.

DisplayName

Ruft eine Zeichenfolge ab, die den Anzeigenamen des PeerContact darstellt, oder legt diese fest.Gets or sets a string which represents the display name of the PeerContact.

EmailAddress

Ruft die dem PeerContact zugeordnete E-Mail-Adresse ab oder legt diese fest.Gets or sets the email address associated with the PeerContact.

IsOnline

Ruft einen Wert ab, der angibt, ob der Peer gegenwärtig "online" ist.Gets a value specifying if the Peer is currently 'online'.

(Geerbt von Peer)
IsSubscribed

Ruft einen Wert ab, der angibt, ob der aktuelle PeerContact für einen Endpunkt abonniert ist, oder legt diesen Wert fest.Gets or sets a value specifying whether the current PeerContact is subscribed or unsubscribed to an endpoint. Als Alternative ruft diese Eigenschaft einen Wert ab oder legt einen Wert fest, der angibt, ob der aktuelle Peerhost oder die aktuelle Hostanwendung diesen PeerContact abonniert hat.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

Ruft eine Zeichenfolge ab, die den Nickname des PeerContact darstellt, oder legt diese fest.Gets or sets a string which represents the Nickname of the PeerContact.

PeerEndPoints

Ruft den diesem PeerEndPointCollection zugeordneten PeerContact ab.Gets the PeerEndPointCollection associated with this PeerContact.

PeerName

Ruft den PeerName ab, der dem PeerContact zugeordnet ist, oder legt diesen fest.Gets or sets the PeerName associated with the PeerContact.

SubscribeAllowed

Ruft einen Wert ab, der angibt, ob der PeerContact für die Zusammenarbeitsereignisse verfügbar gemacht wird, die dem Peer oder der Anwendung zugeordnet sind, in dessen bzw. deren Besitz der ContactManager ist, in dem sich das PeerContact-Objekt befindet, oder legt diesen fest.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

Wenn dieser Eigenschaftswert festgelegt ist, werden für alle Ereignisse, die nicht aufgrund eines asynchronen Vorgangs ausgelöst werden, die zugeordneten Ereignishandler in dem Thread aufgerufen, in dem das spezifische SynchronizingObject erstellt wurde.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.

(Geerbt von Peer)

Methoden

Dispose()

Gibt alle vom Peer-Objekt verwendeten Ressourcen frei.Releases all resources used by the Peer object.

(Geerbt von Peer)
Dispose(Boolean)

Gibt die vom PeerApplication-Objekt verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources and optionally releases the managed resources used by the PeerApplication object.

Equals(Object)

Vergleicht die PeerContact-Instanz mit dem angegebenen Objekt.Compares the PeerContact instance to the specified object.

Equals(Object, Object)

Stellt fest, ob die angegebenen PeerContact-Instanzen als gleich betrachtet werden.Determines whether the specified PeerContact instances are considered equal.

Equals(Peer)

Vergleicht unter Berücksichtigung von Groß- und Kleinschreibung den aktuellen Peer mit dem angegebenen Peer.Performs a case-sensitive comparison of the current Peer and the specified peer.

(Geerbt von Peer)
Equals(PeerContact)

Vergleicht den PeerContact mit der angegebenen PeerContact-Instanz.Compares the PeerContact to the specified PeerContact instance.

FromXml(String)

Erstellt auf der Grundlage bereitgestellter XML-Daten eine PeerContact-Instanz.Creates a PeerContact instance based on provided XML data.

GetApplications()

Ruft die PeerApplication-Objekte ab, die vom Remotepeer im lokalen Cache registriert wurden.Retrieves the PeerApplication objects that were registered by the remote peer into the local cache.

GetApplications(Guid)

Ruft die Auflistung von PeerApplication-Objekten mit der angegebenen Guid aus dem lokalen Cache ab.Gets the collection of PeerApplication objects with the specified Guid from the local cache.

GetApplications(PeerEndPoint)

Ruft die PeerApplicationCollection ab, die dem angegebenen PeerEndPoint zugeordnet ist.Gets the PeerApplicationCollection associated with the specified PeerEndPoint.

GetApplications(PeerEndPoint, Guid)

Ruft die PeerApplicationCollection ab, die dem angegebenen PeerEndPoint zugeordnet ist.Gets the PeerApplicationCollection associated with the specified PeerEndPoint.

GetHashCode()

Gibt den Hashcode für eine PeerContact-Instanz zurück.Returns the hash code for a PeerContact instance.

GetObjectData(SerializationInfo, StreamingContext)

Füllt ein SerializationInfo-Objekt mit den Daten auf, die zum Serialisieren des PeerContact erforderlich sind.Populates a SerializationInfo object with the data needed to serialize the PeerContact.

GetObjects()

Ruft die Auflistung von Datenobjekten aus einem lokalen Cache ab.Gets the collection of data objects from a local cache.

(Geerbt von Peer)
GetObjects(Guid)

Ruft das Peer-Objekt ab, das der aus der Guid bereitgestellten PeerObjectCollection zugeordnet ist.Gets the Peer object associated with the supplied Guid from the PeerObjectCollection.

(Geerbt von Peer)
GetObjects(PeerEndPoint)

Ruft die PeerObjectCollection ab, die vom angegebenen PeerEndPoint registriert wurde und im lokalen Cache gespeichert ist.Gets the PeerObjectCollection registered by the specified PeerEndPoint and stored in the local cache.

GetObjects(PeerEndPoint, Guid)

Ruft die Auflistung von Peerobjekten ab, die von dem angegebenen PeerEndPoint registriert wurden und in der PeerApplication registriert sind, die durch die angegebene Guid identifiziert wird.Gets the collection of peer objects registered by the specified PeerEndPoint and registered in the PeerApplication identified by the specified Guid.

GetPresenceInfo(PeerEndPoint)

Ruft die verfügbaren Anwesenheitsinformationen für einen PeerEndPoint ab.Gets the available presence information for a PeerEndPoint.

(Geerbt von Peer)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
Invite()

Sendet eine Einladung zur Teilnahme an der Peerzusammenarbeit, die vom Absender gesponsert wird.Sends an invitation to join into peer collaboration sponsored by the sender.

Invite(PeerApplication, String, Byte[])

Sendet die angegebene Einladung zur Teilnahme an der angegebenen PeerApplication, die vom Absender gesponsert wird.Sends the specified invitation to join into the specified PeerApplication sponsored by the sender.

Invite(PeerEndPoint)

Sendet an einen bestimmten Endpunkt eine Einladung zur Peerzusammenarbeit mit dem Absender der Einladung.Sends an invitation to a specific endpoint to join into peer collaboration with the sender of the invitation.

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

Sendet die angegebene Einladung zur Teilnahme an der angegebenen PeerEndPoint-Anwendung, die vom Absender gesponsert wird, an den angegebenen PeerCollaboration.Sends the specified invitation to the specified PeerEndPoint to join into the specified PeerCollaboration application sponsored by the sender.

InviteAsync(Object)

Startet einen asynchronen Einladungsvorgang für einen angegebenen Endpunkt, um einer PeerCollaboration-Anwendung beizutreten, die vom Absender der Einladung gesponsert wird.Begins an asynchronous invitation operation for an endpoint to join a PeerCollaboration application sponsored by the sender of the invitation. Die Einladung wird mit dem angegebenen Object identifiziert.The invitation is identified using the specified Object.

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

Startet einen asynchronen Einladungsvorgang für die angegebenen Peerendpunkte, um der angegebenen PeerApplication für die Zusammenarbeit beizutreten, die vom Absender der Einladung gesponsert wird.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)

Startet einen asynchronen Einladungsvorgang für den angegebenen Peerendpunkt, um einer PeerCollaboration-Anwendung beizutreten, die vom Absender der Einladung gesponsert wird.Begins an asynchronous invitation operation for the specified peer endpoint to join a PeerCollaboration application sponsored by the sender of the invitation. Die Einladung wird mit dem angegebenen Object identifiziert.The invitation is identified using the specified Object.

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

Startet einen asynchronen Einladungsvorgang für den angegebenen peerEndPoint, um der angegebenen PeerApplication für die Zusammenarbeit beizutreten, die vom Absender der Einladung gesponsert wird.Begins an asynchronous invitation operation for the specified peerEndPoint to join the specified collaboration PeerApplication sponsored by the sender of the invitation.

InviteAsyncCancel(Object)

Bricht die Einladung ab, die mit der InviteAsync(PeerApplication, String, Byte[], Object)-Methode gesendet wurde.Cancels the invitation that was sent with the InviteAsync(PeerApplication, String, Byte[], Object) method.

(Geerbt von Peer)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnApplicationChanged(ApplicationChangedEventArgs)

Löst das ApplicationChanged-Ereignis aus.Raises the ApplicationChanged event.

OnInviteCompleted(InviteCompletedEventArgs)

Löst das InviteCompleted-Ereignis aus.Raises the InviteCompleted event.

(Geerbt von Peer)
OnObjectChanged(ObjectChangedEventArgs)

Löst das ObjectChanged-Ereignis bei Hinzufügen, Aktualisieren oder Entfernen eines PeerObject durch einen Remotepeer aus.Raises the ObjectChanged event when a PeerObject is added, updated or removed by a remote peer.

OnPresenceChanged(PresenceChangedEventArgs)

Löst das PresenceChanged-Ereignis aus, wenn PeerPresenceInfo ermittelt, dass der Peer geändert wurde.Raises the PresenceChanged event when the PeerPresenceInfo of a peer has changed.

OnSubscribeCompleted(SubscribeCompletedEventArgs)

Löst das SubscribeCompleted-Ereignis aus.Raises the SubscribeCompleted event.

Subscribe()

Abonniert den aufrufenden Peer für den PeerContact, und als Ergebnis empfängt der Peer ggf. zukünftige PeerCollaboration-Ereignisse, die mit dem PeerContact im Zusammenhang stehen.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)

Abonniert asynchron den aufrufenden Peer für den PeerContact, und als Ergebnis empfängt der Peer ggf. zukünftige PeerCollaboration-Ereignisse, die mit dem PeerContact im Zusammenhang stehen.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()

Gibt eine String-Darstellung des DisplayName zurück, der dem PeerContact zugeordnet ist.Returns a String representation of the DisplayName associated with the PeerContact.

ToXml()

Serialisiert den PeerContact in eine XML-Zeichenfolge für den permanenten Speicher oder die Netzwerkübertragung.Serializes the PeerContact to an XML string for persistent storage or network transfer.

Unsubscribe()

Entfernt ein Abonnement von PeerContact. Dadurch empfängt der aufrufende Peer keine PeerCollaboration-Ereignisse mehr, die dem PeerContact zugeordnet sind.Removes a subscription to the PeerContact and as a result the calling peer no longer receives PeerCollaboration events associated with the PeerContact.

Ereignisse

ApplicationChanged

Dieses Ereignis wird immer ausgelöst, wenn eine dem PeerContact zugeordnete Anwendung geändert wurde.This event is raised whenever an application associated with the PeerContact has changed.

InviteCompleted

Wird ausgelöst, wenn der Einladungsvorgang für einen Remotepeer abgeschlossen wurde.Raised when the invitation process for a remote peer has completed.

(Geerbt von Peer)
ObjectChanged

Dieses Ereignis wird immer signalisiert, wenn ein dem PeerObject zugeordnetes PeerContact geändert wurde.This event is signaled whenever a PeerObject associated with the PeerContact has changed.

PresenceChanged

Dieses Ereignis wird immer ausgelöst, wenn der Anwesenheitsstatus des PeerContact geändert wurde.This event is raised whenever the PeerContact has changed its presence status.

SubscribeCompleted

Wird ausgelöst, wenn ein Abonnementvorgang abgeschlossen wurde.Raised when a subscription operation has completed.

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Implementiert die ISerializable-Schnittstelle und gibt die zum Serialisieren der PeerContact-Instanz erforderlichen Daten zurück.Implements the ISerializable interface and returns the data needed to serialize the PeerContact instance.

Gilt für:

Siehe auch