在這個示例里我們將詳細介紹 TokenHelper 類， 我們將看到它是怎么簡單地從遠程web站點訪問SharePoint的。我們還將取到它的一些值。這將幫助我們理解連接是怎么被構造的，同時也方便我們的以一的調試。我們將創建一個簡單的 auto-hosted app，用TokenHelper類從相關的SharePoint服務器讀取數據，并顯示在頁面上。我們還將取出一些token的值以方便看到它們的內容。

1. 打開Visual Studio 2012.
2. 創建一個新的? C# SharePoint app 項目：RemoteWebApp。
3. 選擇 Autohosted (它是缺省項).
這將生成二個projects. 第一個是 SharePoint app web, 第二個是遠程web站點。當debug時，遠程的web app 將運行在本地的IIS Express上。當通過
remote web site. When debugging, the remote web app will run on a local copy of IIS Express. When deployed
Office Store 或一個 App 目錄，遠程的web將被發布到 Azure 云。

?
4. 按F5運行app

這個頁面將查詢host web 站咪的title，并顯示在頁面上。它只用了幾行就做到了，因為它使用了TokenHelper 這個類。我們下面將詳細介紹它的使用。

5. 停止調試
6. 打開Default.aspx.cs
7. 注釋Page_Load() 里已有的代碼
8. 加入下面的引用：

using Microsoft.IdentityModel.S2S.Protocols.OAuth2; using Microsoft.SharePoint.Client; using System; using System.Collections.Generic; using System.Data; using System.Globalization; using System.Linq; using System.Web; using System.Web.Configuration; using System.Web.UI; using System.Web.UI.WebControls;

9. 加入下面的代碼到Page_Load() :

// Get app info from web.configstring clientID = string.IsNullOrEmpty(WebConfigurationManager.AppSettings.Get("ClientId"))? WebConfigurationManager.AppSettings.Get("HostedAppName"): WebConfigurationManager.AppSettings.Get("ClientId");string clientSecret = string.IsNullOrEmpty(WebConfigurationManager.AppSettings.Get("ClientSecret"))? WebConfigurationManager.AppSettings.Get("HostedAppSigningKey"): WebConfigurationManager.AppSettings.Get("ClientSecret");

??
client ID 和 secret 是從遠程web的配置文件讀取到的，ID 指向 app， secret 被用作獲取 access tokens。

10. 加入下面的代碼到Page_Load() :

// Get values from Page.Requeststring reqAuthority = Request.Url.Authority;string hostWeb = Page.Request["SPHostUrl"];string hostWebAuthority = (new Uri(hostWeb)).Authority;

11. 加入下面的代碼到Page_Load() :

// Get Context Tokenstring contextTokenStr = TokenHelper.GetContextTokenFromRequest(Request);SharePointContextToken contextToken =TokenHelper.ReadAndValidateContextToken(contextTokenStr, reqAuthority);// Read data from the Context Tokenstring targetPrincipalName = contextToken.TargetPrincipalName;string cacheKey = contextToken.CacheKey;string refreshTokenStr = contextToken.RefreshToken;string realm = contextToken.Realm;

SharePoint 還將傳遞encode? context token, ReadAndValidateContextToken() 方法把它轉換成一個 SharePointContextToken 對象，這樣就更容易訪問它的內容, 驗證這個token指的是驗證它的地址是來自這個app。剩下的代碼就是從token里取出一些值.

12. 把這下面這個方法加到 Default 頁面.

private static string GetFormattedPrincipal(string principalName, string hostName, string realm){if (!String.IsNullOrEmpty(hostName)){return String.Format(CultureInfo.InvariantCulture, "{0}/{1}@{2}", principalName, hostName, realm);}else{return String.Format(CultureInfo.InvariantCulture, "{0}@{1}", principalName, realm);}}

13. 加入下面的代碼到Page_Load() :

// Create principal and client stringsstring targetPrincipal = GetFormattedPrincipal(targetPrincipalName, hostWebAuthority, realm);string appPrincipal = GetFormattedPrincipal(clientID, null, realm);

app principal 哪個app正在做請求; target principal 確認哪個application, host 和 realm 將收到請求。

14. 加入下面的代碼到Page_Load() :

// Request an access token from ACSstring stsUrl = TokenHelper.AcsMetadataParser.GetStsUrl(realm);OAuth2AccessTokenRequest oauth2Request =OAuth2MessageFactory.CreateAccessTokenRequestWithRefreshToken(appPrincipal, clientSecret, refreshTokenStr, targetPrincipal);OAuth2S2SClient client = new OAuth2S2SClient();OAuth2AccessTokenResponse oauth2Response = client.Issue(stsUrl, oauth2Request) as OAuth2AccessTokenResponse;string accessTokenStr = oauth2Response.AccessToken;

這是連接回到host web的關鍵， 這段代碼請求 OAuth access token 并把它送到 Access Control Service (ACS). ACS發布了 access token 并且把它返回到遠程的。這里能用同步調用，因為在服務端而不是在sharepoint。

15. 加入下面的代碼到Page_Load() :

// Build the CSOM context with the access tokenClientContext clientContext = TokenHelper.GetClientContextWithAccessToken(hostWeb, accessTokenStr);clientContext.Load(clientContext.Web, web => web.Title);clientContext.ExecuteQuery();

這里我們用access token創建一個CSOM client context 去請求 sharepoint . 我們這里用同步的ExecuteQuery（），因為這是服務端的代碼。

16. 加入下面的代碼到Page_Load() 顯示數據 :

// Dump values to the pageDataTable dt = new DataTable();dt.Columns.Add("Name");dt.Columns.Add("Value");dt.Rows.Add("QueryString", Request.QueryString);dt.Rows.Add("clientID", clientID);dt.Rows.Add("clientSecret", clientSecret);dt.Rows.Add("hostWeb", hostWeb);dt.Rows.Add("contextTokenStr", contextTokenStr);dt.Rows.Add("contextToken", contextToken);dt.Rows.Add("targetPrincipalName", targetPrincipalName);dt.Rows.Add("cacheKey", cacheKey);dt.Rows.Add("refreshTokenStr", refreshTokenStr);dt.Rows.Add("realm", realm);dt.Rows.Add("targetPrincipal", targetPrincipal);dt.Rows.Add("appPrincipal", appPrincipal);dt.Rows.Add("stsUrl", stsUrl);dt.Rows.Add("oauth2Request", oauth2Request);dt.Rows.Add("client", client);dt.Rows.Add("oauth2Response", oauth2Response);dt.Rows.Add("accessTokenStr", accessTokenStr);dt.Rows.Add("Host Web Title", clientContext.Web.Title);grd.DataSource = dt;grd.DataBind();

17. 打開Default.aspx 頁面.
18. 加入下面的GridView :

<asp:GridView ID="grd" runat="server" CellPadding="4" ForeColor="#333333" GridLines="None" AutoGenerateColumns="True" Width="100%"><AlternatingRowStyle BackColor="White" /><EditRowStyle BackColor="#2461BF" /><FooterStyle BackColor="#507CD1" Font-Bold="True" ForeColor="White" /><HeaderStyle BackColor="#507CD1" Font-Bold="True" ForeColor="White" /><PagerStyle BackColor="#2461BF" ForeColor="White" HorizontalAlign="Center" /><RowStyle BackColor="#EFF3FB" /><SelectedRowStyle BackColor="#D1DDF1" Font-Bold="True" ForeColor="#333333" /><SortedAscendingCellStyle BackColor="#F5F7FB" /><SortedAscendingHeaderStyle BackColor="#6D95E1" /><SortedDescendingCellStyle BackColor="#E9EBEF" /><SortedDescendingHeaderStyle BackColor="#4870BE" /></asp:GridView>

19. 按 F5 運行APP.
這個app顯示了遠程站點的 default 頁面，顯示了這個站點的token的值。這些值讓我們更方便地調試我們的app。

?

?

SharePoint 2013 APP 開發示例 系列

總結

以上是生活随笔為你收集整理的SharePoint 2013 APP 开发示例 （三）使用远程的web资源的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。