PeerContact Класс

Определение

Представляет одноранговый узел, для которого пользователь получил расширенные сведения.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
Наследование
PeerContact
Атрибуты
Реализации

Комментарии

Контакт представляет доверенный одноранговый узел.A contact represents a trusted peer. Объект PeerContact должен быть создан для удаленного однорангового узла или PeerNearMe для совместной работы пользователя с удаленным одноранговым узлом, если он находится за пределами области "Соседние пользователи".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. Объект PeerContact может существовать как приложение, выполняющееся на удаленном компьютере, либо пользователь удаленного компьютера.A PeerContact object can exist as either an application running on a remote computer, or the user of a remote computer. Экземпляр этого класса можно добавить в ContactManager, который хранит контактные данные постоянным способом.An instance of this class can be added to the ContactManager which stores the contact information in a persistent manner.

Приглашение приложения из PeerContact проверяется и шифруется.An application invitation from a PeerContact is both authenticated and encrypted. Диалоговое окно пользовательского интерфейса для принятия или отклонения приглашения от однорангового контакта также указывает на то, что приглашающий является доверенным.The UI dialog to accept or reject an invitation from a peer contact also indicates that the inviter is trusted.

Подписка на PeerContact объект означает, что удаленный одноранговый узел может видеть зарегистрированные приложения, объекты и сведения о присутствии.Subscribing to a PeerContact object means a remote peer can see its registered applications, objects and presence information. Чтобы подписываться на PeerContact, вызывающий объект должен войти в инфраструктуру совместной работы в одноранговой сети с помощью SignIn или войти через пользовательский интерфейс 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. Для всех остальных операций вход не требуется.All other operations do not require sign-in.

Конструкторы

PeerContact(SerializationInfo, StreamingContext)

На основе этого класса не определены открытые конструкторы.No public constructor is defined for this class.

Свойства

Credentials

Возвращает или задает сертификат X509Certificate (открытый ключ) для однорангового узла, определенного экземпляром класса PeerContact.Gets or sets the X509Certificate (public key) for the peer identified by this PeerContact instance.

DisplayName

Возвращает или задает строку, представляющую отображаемое имя объекта PeerContact.Gets or sets a string which represents the display name of the PeerContact.

EmailAddress

Возвращает или задает адрес электронной почты, связанный с объектом PeerContact.Gets or sets the email address associated with the PeerContact.

IsOnline

Возвращает значение, определяющее, находится ли одноранговый узел Peer в сети в текущий момент.Gets a value specifying if the Peer is currently 'online'.

(Унаследовано от Peer)
IsSubscribed

Возвращает или задает значение, определяющее, является ли текущий объект PeerContact подписанным на конечную точка, или нет.Gets or sets a value specifying whether the current PeerContact is subscribed or unsubscribed to an endpoint. Также это свойство возвращает или задает значение, определяющее, является ли текущий ведущий узел одноранговой сети или ведущее приложении подписанным или неподписанным на данный объект 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 (псевдоним) объекта PeerContact.Gets or sets a string which represents the Nickname of the PeerContact.

PeerEndPoints

Возвращает объект PeerEndPointCollection, связанный с этим объектом PeerContact.Gets the PeerEndPointCollection associated with this PeerContact.

PeerName

Возвращает или задает объект PeerName, связанный с объектом PeerContact.Gets or sets the PeerName associated with the PeerContact.

SubscribeAllowed

Возвращает или задает значение, определяющее, является ли объект PeerContact доступным для событий совместной работы, связанных с одноранговым узлом или приложением, владеющими объектом ContactManager, в котором находится данный объект 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.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.

(Унаследовано от Peer)

Методы

Dispose()

Освобождает все ресурсы, используемые объектом Peer.Releases all resources used by the Peer object.

(Унаследовано от Peer)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом PeerApplication (при необходимости освобождает и управляемые ресурсы).Releases the unmanaged resources and optionally releases the managed resources used by the PeerApplication object.

Equals(Object)

Сравнивает экземпляр класса PeerContact с указанным объектом.Compares the PeerContact instance to the specified object.

Equals(Object, Object)

Определяет, считаются ли равными указанные экземпляры PeerContact.Determines whether the specified PeerContact instances are considered equal.

Equals(Peer)

Выполняет сравнение текущего объекта Peer с указанным одноранговым узелом, учитывая регистр символов.Performs a case-sensitive comparison of the current Peer and the specified peer.

(Унаследовано от Peer)
Equals(PeerContact)

Сравнивает объект PeerContact с заданным экземпляром PeerContact.Compares the PeerContact to the specified PeerContact instance.

FromXml(String)

Создает экземпляр класса PeerContact на основе предоставленных данных в формате XML.Creates a PeerContact instance based on provided XML data.

GetApplications()

Получает объекты PeerApplication, зарегистрированные удаленным одноранговым узлом в локальном кэше.Retrieves the PeerApplication objects that were registered by the remote peer into the local cache.

GetApplications(Guid)

Возвращает коллекцию объектов PeerApplication с указанным идентификатором Guid из локального кэша.Gets the collection of PeerApplication objects with the specified Guid from the local cache.

GetApplications(PeerEndPoint)

Получает класс PeerApplicationCollection, связанный с заданным PeerEndPoint.Gets the PeerApplicationCollection associated with the specified PeerEndPoint.

GetApplications(PeerEndPoint, Guid)

Получает объект PeerApplicationCollection, связанный с заданным объектом PeerEndPoint.Gets the PeerApplicationCollection associated with the specified PeerEndPoint.

GetHashCode()

Возвращает хэш-код экземпляра класса PeerContact.Returns the hash code for a PeerContact instance.

GetObjectData(SerializationInfo, StreamingContext)

Заполняет объект SerializationInfo данными, необходимыми для сериализации PeerContact.Populates a SerializationInfo object with the data needed to serialize the PeerContact.

GetObjects()

Возвращает коллекцию объектов данных из локального кэша.Gets the collection of data objects from a local cache.

(Унаследовано от Peer)
GetObjects(Guid)

Возвращает объект Peer, связанный с заданным идентификатором Guid, из коллекции PeerObjectCollection.Gets the Peer object associated with the supplied Guid from the PeerObjectCollection.

(Унаследовано от Peer)
GetObjects(PeerEndPoint)

Возвращает объект PeerObjectCollection, зарегистрированный указанным объектом PeerEndPoint и хранящийся в локальном кэше.Gets the PeerObjectCollection registered by the specified PeerEndPoint and stored in the local cache.

GetObjects(PeerEndPoint, Guid)

Возвращает коллекцию объектов одноранговых узлов, зарегистрированных указанным объектом PeerEndPoint, и зарегистрированных в объекте PeerApplication, определенном заданным идентификатором Guid.Gets the collection of peer objects registered by the specified PeerEndPoint and registered in the PeerApplication identified by the specified Guid.

GetPresenceInfo(PeerEndPoint)

Возвращает доступные сведения о присутствии для объекта PeerEndPoint.Gets the available presence information for a PeerEndPoint.

(Унаследовано от Peer)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
Invite()

Отправляет приглашение на присоединение к совместной работе в одноранговой сети, инициатором которой является отправитель.Sends an invitation to join into peer collaboration sponsored by the sender.

Invite(PeerApplication, String, Byte[])

Отправляет указанное приглашение на присоединение к указанному объекту PeerApplication, инициированному отправителем.Sends the specified invitation to join into the specified PeerApplication sponsored by the sender.

Invite(PeerEndPoint)

Отправляет определенной конечной точке приглашение на присоединение к совместной работе в одноранговой сети вместе с отправителем приглашения.Sends an invitation to a specific endpoint to join into peer collaboration with the sender of the invitation.

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

Отправляет заданному объекту PeerEndPoint заданное приглашение на присоединение к заданному приложению PeerCollaboration, инициированному отправителем.Sends the specified invitation to the specified PeerEndPoint to join into the specified PeerCollaboration application sponsored by the sender.

InviteAsync(Object)

Начинает асинхронную операцию приглашения конечной точки на присоединение к приложению PeerCollaboration, инициированному отправителем приглашения.Begins an asynchronous invitation operation for an endpoint to join a PeerCollaboration application sponsored by the sender of the invitation. Приглашение идентифицируется с помощью заданного объекта Object.The invitation is identified using the specified Object.

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

Начинает операцию асинхронного приглашения с участием указанных конечных точек однорангового узла для соединения с указанной совместной работой PeerApplication, спонсируемой отправителем приглашения.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)

Начинает асинхронную операцию приглашения заданной конечной точки одноранговой сети на присоединение к приложению PeerCollaboration, инициированному отправителем приглашения.Begins an asynchronous invitation operation for the specified peer endpoint to join a PeerCollaboration application sponsored by the sender of the invitation. Приглашение идентифицируется с помощью заданного объекта Object.The invitation is identified using the specified Object.

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

Начинает операцию асинхронного приглашения для указанного элемента PeerApplication, выполняя соединение с указанной совместной работой peerEndPoint, спонсируемой отправителем приглашения.Begins an asynchronous invitation operation for the specified peerEndPoint to join the specified collaboration PeerApplication sponsored by the sender of the invitation.

InviteAsyncCancel(Object)

Отменяет приглашение, отправленное с помощью метода InviteAsync(PeerApplication, String, Byte[], Object).Cancels the invitation that was sent with the InviteAsync(PeerApplication, String, Byte[], Object) method.

(Унаследовано от Peer)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnApplicationChanged(ApplicationChangedEventArgs)

Вызывает событие ApplicationChanged.Raises the ApplicationChanged event.

OnInviteCompleted(InviteCompletedEventArgs)

Порождает событие InviteCompleted.Raises the InviteCompleted event.

(Унаследовано от Peer)
OnObjectChanged(ObjectChangedEventArgs)

Вызывает событие ObjectChanged, когда удаленным одноранговым узлом добавляется, удаляется или обновляется объект PeerObject.Raises the ObjectChanged event when a PeerObject is added, updated or removed by a remote peer.

OnPresenceChanged(PresenceChangedEventArgs)

Вызывает событие PresenceChanged при изменении PeerPresenceInfo однорангового узла.Raises the PresenceChanged event when the PeerPresenceInfo of a peer has changed.

OnSubscribeCompleted(SubscribeCompletedEventArgs)

Вызывает событие SubscribeCompleted.Raises the SubscribeCompleted event.

Subscribe()

Подписывает вызывающий одноранговый узел для PeerContact, и в результате узел получит все будущие события PeerCollaboration, связанные с 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)

Асинхронно подписывает вызывающий одноранговый узел для PeerContact, и в результате узел получит все будущие события PeerCollaboration, связанные с 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()

Возвращает представление объектом String объекта DisplayName, связанного с объектом PeerContact.Returns a String representation of the DisplayName associated with the PeerContact.

ToXml()

Сериализует объект PeerContact в строку XML для постоянного хранения или передачи по сети.Serializes the PeerContact to an XML string for persistent storage or network transfer.

Unsubscribe()

Удаляет подписку на PeerContact, в результате чего вызывающий одноранговый узел больше не получает события PeerCollaboration, связанные с PeerContact.Removes a subscription to the PeerContact and as a result the calling peer no longer receives PeerCollaboration events associated with the PeerContact.

События

ApplicationChanged

Это событие вызывается, когда изменяется приложение, связанное с объектом PeerContact.This event is raised whenever an application associated with the PeerContact has changed.

InviteCompleted

Вызывается при завершении процесса приглашения удаленного однорангового узла.Raised when the invitation process for a remote peer has completed.

(Унаследовано от Peer)
ObjectChanged

Это событие получает сигнал, когда изменяется объект PeerObject, связанный с объектом PeerContact.This event is signaled whenever a PeerObject associated with the PeerContact has changed.

PresenceChanged

Событие вызывается при изменении состояния присутствия объектом PeerContact.This event is raised whenever the PeerContact has changed its presence status.

SubscribeCompleted

Вызывается при завершении операции подписки.Raised when a subscription operation has completed.

Явные реализации интерфейса

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Реализует интерфейс ISerializable и возвращает данные, необходимые для сериализации экземпляра класса PeerContact.Implements the ISerializable interface and returns the data needed to serialize the PeerContact instance.

Применяется к

Дополнительно