基本的な SharePoint Foundation クライアント アプリケーションを作成する
最終更新日: 2010年8月3日
適用対象: SharePoint Foundation 2010
クライアント オブジェクト モデルを使用する .NET マネージ クライアント アプリケーションを作成するには、Microsoft.SharePoint.Client.dll および Microsoft.SharePoint.Client.Runtime.dll の 2 つのクライアント ライブラリ DLL に対する参照を設定する必要があります。これらの DLL は、Microsoft SharePoint Foundation 2010 が実行されているサーバーの %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI フォルダーから、アプリケーションを作成するリモート コンピューターにコピーできます。
基本的なコンソール アプリケーションを作成する
次のプログラミング作業を行うことで、Microsoft Visual Studio で基本的なコンソール アプリケーションを作成できます。このコンソール アプリケーションは Microsoft.SharePoint.Client 名前空間でオブジェクトを使用して、Web サイトのプロパティを返します。
[ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。
[新しいプロジェクト] ダイアログ ボックスで、[インストールされたテンプレート] パネルの [Visual Basic] または [Visual C#] を選択します。[Windows]、[コンソール アプリケーション] の順に選択します。中央パネルの上部にあるドロップダウンから [.NET Framework 3.5] を選択します。プロジェクトの名前と場所を [名前] ボックスと [場所] ボックスに入力します。[OK] をクリックします。
Windows エクスプローラーで、2 つの DLL をサーバーの %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI フォルダーからコンソール アプリケーションのトップレベル フォルダーにコピーします。
ソリューション エクスプローラーで、プロジェクトを右クリックして [参照の追加] をクリックし、[参照の追加] ダイアログ ボックスで [参照] タブをクリックして、Microsoft.SharePoint.Client.dll および Microsoft.SharePoint.Client.Runtime.dll をコピーしたフォルダーに移動します。2 つの DLL を選択し、[OK] をクリックします。
次の例では、ClientContext() コンストラクターで指定した URL の Web サイトのタイトルを返し、それを表示しています。Load<T>(T, []) メソッドによって、どのオブジェクトをサーバーから取得するかが指定され (この場合は Web サイト)、ExecuteQuery() によってクエリが実行されます。Web サイトのオブジェクトが読み込まれるため、そのオブジェクトの既定のプロパティすべてが使用可能になり、コンソールに表示されます。オブジェクトまたはコレクションを読み込むときに既定で使用可能にならないプロパティについては、「データ取得の概要」を参照してください。
using System; using Microsoft.SharePoint.Client; namespace Microsoft.SDK.SharePointServices.Samples { class DisplayWebTitle { static void Main() { ClientContext clientContext = new ClientContext("http://MyServer/sites/MySiteCollection/MyWebSite"); Web oWebsite = clientContext.Web; clientContext.Load(oWebsite); clientContext.ExecuteQuery(); Console.WriteLine("Title: {0} Created: {1}", oWebsite.Title, oWebsite.Created); } } }
Imports System Imports Microsoft.SharePoint.Client Namespace Microsoft.SDK.SharePointServices.Samples Class DisplayWebTitle Public Overloads Shared Sub Main() Dim clientContext As New ClientContext("http://MyServer/sites/MySiteCollection/MyWebSite") Dim oWebsite As Web = clientContext.Web clientContext.Load(oWebsite) clientContext.ExecuteQuery() Console.WriteLine("Title: {0} Created: {1}", oWebsite.Title, oWebsite.Created) End Sub End Class End Namespace
F5 キーを押してアプリケーションを実行し、Web サイトのタイトルと作成日をコンソールに表示します。