PeerObject Class


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Represents a new instance of the PeerObject class with an auto-generated Guid.

Namespace:   System.Net.PeerToPeer.Collaboration
Assembly:  System.Net (in System.Net.dll)


public class PeerObject : IDisposable, IEquatable<PeerObject>, 


Initializes a new default instance of the PeerObject class.

System_CAPS_pubmethodPeerObject(Guid, Byte[], PeerScope)

Initializes a new PeerObject instance with the associated scope and data.

System_CAPS_protmethodPeerObject(SerializationInfo, StreamingContext)

Initializes a new PeerObject instance with the associated parameters required for serialization.


Gets or sets descriptive data associated with the PeerObject instance for a Peer Collaboration application.


Gets or sets a Guid associated with the PeerObject instance.


Gets or sets the PeerScope in which the PeerObject instance is registered.


Gets or sets the object used to marshal the event handler calls that are issued as a result of a PeerObject instance change.


Releases all resources utilized by the PeerObject.


Releases the unmanaged resources used by the PeerObject and optionally releases the managed resources.


Compares the PeerObject to the specified object.(Overrides Object.Equals(Object).)

System_CAPS_pubmethodSystem_CAPS_staticEquals(Object, Object)

Determines whether the specified PeerObject instances are considered equal.


Compares a PeerObject to the specified PeerObject instance.


Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)


Returns the hash code for the PeerObject instance.(Overrides Object.GetHashCode().)

System_CAPS_protmethodGetObjectData(SerializationInfo, StreamingContext)

Populates a SerializationInfo with the data required to serialize the specified PeerObject.


Gets the Type of the current instance.(Inherited from Object.)


Creates a shallow copy of the current Object.(Inherited from Object.)


Signaled when a PeerObject instance with the specified ID is added, updated or removed by a remote peer.


Returns a String that represents a PeerObject instance.(Overrides Object.ToString().)


Signaled when a PeerObject instance changes.

System_CAPS_pubinterfaceSystem_CAPS_privmethodISerializable.GetObjectData(SerializationInfo, StreamingContext)

Populates the current PeerObject instance with the data obtained from the serialized source.

A PeerObject is run-time data, such as a picture, certificate, or a specific description that is associated with a particular application. The data element of each PeerObject instance must be less than or equal to 16KB in size. After an instance of PeerObject is constructed it is published with the Peer Collaboration Infrastructure via SetObject.

After constructing an instance of this class and setting the appropriate properties this object may be passed to the PeerCollaborationSetObject and DeleteObject methods to enable/disable the publishing of this object for other peers to discover and view.

After registering an object with the collaboration infrastructure the registration information is not persisted in the registry, resulting in different behavior from PeerApplication instances. The object registration is only valid for the lifetime duration of the application which registered the object. Applications should deregister objects when they are no longer required or prior to application exit. By default, a PeerObject is automatically deregistered if the instance goes out of scope.

Changing the properties on a PeerObject instance after it has been registered using the PeerCollaboration registration methods will not update the registration for the PeerObject instance. To effectively update the registration of a specific PeerObject instance, the PeerObject must be deleted and registered again with the new information.

.NET Framework
Available since 3.5

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top