鬆散型別延伸範例

發行項
03/03/2024

LooselyTypedExtensions 範例說明使用延伸資料的基本技術。

新聞訂閱物件模型對使用延伸資料 (即以新聞訂閱摘要 XML 表示法呈現，但是尚未經由像是 SyndicationFeed 和 SyndicationItem 等類別明確公開的資訊) 提供大量支援。

基於示範用途，此範例會使用 SyndicationFeed 類別。不過在此範例中所示範的模式，可以與所有支援延伸資料的新聞訂閱類別一起使用：

範例 XML

對於參考，這個範例使用下列 XML 文件。

<?xml version="1.0" encoding="IBM437"?>
<feed myAttribute="someValue" xmlns="http://www.w3.org/2005/Atom">
  <title type="text"></title>
  <id>uuid:8f60c7b3-a3c0-4de7-a642-2165d77ce3c1;id=1</id>
  <updated>2007-09-07T22:15:34Z</updated>
  <simpleString xmlns="">hello, world!</simpleString>
  <simpleString xmlns="">another simple string</simpleString>
  <DataContractExtension xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.d
atacontract.org/2004/07/Microsoft.Syndication.Samples">
    <Key>X</Key>
    <Value>4</Value>
  </DataContractExtension>
  <XmlSerializerExtension xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://ww
w.w3.org/2001/XMLSchema" xmlns="">
    <Key>Y</Key>
    <Value>8</Value>
  </XmlSerializerExtension>
  <xElementExtension xmlns="">
    <Key attr1="someValue">Z</Key>
    <Value attr1="someValue">15</Value>
  </xElementExtension>
</feed>

這份文件包含下列延伸資料片段：

myAttribute 元素的 <feed> 屬性。
<simpleString> 項目。
<DataContractExtension> 項目。
<XmlSerializerExtension> 項目。
<xElementExtension> 項目。

撰寫延伸資料

將項目新增至 AttributeExtensions 集合便可以建立屬性延申，如下列範例程式碼所示。

//Attribute extensions are stored in a dictionary indexed by
// XmlQualifiedName
feed.AttributeExtensions.Add(new XmlQualifiedName("myAttribute", ""), "someValue");

將項目新增至 ElementExtensions 集合便可以建立項目延伸。這些延伸可以是像是字串、.NET Framework 物件的 XML 序列化 (Serialization) 或手動撰寫的 XML 節點等基本值。

下列範例程式碼會建立名為 simpleString 的延伸項目。

feed.ElementExtensions.Add("simpleString", "", "hello, world!");

這個項目的 XML 命名空間是空白的命名空間 ("")，而且它的值是包含字串「hello, world!」的文字節點。

建立由許多巢狀項目所組成之複雜項目延伸的其中一種方法，便是使用 .NET Framework API 進行序列化 (同時支援DataContractSerializer XmlSerializer 和)，如下列範例所示。

feed.ElementExtensions.Add( new DataContractExtension() { Key = "X", Value = 4 } );
feed.ElementExtensions.Add( new XmlSerializerExtension { Key = "Y", Value = 8 }, new XmlSerializer( typeof( XmlSerializerExtension ) ) );

在這個範例中，DataContractExtension 和 XmlSerializerExtension 是針對搭配序列化程式所撰寫的自訂型別。

SyndicationElementExtensionCollection 類別也可以用來建立 XmlReader 執行個體的項目延伸。這樣便可以與像是 XElement 的 XML 處理 API 輕鬆整合，如下列範例程式碼所示。

feed.ElementExtensions.Add(new XElement("xElementExtension",
        new XElement("Key", new XAttribute("attr1", "someValue"), "Z"),
        new XElement("Value", new XAttribute("attr1", "someValue"),
        "15")).CreateReader());

讀取延伸資料

在 AttributeExtensions 集合中根據 XmlQualifiedName 查閱屬性，便可取得該屬性延伸的值，如下列範例程式碼所示。

Console.WriteLine( feed.AttributeExtensions[ new XmlQualifiedName( "myAttribute", "" )]);

項目延伸是使用 ReadElementExtensions<T> 方法來存取。

foreach( string s in feed2.ElementExtensions.ReadElementExtensions<string>("simpleString", ""))
{
    Console.WriteLine(s);
}

foreach (DataContractExtension dce in feed2.ElementExtensions.ReadElementExtensions<DataContractExtension>("DataContractExtension",
"http://schemas.datacontract.org/2004/07/SyndicationExtensions"))
{
    Console.WriteLine(dce.ToString());
}

foreach (XmlSerializerExtension xse in feed2.ElementExtensions.ReadElementExtensions<XmlSerializerExtension>("XmlSerializerExtension", "", new XmlSerializer(typeof(XmlSerializerExtension))))
{
    Console.WriteLine(xse.ToString());
}

使用 XmlReader 方法，也可以取得位在個別項目延伸的 GetReader()。

foreach (SyndicationElementExtension extension in feed2.ElementExtensions.Where<SyndicationElementExtension>(x => x.OuterName == "xElementExtension"))
{
    XNode xelement = XElement.ReadFrom(extension.GetReader());
    Console.WriteLine(xelement.ToString());
}

若要安裝、建置及執行範例

確定您已執行 Windows Communication Foundation 範例的一次性安裝程序。
若要建置方案的 C# 或 Visual Basic .NET 版本，請遵循 Building the Windows Communication Foundation Samples中的指示。
若要在單一或多部電腦組態中執行此範例，請遵循執行 Windows Communication Foundation 範例中的指示進行。

鬆散型別延伸範例

範例 XML

撰寫延伸資料

讀取延伸資料

若要安裝、建置及執行範例

另請參閱

其他資源