SyndicationFeed Classe

Riferimento

Definizione

Spazio dei nomi:: System.ServiceModel.Syndication

Assembly:: System.ServiceModel.Syndication.dll

Assembly:: System.ServiceModel.dll, System.ServiceModel.Syndication.dll

Assembly:: System.ServiceModel.Web.dll

Assembly:: System.ServiceModel.dll

Assembly:: System.ServiceModel.dll, System.ServiceModel.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un oggetto del feed di primo livello, <feed> in Atom 1.0 e <rss> in RSS 2.0.

public ref class SyndicationFeed

public class SyndicationFeed

type SyndicationFeed = class

Public Class SyndicationFeed

Ereditarietà: Object
SyndicationFeed

Esempio

Nel seguente codice viene mostrato come creare un'istanza di ed eseguirne la serializzazione per le specifiche Atom 1.0 e RSS 2.0.

SyndicationFeed feed = new SyndicationFeed("Feed Title", "Feed Description", new Uri("http://Feed/Alternate/Link"), "FeedID", DateTime.Now);
// Add a custom attribute.
XmlQualifiedName xqName = new XmlQualifiedName("CustomAttribute");
feed.AttributeExtensions.Add(xqName, "Value");

SyndicationPerson sp = new SyndicationPerson("jesper@contoso.com", "Jesper Aaberg", "http://Jesper/Aaberg");
feed.Authors.Add(sp);

SyndicationCategory category = new SyndicationCategory("FeedCategory", "CategoryScheme", "CategoryLabel");
feed.Categories.Add(category);

feed.Contributors.Add(new SyndicationPerson("lene@contoso.com", "Lene Aaling", "http://lene/aaling"));
feed.Copyright = new TextSyndicationContent("Copyright 2007");
feed.Description = new TextSyndicationContent("This is a sample feed");

// Add a custom element.
XmlDocument doc = new XmlDocument();
XmlElement feedElement = doc.CreateElement("CustomElement");
feedElement.InnerText = "Some text";
feed.ElementExtensions.Add(feedElement);

feed.Generator = "Sample Code";
feed.Id = "FeedID";
feed.ImageUrl = new Uri("http://server/image.jpg");

TextSyndicationContent textContent = new TextSyndicationContent("Some text content");
SyndicationItem item = new SyndicationItem("Item Title", textContent, new Uri("http://server/items"), "ItemID", DateTime.Now);

List<SyndicationItem> items = new List<SyndicationItem>();
items.Add(item);
feed.Items = items;

feed.Language = "en-us";
feed.LastUpdatedTime = DateTime.Now;

SyndicationLink link = new SyndicationLink(new Uri("http://server/link"), "alternate", "Link Title", "text/html", 1000);
feed.Links.Add(link);

XmlWriter atomWriter = XmlWriter.Create("atom.xml");
Atom10FeedFormatter atomFormatter = new Atom10FeedFormatter(feed);
atomFormatter.WriteTo(atomWriter);
atomWriter.Close();

XmlWriter rssWriter = XmlWriter.Create("rss.xml");
Rss20FeedFormatter rssFormatter = new Rss20FeedFormatter(feed);
rssFormatter.WriteTo(rssWriter);
rssWriter.Close();

Dim feed As SyndicationFeed = New SyndicationFeed("Feed Title", "Feed Description", New Uri("http:'Feed/Alternate/Link"), "FeedID", DateTime.Now)
' Add a custom attribute.
Dim xqName As XmlQualifiedName = New XmlQualifiedName("CustomAttribute")
feed.AttributeExtensions.Add(xqName, "Value")

Dim sp As SyndicationPerson = New SyndicationPerson("jesper@contoso.com", "Jesper Aaberg", "http:'jesper/aaberg")
feed.Authors.Add(sp)

Dim category As SyndicationCategory = New SyndicationCategory("FeedCategory", "CategoryScheme", "CategoryLabel")
feed.Categories.Add(category)

feed.Contributors.Add(New SyndicationPerson("Lene@contoso.com", "Lene Aaling", "http:'Lene/Aaling"))
feed.Copyright = New TextSyndicationContent("Copyright 2007")
feed.Description = New TextSyndicationContent("This is a sample feed")

' Add a custom element.
Dim doc As XmlDocument = New XmlDocument()
Dim feedElement As XmlElement = doc.CreateElement("CustomElement")
feedElement.InnerText = "Some text"
feed.ElementExtensions.Add(feedElement)

feed.Generator = "Sample Code"
feed.Id = "FeedID"
feed.ImageUrl = New Uri("http:'server/image.jpg")

Dim textContent As TextSyndicationContent = New TextSyndicationContent("Some text content")
Dim item As SyndicationItem = New SyndicationItem("Item Title", textContent, New Uri("http:'server/items"), "ItemID", DateTime.Now)

Dim items As Collection(Of SyndicationItem) = New Collection(Of SyndicationItem)()
items.Add(item)
feed.Items = items

feed.Language = "en-us"
feed.LastUpdatedTime = DateTime.Now

Dim link As SyndicationLink = New SyndicationLink(New Uri("http:'server/link"), "alternate", "Link Title", "text/html", 1000)
feed.Links.Add(link)

Dim atomWriter As XmlWriter = XmlWriter.Create("atom.xml")
Dim atomFormatter As Atom10FeedFormatter = New Atom10FeedFormatter(feed)
atomFormatter.WriteTo(atomWriter)
atomWriter.Close()

Dim rssWriter As XmlWriter = XmlWriter.Create("rss.xml")
Dim rssFormatter As Rss20FeedFormatter = New Rss20FeedFormatter(feed)
rssFormatter.WriteTo(rssWriter)
rssWriter.Close()

Nel codice XML seguente viene mostrato come serializzare SyndicationFeed per il formato Atom 1.0.

<feed xml:lang="en-us" CustomAttribute="Value" xmlns="http://www.w3.org/2005/Atom">
  <title type="text">Feed Title</title>
  <subtitle type="text">This is a sample feed</subtitle>
  <id>FeedID</id>

  <rights type="text">Copyright 2007</rights>
  <updated>2007-04-13T17:29:38Z</updated>
  <category term="FeedCategory" label="CategoryLabel" scheme="CategoryScheme" />
  <logo>http://contoso/image.jpg</logo>
  <author>
    <name>Jesper Aaberg</name>
    <uri>http://contoso/Aaberg</uri>
    <email>Jesper.Asberg@contoso.com</email>
  </author>
  <contributor>
    <name>Lene Aalling</name>
    <uri>http://contoso/Aalling</uri>
    <email>Lene.Aaling@contoso.com</email>
  </contributor>
  <generator>Sample Code</generator>
  <link rel="alternate" type="text/html" title="Link Title" length="1000" href="http://contoso/link" />

  <link customAttribute="value" rel="alternate" type="text/html" title="Link Title" length="1000" href="http://contoso/link" />
  <CustomElement xmlns="">Some text</CustomElement>
  <entry>
    <id>ItemID</id>
    <title type="text">Item Title</title>
    <updated>2007-04-13T17:29:38Z</updated>
    <link rel="alternate" href="http://contoso/items" />
    <content type="text">Some text content</content>
  </entry>

</feed>

Nel codice XML seguente viene mostrato come serializzare un'istanza di SyndicationFeed per il formato RSS 2.0.

<rss xmlns:a10="http://www.w3.org/2005/Atom" version="2.0">
  <channel CustomAttribute="Value">
    <title>Titolo feed</title>
    <link>http://feed/Alternate/Link</link>
    <description>Si tratta di un feed di esempio</description>
    <language>en-us</language>

    <copyright>Copyright 2007</copyright>

    <managingEditor>Jesper.Aaberg@contoso.com</managingEditor>
    <lastBuildDate>Fri, 13 Apr 2007 17:29:38 Z</lastBuildDate>
    <category domain="CategoryScheme">FeedCategory</category>
    <a10:link rel="alternate" type="text/html" title="Link Title" length="1000" href="http://contoso/link" />
    <generator>Sample Code</generator>
    
    <a10:contributor>
      <a10:name>Lene Aalling</a10:name>
      <a10:uri>http://contoso/Aalling</a10:uri>
      <a10:email>Lene.Aalling@contoso.com</a10:email>
    </a10:contributor>
    
    <a10:author>
      <a10:name>Lene Aalling</a10:name>
      <a10:uri>http://contoso/Aalling</a10:uri>
      <a10:email>Lene.Aalling@contoso.com</a10:email>
    </a10:author>
    <image>
      <url>http://contoso/image.jpg</url>
      <title>Titolo feed</title>
      <link>http://feed/Alternate/Link</link>
    </image>
    <a10:id>FeedID</a10:id>
    <a10:link customAttribute="value" rel="alternate" type="text/html" title="Link Title" length="1000" href="http://contoso/link" />
    
    <CustomElement>Some text</CustomElement>
    <item>
      <guid isPermaLink="false">ItemID</guid>
      <link>http://contoso/items</link>
      <title>Titolo elemento</title>
      <description>Contenuto di testo</description>
      <a10:updated>2007-04-13T17:29:38Z</a10:updated>
    </item>
  </channel>
</rss>

Commenti

Quando serializzato in Atom 1.0, un'istanza SyndicationFeed viene scritta in un <feed> elemento . Nella tabella seguente viene mostrato come ogni proprietà definita nella classe SyndicationFeed venga serializzata per Atom 1.0.

Proprietà SyndicationFeed	Form serializzato
`AttributeExtensions`	Attributo nell'elemento `<feed>` per ogni attributo nella raccolta.
`Authors`	Elemento `<author>` per ogni SyndicationPerson oggetto della raccolta.
`Categories`	Elemento `<category>` per ogni SyndicationCategory oggetto della raccolta.
`Contributors`	Elemento `<contributor>` per ogni SyndicationPerson oggetto della raccolta.
`Copyright`	Elemento `<rights>`.
`Description`	Elemento `<subtitle>`.
`ElementExtensions`	Ogni elemento nella raccolta viene scritto all'interno dell'elemento `<feed>` .
`Generator`	Elemento `<generator>`.
`Id`	Elemento `<id>`.
`ImageUri`	Elemento `<logo>`.
`Items`	Elemento `<entry>` per ogni SyndicationItem oggetto della raccolta.
`Language`	Non serializzato.
`LastUpdatedTime`	Elemento `<updated>`.
`Links`	Elemento `<link>` per ogni SyndicationLink oggetto della raccolta.
`Title`	Elemento `<title>`.

Durante la serializzazione per RSS 2.0, viene scritta un'istanza di SyndicationFeed nell'elemento <rss>. Nella tabella seguente viene mostrato come ogni proprietà definita nella classe SyndicationFeed venga serializzata per RSS 2.0.

Proprietà SyndicationFeed	Form serializzato
`AttributeExtensions`	Attributo nell'elemento `<channel>` per ogni attributo nella raccolta.
`Authors`	Elemento `<managingEditor>` se ne è presente solo uno SyndicationPerson nell'insieme; in caso contrario, un `<a10:author>` elemento per ognuno SyndicationPerson dell'insieme.
`Categories`	Elemento `<category>` per ogni SyndicationCategory oggetto della raccolta.
`Contributors`	Elemento `<a10:contributor>` per ogni SyndicationPerson oggetto della raccolta.
`Copyright`	Elemento `<copyright>`.
`Description`	Elemento `<description>`.
`ElementExtensions`	Ogni elemento nella raccolta viene scritto all'interno dell'elemento `<channel>` .
`Generator`	Elemento `<generator>`.
`Id`	Elemento `<a10:id>`.
`ImageUri`	Elemento `<image>`.
`Items`	Elemento `<item>` per ogni SyndicationItem oggetto della raccolta.
`Language`	Elemento `<language>`.
`LastUpdatedTime`	Elemento `<lastBuildDate>`.
`Links`	Elemento `<a10:link>` per ogni SyndicationLink oggetto della raccolta.
`Title`	Elemento `<title>`.

Costruttori

SyndicationFeed()	Inizializza una nuova istanza della classe SyndicationFeed.
SyndicationFeed(IEnumerable<SyndicationItem>)	Inizializza una nuova istanza della classe SyndicationFeed con la raccolta specificata di oggetti SyndicationItem.
SyndicationFeed(String, String, Uri)	Inizializza una nuova istanza della classe SyndicationFeed con titolo, descrizione e URI (Uniform Resource Identifier) specificati.
SyndicationFeed(String, String, Uri, IEnumerable<SyndicationItem>)	Inizializza una nuova istanza della classe SyndicationFeed con titolo, descrizione, URI e raccolta di oggetti SyndicationItem specificati.
SyndicationFeed(String, String, Uri, String, DateTimeOffset)	Crea una nuova istanza della classe SyndicationFeed.
SyndicationFeed(String, String, Uri, String, DateTimeOffset, IEnumerable<SyndicationItem>)	Crea una nuova istanza della classe SyndicationFeed.
SyndicationFeed(SyndicationFeed, Boolean)	Crea una nuova istanza della classe SyndicationFeed con il feed specificato.

Proprietà

AttributeExtensions	Ottiene una raccolta di estensioni degli attributi.
Authors	Ottiene una raccolta di autori del feed.
BaseUri	Ottiene o imposta l'URI di base per l'istanza di SyndicationFeed.
Categories	Ottiene una raccolta di categorie per il feed.
Contributors	Ottiene una raccolta di collaboratori del feed.
Copyright	Ottiene o imposta le informazioni sul copyright per il feed.
Description	Ottiene o imposta una descrizione del feed.
Documentation	Ottiene o imposta il collegamento alla documentazione per il feed.
ElementExtensions	Ottiene le estensioni degli elementi per il feed.
Generator	Ottiene o imposta il generatore di un feed.
Id	Ottiene o imposta l'ID del feed.
ImageUrl	Ottiene o imposta l'URL dell'immagine per il feed.
Items	Ottiene una raccolta di elementi di feed contenuti nel feed.
Language	Ottiene o imposta la lingua del feed.
LastUpdatedTime	Ottiene o imposta l'ora dell'ultimo aggiornamento del feed.
Links	Ottiene i collegamenti associati al feed.
SkipDays	Ottiene una raccolta di stringhe che indica il set di valori nell'elemento 'skipDays' per il feed.
SkipHours	Ottiene una raccolta di interi che indica il set di valori nell'elemento 'skipHours' per il feed.
TextInput	Ottiene o imposta la proprietà TextInput per il feed.
TimeToLive	Ottiene o imposta l'attributo 'ttl' per il feed.
Title	Ottiene o imposta il titolo del feed.

Metodi

Clone(Boolean)	Crea una copia dell'istanza di SyndicationFeed.
CreateCategory()	Crea una nuova istanza di SyndicationCategory.
CreateItem()	Crea una nuova istanza di SyndicationItem.
CreateLink()	Crea una nuova istanza di SyndicationLink.
CreatePerson()	Crea una nuova istanza di SyndicationPerson.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetAtom10Formatter()	Ottiene un'istanza di Atom10FeedFormatter.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetRss20Formatter()	Ottiene un'istanza di Rss20FeedFormatter.
GetRss20Formatter(Boolean)	Ottiene una nuova istanza di Rss20FeedFormatter.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Load(XmlReader)	Carica un feed di diffusione dal lettore XML specificato.
Load<TSyndicationFeed>(XmlReader)	Carica un'istanza derivata da SyndicationFeed a partire dalla classe XmlReader specificata.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
SaveAsAtom10(XmlWriter)	Scrivere il feed di diffusione in formato Atom 1.0 nella classe XmlWriter specificata.
SaveAsRss20(XmlWriter)	Scrivere il feed di diffusione in formato RSS 2.0 nella classe XmlWriter specificata.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TryParseAttribute(String, String, String, String)	Tenta di analizzare un'estensione degli attributi.
TryParseElement(XmlReader, String)	Tenta di analizzare un'estensione degli elementi.
WriteAttributeExtensions(XmlWriter, String)	Scrive le estensioni degli attributi nella classe XmlWriter specificata utilizzando la versione di diffusione specificata.
WriteElementExtensions(XmlWriter, String)	Scrive le estensioni degli elementi nella classe XmlWriter specificata utilizzando la versione di diffusione specificata.

Si applica a