SyndicationPerson Class

 

Represents an author or contributor of syndication content.

Namespace:   System.ServiceModel.Syndication
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

System.Object
  System.ServiceModel.Syndication.SyndicationPerson

Public Class SyndicationPerson

NameDescription
System_CAPS_pubmethodSyndicationPerson()

Initializes a new SyndicationPerson instance.

System_CAPS_pubmethodSyndicationPerson(String)

Initializes a new SyndicationPerson instance with the specified e-mail address.

System_CAPS_pubmethodSyndicationPerson(String, String, String)

Initializes a new SyndicationPerson instance with the specified e-mail address, name, and Uniform Resource Identifier (URI).

System_CAPS_protmethodSyndicationPerson(SyndicationPerson)

Initializes a new instance of the SyndicationPerson class with the specified instance.

NameDescription
System_CAPS_pubpropertyAttributeExtensions

Gets the attribute extensions for the SyndicationPerson.

System_CAPS_pubpropertyElementExtensions

Gets the element extensions for the SyndicationPerson.

System_CAPS_pubpropertyEmail

Gets and sets the e-mail address of the SyndicationPerson.

System_CAPS_pubpropertyName

Gets and sets the name of the SyndicationPerson.

System_CAPS_pubpropertyUri

Gets and sets the URI of the SyndicationPerson.

NameDescription
System_CAPS_pubmethodClone()

Creates a copy of the existing SyndicationPerson instance.

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

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

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

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

System_CAPS_protmethodMemberwiseClone()

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

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

System_CAPS_protmethodTryParseAttribute(String, String, String, String)

Attempts to parse an attribute extension.

System_CAPS_protmethodTryParseElement(XmlReader, String)

Attempts to parse an element extension.

System_CAPS_protmethodWriteAttributeExtensions(XmlWriter, String)

Writes the attribute extensions to the specified XmlWriter using the specified syndication version.

System_CAPS_protmethodWriteElementExtensions(XmlWriter, String)

Writes the element extensions to the specified XmlWriter using the specified syndication version.

SyndicationPerson objects can be added to the authors and contributors collections on SyndicationFeed and SyndicationItem objects.

When serialized to Atom 1.0, the SyndicationPerson is written out as an <author> or <contributor> element.

When serialized to RSS 2.0, a SyndicationPerson instance is written out as a <managingEditor>, <a10:author>, or <a10:contributor> element. How a SyndicationPerson is serialized depends on the number of SyndicationPerson objects added to a SyndicationFeed or SyndicationItem, which collection the SyndicationPerson instances are added to, and the value of the SerializeExtensionAsAtom parameter to the Rss20ItemFormatter(SyndicationItem, Boolean) constructor. If only one SyndicationPerson is added to the Authors (or Authors) collection, the SyndicationPerson is serialized to a <managingEditor> element. If more than one SyndicationPerson is added to the Authors (or Authors) collection and SerializeExtensionsAsAtom is set to true, all of the SyndicationPerson objects are serialized to <a10:author> elements. If SerializeExtensionsAsAtom is set to false, the SyndicationPerson instances is not serialized. Any SyndicationPerson instances added to the Contributors (or Contributors) collection are only serialized if SerializeExtensionsAsAtom is set to true, in which case they are serialized to <a10:contributor> elements.

The following code shows how to add a SyndicationPerson to the authors collection of a SyndicationFeed instance.

Dim feed As New SyndicationFeed("Feed Title", "Feed Description", New Uri("http://Feed/Alternate/Link"), "FeedID", DateTime.Now)
Dim sp As New SyndicationPerson("jesper@contoso.com", "Jesper Aaberg", "http://Jesper/Aaberg")
feed.Authors.Add(sp)

The following XML shows how a SyndicationPerson is serialized to Atom 1.0.

<author>
  <name>Jesper Aaberg</name>
  <uri>http://Jesper/Aaberg</uri>
  <email>Jesper.Aaberg@contoso.com</email>
</author>
<contributor>
  <name>Lene Aalling</name>
  <uri>http://Lene/Aaling</uri>
  <email>Lene.Aaling@contoso.com</email>
</contributor>

The following XML shows how a SyndicationPerson is serialized to RSS 2.0.

<a10:author>
  <a10:name>Lene Aalling</a10:name>
  <a10:uri>http://Lene/Aalling</a10:uri>
  <a10:email>Lene.Aalling@contoso.com</a10:email>
</a10:author>
  <a10:contributor>
  <a10:name>Jesper Aaberg</a10:name>
  <a10:uri>http://Jesper/Aaberg</a10:uri>
  <a10:email>Jesper.Aaberg@contoso.com</a10:email>
</a10:contributor>

.NET Framework
Available since 3.5
Silverlight
Available since 2.0

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
Show: