外部アプリケーションをホストする Web パーツを作成する

  • [アーティクル]

最終更新日: 2011年9月1日

適用対象: SharePoint Foundation 2010

ここでは、SharePoint アプリケーション以外をホストする Web パーツを作成する方法の概要について説明します。これは、その Web パーツが使用される Microsoft SharePoint Foundation Web アプリケーションとは異なるドメインに配置されている可能性があります。通常、Web パーツには編集可能なプロパティがあり、その場合は、Web パーツのツール パーツも作成する必要があります。

Web パーツを作成するには

  1. Microsoft Visual Studio 2010 で、空の SharePoint プロジェクトを開始します。

  2. プロジェクトに Web パーツを追加して、cs または vb ソース コード ファイルを開きます。

  3. Microsoft.SharePoint.WebPartPages 名前空間の using ステートメント (Visual Basic では Imports) を追加します。

  4. 既定の WebPart の代わりに ClientApplicationWebPartBase から継承する Web パーツ クラスを設定します。

  5. 必要に応じて、クラスのコンストラクター、CreateChildControls メソッド、および RenderContents メソッドを上書きします。

    Web パーツをカスタム外部アプリケーション プロバイダー (EAP) で使用できるようにする場合、CreateChildControls メソッドで次の操作を行います。

    1. 継承した GetExternalApplicationRequestResult() メソッドを呼び出します。

    2. 継承した GetInitParams() メソッドを呼び出します。

    3. GetExternalApplicationRequestResult() の呼び出しで返される SPExternalApplicationRequestResult オブジェクトの GetContentControl(String) メソッドを呼び出し、そのメソッドに、GetInitParams() の呼び出しによって返される String オブジェクトをパラメーターとして渡します。

    カスタム EAP が作成されておらず、Web アプリケーションを含む Web サービスに登録されていない場合、この一連の呼び出しによる変化はありません。

  6. Web パーツの 外部アプリケーション XML にカスタム プロパティが含まれる場合、カスタム EAP を作成して読み取る必要があります。カスタム EAP の作成手順の一環として、OnApplicationWebPartCreateChildControls(SPExternalApplicationRequestProperties) メソッドを実装する必要があります。カスタム EAP 作成の詳細については、「[方法] カスタム外部アプリケーション プロバイダーを作成する」を参照してください。

  7. Web パーツに編集可能なプロパティがある場合、継承した CreateEditorParts() メソッドを実装して、ツール パーツ クラスのオブジェクトを作成します。このクラスの詳細については、「ツール パーツを作成するには」を参照してください。

ツール パーツを作成するには

  1. プロジェクトに別の Web パーツを追加します。

  2. 既定の WebPart の代わりに EditorPart から継承するクラスを設定します。

  3. ツール パーツの編集可能なコントロールに Web パーツから編集可能なプロパティを読み取る SyncChanges() メソッドの実装を追加します。

  4. ツール パーツのコントロールから値を読み取る ApplyChanges() メソッドの実装を追加して、Web パーツのプロパティに割り当てます。

  5. 必要に応じて、CreateChildControls メソッド、RenderContents メソッド、およびその他のメンバーを上書きします。