スタンドアロン診断フィードのサンプル

[アーティクル]
09/17/2008

このサンプルでは、Windows Communication Foundation (WCF) を使用して配信用の RSS フィードおよび Atom フィードを作成する方法を示します。このサンプルは基本の "Hello World" プログラムであり、オブジェクトモデルの基本とオブジェクトモデルを Windows Communication Foundation (WCF) サービスにセットアップする方法を示しています。

メモ :
このサンプルをビルドして実行するには、.NET Framework Version 3.5 をインストールする必要があります。Visual Studio 2008 では、プロジェクトとソリューションファイルを開く必要があります。

WCF は、特殊なデータ型 (SyndicationFeedFormatter) を返すサービス操作として配信フィードをモデル化します。SyndicationFeedFormatter のインスタンスは、フィードを RSS 2.0 形式および Atom 1.0 形式の両方にシリアル化できます。使用するコントラクトを次のサンプルコードに示します。

[ServiceContract(Namespace = "")]
    interface IDiagnosticsService
    {
        [OperationContract]
        //The [WebGet] attribute controls how WCF dispatches
        //HTTP requests to service operations based on a URI suffix
        //(the part of the request URI after the endpoint address)
        //using the HTTP GET method. The UriTemplate specifies a relative
        //path of 'feed', and specifies that the format is
        //supplied using a query string. 
        [WebGet(UriTemplate="feed?format={format}")]
        [ServiceKnownType(typeof(Atom10FeedFormatter))]
        [ServiceKnownType(typeof(Rss20FeedFormatter))]
        SyndicationFeedFormatter GetProcesses(string format);
    }

GetProcesses 操作には、WCF が HTTP GET 要求をサービス操作にディスパッチする方法を制御し、送信されるメッセージの形式を指定できるようにする WebGetAttribute 属性で注釈が付けられています。

あらゆる WCF サービスと同様に、配信フィードは、任意のマネージアプリケーション内での自己ホストが可能です。配信サービスが適切に機能するには、特定のバインディング (WebHttpBinding) と、特定のエンドポイント動作 (WebHttpBehavior) が必要です。新しい WebServiceHost クラスには、特定の構成を使用せずにこのようなエンドポイントを作成する際に便利な、次のような API が用意されています。

WebServiceHost host = new WebServiceHost(typeof(ProcessService), new Uri("https://localhost:8000/diagnostics"));

            //The WebServiceHost will automatically provide a default endpoint at the base address
            //using the proper binding (the WebHttpBinding) and endpoint behavior (the WebHttpBehavior)

または、IIS でホストされる .svc ファイルから WebServiceHostFactory を使用して、同等の機能を提供することもできます (この手法は、このサンプルコードでは示されません)。

<%@ ServiceHost Language="C#|VB" Debug="true" 
                           Service="ProcessService" %>

このサービスは標準の HTTP GET を使用して要求を受け取るので、サービスへのアクセスには、RSS または ATOM に対応している任意のクライアントを使用できます。たとえば、Internet Explorer 7 などの RSS 対応のブラウザで、https://localhost:8000/diagnostics/feed/?format=atom または https://localhost:8000/diagnostics/feed/?format=rss に移動することで、このサービスの出力を表示できます。

次の命令型コードを使用して、配信データの読み取りと処理にSyndication Object Modelを使用することもできます。

XmlReader reader = XmlReader.Create( "https://localhost:8000/diagnostics/feed/?format=rss",
new XmlReaderSettings()
{
//MaxCharactersInDocument can be used to control the maximum amount of data 
//read from the reader and helps prevent OutOfMemoryException
MaxCharactersInDocument = 1024 * 64
} );

SyndicationFeed feed = SyndicationFeed.Load( reader );

foreach (SyndicationItem i in feed.Items)
{
        XmlSyndicationContent content = i.Content as XmlSyndicationContent;
        ProcessData pd = content.ReadContent<ProcessData>();

        Console.WriteLine(i.Title.Text);
        Console.WriteLine(pd.ToString());
}

サンプルを設定、ビルド、および実行するには

「Windows Communication Foundation サンプルの 1 回限りのセットアップの手順」のセットアップ手順で説明されているように、コンピュータ上で HTTP および HTTPS の正しいアドレス登録アクセス許可があることを確認します。
ソリューションをビルドします。
コンソールアプリケーションを実行します。
コンソールアプリケーションの実行中に、RSS 対応のブラウザを使用して https://localhost:8000/diagnostics/feed/?format=atom または https://localhost:8000/diagnostics/feed/?format=rss に移動します。

次の方法で共有

スタンドアロン診断フィードのサンプル

サンプルを設定、ビルド、および実行するには

関連項目

その他の技術情報

その他のリソース