PeerApplication 类

定义

命名空间:

System.Net.PeerToPeer.Collaboration

程序集:

System.Net.dll

表示可在对等方协作基础结构中使用的应用程序。

public ref class PeerApplication : IDisposable, IEquatable<System::Net::PeerToPeer::Collaboration::PeerApplication ^>, System::Runtime::Serialization::ISerializable

[System.Serializable]
public class PeerApplication : IDisposable, IEquatable<System.Net.PeerToPeer.Collaboration.PeerApplication>, System.Runtime.Serialization.ISerializable

[<System.Serializable>]
type PeerApplication = class
    interface IDisposable
    interface IEquatable<PeerApplication>
    interface ISerializable

Public Class PeerApplication
Implements IDisposable, IEquatable(Of PeerApplication), ISerializable

继承

Object

PeerApplication

属性

SerializableAttribute

实现

IDisposable IEquatable<PeerApplication> ISerializable

注解

应用程序是从终结点向对等方提供的一组软件或软件功能。 通常，这是指支持网络的软件包，例如游戏或其他协作应用程序。 定义 PeerApplication 可用于 PeerCollaboration 网络的软件应用程序或组件集。 此网络使基础结构参与者能够启动此应用程序的使用。 他们可以使用此类标识的应用程序启动协作会话。

构造此类的实例并设置相应的属性后，可以在协作会话中 System.Net.PeerToPeer 使用此对象。 它的使用是通过将其传递给对等协作 RegisterApplication 和 UnregisterApplication 方法来实现的，后者将启用或禁用它。

必须先设置此实例的全局唯一 Id 属性和 PeerApplicationRegistrationType 属性，然后才能成功注册应用程序。

使用对等协作基础结构注册应用程序后，注册信息将保留在注册表中。 这使得应用程序可供协作应用程序使用，即使在注册该应用程序的程序已退出之后也是如此。

注册应用程序实例后更改应用程序实例的属性不会影响注册。 若要更新注册，必须注销应用程序，然后使用新信息重新注册。

构造函数

PeerApplication()	初始化 PeerApplication 类型的新默认实例。
PeerApplication(Guid, String, Byte[], String, String, PeerScope)	使用提供的应用程序 ID、说明、范围和数据元素初始化新的 PeerApplication 实例。
PeerApplication(SerializationInfo, StreamingContext)	使用序列化所需的数据初始化 PeerApplication 类型的新实例。

属性

CommandLineArgs	获取或设置要在启动 PeerApplication 时使用的命令行参数。
Data	获取或设置与当前 PeerApplication 实例关联的数据。
Description	获取或设置一个描述 String 的 Unicode PeerApplication。
Id	获取或设置与 Guid 关联的用户定义的 PeerApplication。
Path	获取或设置一个路径，该路径指定 PeerApplication 可执行文件在本地文件系统中的位置。
PeerScope	获取或设置在其中注册 PeerApplication 以进行协作的范围。
SynchronizingObject	设置此属性值后，将在创建特定 SynchronizingObject 的线程上为因异步操作而未激发的所有事件回调关联的事件处理程序。

方法

Dispose()	释放由 PeerApplication 对象使用的资源。
Dispose(Boolean)	释放由 PeerApplication 对象占用的非托管资源并（可选）释放托管资源。
Equals(Object)	将 PeerApplication 与指定的 Object 进行比较。
Equals(Object, Object)	确定指定的 PeerApplication 对象是否被视为相等。
Equals(PeerApplication)	将 PeerApplication 与指定的 PeerApplication 实例进行比较。
GetHashCode()	返回 PeerApplication 实例的哈希代码。
GetObjectData(SerializationInfo, StreamingContext)	使用将目标 PeerApplication 序列化所需的数据填充 SerializationInfo。
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnApplicationChanged(ApplicationChangedEventArgs)	引发 ApplicationChanged 事件。
ToString()	返回一个字符串，其中包含 Id 实例的 Description 和 PeerApplication。

事件

ApplicationChanged

每当已订阅终结点上的远程对等方添加、更新或删除 PeerApplication 时，都将引发此事件。

显式接口实现

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

实现 ISerializable 接口，并返回序列化目标 PeerApplication 所需的数据。

另请参阅

• Id