SharePoint アドインをローカライズする

[アーティクル]
04/08/2023

注:

このトピックは、SharePoint アドインの基本的な作成、SharePoint の機能、アドイン Web とホスト Web の区別、アドイン内に存在する可能性がある SharePoint コンポーネントの種類、および .resx ファイルのローカライズの基本の知識があることを前提としています。

SharePoint アドインのローカライズを準備する

始める前に以下を特定します。

アドインがサポートする必要のあるロケール。 SharePoint Online、および言語パックがインストールされた SharePoint オンプレミスで、ユーザーが特定の言語とカルチャで Web サイトを作成できるようにします。顧客が使用するのがどのローカライズされた Web サイトであるのかを確認し、ローカライズされたバージョンのアドインのコンポーネントで、これらのうちどれをサポートするのか判断します。
アドインでローカライズする必要のあるコンポーネント。

また、以下を確認します。

この記事の手順では、最新バージョンの Office Developer Tools for Visual Studio 2013 または Office Developer Tools for Visual Studio 2015 を使用していることが前提となっています。

注:

テスト用の SharePoint Web サイトが Microsoft SharePoint Online 開発者向けサイトではなく、オンプレミスの SharePoint ファームである場合、SharePoint アドインを翻訳する言語の言語パックをインストールしなければならないことがあります。詳細については、「SharePoint 用の言語パックをインストールまたはアンインストールする」および「SharePoint Server 2013 の言語パックのダウンロード」を参照してください。
この記事のスクリーンショットとコード例は、サンプル「SharePoint-Add-in-Localization」を反映しています。サンプルをダウンロードして、この記事で説明されている手順の結果を確認できます。

アドイン Web コンポーネントをローカライズする

アドイン Web には、特定の種類の SP コンポーネントを含めることができます。 SharePoint アドインに含められる SharePoint コンポーネントの種類については、「SharePoint アドインに含めることができる SharePoint コンポーネントの種類」を参照してください。アドイン Web に展開されるコンポーネントをローカライズするには、アドイン Web コンポーネントを含むのと同じ機能のモジュールに .resx ファイルを追加します。そのリソースをコンポーネントのマークアップで参照します。その方法については、この記事で後述します。ただし、SharePoint アドインのカスタムサイトページでは、このセクションで後述するように、.resx ファイルの代わりに JavaScript の文字列変数ファイルを使用します。

注:

リソースファイルは、アドイン Web の複数のフィーチャーで共有することはできません。 .wsp ファイル内のフィーチャーごとに、別個のリソースファイルセットを作成する必要があります。

アドイン Web のリソースファイルを作成する方法

Visual Studio で SharePoint アドインプロジェクトを開きます。 (このトピックのスクリーンショットが作成されたサンプルは、プロジェクトのリモート Web アプリケーションパーツとして ASP.NET Web Formsを持つプロバイダーホスト型アドインです)。
ソリューションエクスプローラーで、フィーチャー名のショートカットメニューを開き、[フィーチャーリソースの追加] を選択します。
[リソースの追加] ダイアログボックスで [ロケールに依存しない言語 (ロケールに依存しない国)] を選択し、[OK] を選択します。 ソリューションエクスプローラーで Resource.resx ファイルがフィーチャーのフォルダーに追加され、そのファイルが Visual Studio リソースエディターで開きます。

編集時、この "ロケールに依存しない言語" ファイルには、文字列のローカライズされたバージョンが用意されていない言語について、すべてのサイトのフィーチャー ギャラリーで使用される文字列が含まれます。したがって、このファイル内の文字列で使用する言語は、SharePoint を使用するユーザーにとって第二言語である可能性が高い言語にする必要があります。伝統的に、この目的のために英語が使用されていますが、一部のシナリオでは、別の言語の方が適している場合があります。たとえば、一部の地域では、フランス語の方が英語よりも一般的な第二言語になります。このトピックに示す例では、ロケールに依存しない言語として英語を使用します。

注:

SharePoint アドインは、アドインマニフェストの [サポートされるロケール] セクションに言語がリストされていない Web サイトにはインストールできません。この記事で、ローカライズされたアドインを作成しない言語について説明される場合でも、その言語をアドインマニフェストに追加する必要があることに留意してください。アドインマニフェストでサポートされるロケールについて詳しくは、この記事で後述する「ホスト Web のリソースファイルを作成するには」の手順を参照してください。
リソースエディターの 1 行目の [名前] 列に、文字列 (またはその他のリソース) の説明的な名前を入力します (例: OrdersListInstance_Title、OrdersListInstance_Description)。ローカライズ可能リソースのこれらの名前自体はローカライズされません。各リソースはそれぞれ固有の名前を持つ必要があります。
[値] 列に、適切な文字列 (または URL またはその他のリソース) を、ロケールに依存しない言語で入力します (例: Orders、A list to store the orders)。
機能のコンポーネントで使用するためにローカライズする必要があるすべての文字列とリソースについて、名前と値のペアを追加します。
ファイルを保存します。
前と同じフィーチャーに対して別のリソースファイルを追加しますが、[ロケールに依存しない言語 (ロケールに依存しない国)] の代わりに、特定の言語を選択します。たとえば、[スペイン語 (スペイン)] を選択できます。リソース。LL-CC.resx ファイル (LLCCインターネットエンジニアリングタスクフォース (IETF) 準拠の言語とカルチャコード) がソリューションエクスプローラーの Feature のフォルダーに追加され、Visual Studio リソースエディターでファイルが開きます。
リソースエディターを使用して、Resource.resx 内のすべての行をコピーし、新しい Resource.LL-CC.resx ファイルに貼り付けます。 (リソースエディターのコンテキストメニューで [コピー] が使用可能になっていない場合には、Ctrl+C を使用して、行をクリップボードにコピーします。)
Resource.LL-CC.resx ファイルで、[値] セルを、翻訳されたバージョンの文字列値に置き換えます。 URL と他の文字列以外のリソースの値を、言語とカルチャに適した新しい値に置き換えます。
新しいファイルを保存します。
各言語で、前の 4 つの手順を繰り返します。

注:

インバリアント言語と同じ言語の言語固有のファイルを追加することを検討してください。 If you do, you can copy the rows without changing the values of the strings. In many situations, it is not necessary to have a language-specific file for the same language that is used in the resource file for the invariant language, especially when the only resources in the files are strings. But resource files can contain images, icons, files, and other kinds of resources too. 場合によっては、ロケールに依存しない言語のリソースファイルで、任意の言語固有のファイルの対応するリソースとは異なる画像または他のリソースを使用する必要があります。
各ファイルで、[ビルドアクション] が [コンテンツ] に設定されていることを確認します。

カスタムリスト内のローカライズされたリソースを呼び出す方法

カスタムリストのタイトルおよび説明プロパティをローカライズするには、リストのインスタンスの Elements.xml ファイルを開きます。たとえば、このトピックに付随するサンプルでは、ソリューションエクスプローラーで、[BookstoreApp]>[Order Status]>[OrderStatusInstance]>[Elements.xml] に移動します。
Title 属性に、「$Resources:StringName」と入力します。ここで、StringName は、前の手順でカスタムリストに名前を付けるために文字列に与えた名前です (値ではありません)。たとえば、「$Resources: OrdersListInstance_Title」と入力します。なお、.resx ファイルが使用される一部のコンテキストとは異なり、リソースファイルの名前は入力データの一部ではありません。
Description 属性を使用して、リストの説明の文字列リソースを、同じ方法で呼び出します。たとえば、「$Resources:OrdersListInstance_Description」と入力します。次に示すのは、リストのインスタンスの Elements.xml ファイル内でローカライズされた文字列を使用するマークアップです。
```
<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
    <ListInstance 
        Title="$Resources:OrdersListInstance_Title" 
        OnQuickLaunch="TRUE" 
        TemplateType="10000" 
        Url="Lists/Orders" 
        Description="$Resources:OrdersListInstance_Description">
    </ListInstance>
</Elements>
```

次に示すのは、英語でローカライズされたカスタムリストの画像です。

ローカライズされたカスタムリスト

ローカライズされたユーザー設定リスト

カスタムリストの列名をローカライズする方法

カスタムリストの列名は、タイトルや説明と同じ方法ではローカライズできません。列名をローカライズするには、Elements.xml ファイルにリストのフィールドを宣言してから、DisplayName 属性の値をアドイン Web リソースファイル内の参照に設定する必要があります。開始するには、カスタムリストの Schema.xml ファイルを開きます。 Fields ノードを探し、そのすべての Field ノードをコピーします。
カスタムリストの Elements.xml ファイルを開きます。リストのインスタンスではなく、リスト定義の Elements.xml ファイルを開いてください。前の手順でコピーしたノードを、Elements ノードの子として貼り付けます。
すべての Field ノードについて、$Resources:StringName の値を DisplayName 属性に入力します。StringName はアドイン Web リソースファイル内のエントリの名前です。

カスタムリストの Schema.xml ファイルで、前にコピーしたすべての Field ノードの DisplayName 属性を削除します。次に示すのは、リスト定義の Elements.xml ファイルのローカライズされた文字列を使用するマークアップの例です。

<?xml version="1.0" encoding="utf-8"?>
    <Elements xmlns="http://schemas.microsoft.com/sharepoint/">
        <ListTemplate
            Name="Orders"
            Type="10000"
            BaseType="0"
            OnQuickLaunch="TRUE"
            SecurityBits="11"
            Sequence="410"
            DisplayName="Orders"
            Description="My List Definition"
            Image="/_layouts/15/images/itgen.png"/>
        <Field
            Name="Bookname"
            ID="{2ef60a05-29b6-41db-9611-c0cf7d8e73c5}"
            DisplayName="$Resources:OrdersListColumn_Bookname"
            Type="Text"
            Required="TRUE" />
        <Field
            Name="Price"
            ID="{7af42815-d69e-426a-a1c8-9da5610e362c}"
            DisplayName="$Resources:OrdersListColumn_Price"
            Type="Currency"
            Required="FALSE" />
        <Field
            Name="Orderstatus"
            ID="{687ee751-2e0a-4099-966e-d2c225d48234}"
            DisplayName="$Resources:OrdersListColumn_Orderstatus"
            Type="Lookup"
            Required="FALSE"
            List="Lists/Order status"
            ShowField="Title" />
    </Elements>

カスタムページ用の JavaScript リソースファイルを作成する方法

SharePoint アドインのカスタムサイトページでは、JavaScript 文字列変数ファイルが .resx ファイルの代わりに使用されます。

最初に、ソリューションエクスプローラーで、(Web アプリケーションのプロジェクトにではなく) SharePoint アドインのプロジェクトに Scripts というフォルダー名がない場合は追加します。 Scripts フォルダーを右クリックして、[追加]>[新しい項目]>[Web]>[JavaScript ファイル] の順に選択します。ファイルに Resources.LL-CC.js という名前を付けます。ここで、LL は言語コードで、CC は国/地域コードまたはカルチャコードです (例: Resources.en-US.js)。
各言語で、上記の手順を繰り返します。これで、すべての言語用の空白の JavaScript ファイルが用意されます。 "Resources.js"という名前の、ロケールに依存しない言語ファイルは作成しないでください。理由については、後の手順の中で説明します。
新しく作成した最初の JavaScript ファイルを開きます。

各カスタムページの各ローカライズ可能文字列に対して、文字列を識別する目的の名前となる変数をファイル内に宣言し、言語に適した値を割り当てます。次に示すのは Resources.en-US.js ファイルの内容です。

    var instructionstitle = "Instructions:";
    var step01 = "Go to any document library in the host web.";
    var step02 = "Go to the Library tab.";
    var step03 = "Click \"Request a book\" in the Settings group.";
    var step04 = "Click the contextual menu in any document.";
    var step05 = "Click \"Buy this book\" in the contextual menu.";
    var step06 = "Go to any SharePoint page in the host web and add the" + " Bookstore orders add-in part.";
    var step07 = "Review the localized <a href=\"../Lists/Orders\">Orders</a>" + " and <a href=\"../Lists/Order status\">Order status</a> custom lists.";

このファイルの内容を、残りの JavaScript ファイルにコピーし、すべてのファイルを保存します。
各ファイルで、各変数の値を、各ファイルの言語に適した新しい値に置き換えます。 変数名は変更しないでください。

カスタム ASPX ページでローカライズされた変数を呼び出す方法

ソリューションエクスプローラーで、カスタム ASPX ページファイルを開きます。
ページの読み込み時に、ローカライズされた JavaScript ファイルが 1 つだけ読み込まれ、そのファイルが SharePoint アドイン Web に適していることを確認してください。これを行うには、値が PlaceholderAdditionalPageHead の ContentPlaceholderId がある、ページの asp:content 要素に次のマークアップを追加する必要があります。 次のマークアップにはプレースホルダーはありません。ここに表示されるとおりにマークアップを入力します。
```
    <script type="text/javascript" src="../scripts/Resources.<SharePoint:EncodedLiteral runat='server' text='<%$Resources:wss,language_value%>' EncodeMethod='HtmlEncode' />.js"></script>
```
このマークアップは、JavaScript ファイルのいずれかを読み込みます。 language_value という名前の SharePoint リソースを読み取って、どの言語ファイルを読み込むかを決定します。このリソースは、前の手順に記載されている LL-CC パターンの言語 - カルチャ名に解決されます。具体的には、アドイン Web の言語に解決されます。

注:

SharePoint リソース language_value は null ではないので、このスクリプトが "Resources.js" という名前のファイルを呼び出すことはありません。前の手順でそのファイルを作成しなかったのは、この理由からです。 language_value の値が .js ファイルを持たない言語の場合、このスクリプトは何も読み込みません。次の手順では、そのような状況で文字列がロケールに依存しない言語の値をどのように取得するか説明します。
ページ上のローカライズ可能な要素と属性値に対して、それぞれ、ロケールに依存しない言語で既定値を指定しますが、そのときに、JavaScript を使用して、Resources.LL-CC.js ファイルから適切な変数を割り当てます。たとえば、ページの h2 要素にタイトルがある場合は、その要素に id 属性を指定した後、ローカライズされる要素の下に script 要素を挿入して、その innerText プロパティにローカライズされた文字列を割り当てます。このローカライズコードを実行するのは、Resources.LL-CC.js ファイルが読み込まれ、変数が宣言される場合だけです。そのため、いずれかの変数が定義されているかどうかを最初にテストする条件ブロック内にそれを含めます。定義されていない場合、リソーススクリプトが読み込まれないため、既定の (ロケールに依存しない) 値は変更されません。次に例を示します。

ヒント

ロケールに依存しない文字列の先頭に「INVARIANT」という語が追加されています。これを製品アドインで行うことはありませんが、テストの際にロケールに依存しない言語文字列が使用されているか、またはロケールに依存しない言語になる言語の Resources.LL-CC.js ファイルが読み込まれたかを一目で知るための役立つ方法となります。

    <h2 id="instructionsheading">INVARIANT Instructions</h2>
        <ol>
            <li id="step01">Go to any document library in the host web.</li>
            <li id="step02">Go to the Library tab.</li>
            <li id="step03">Click "Request a book" in the Settings group.</li>
            <li id="step04">Click the contextual menu in any document.</li>
            <li id="step05">Click "Buy this book" in the contextual menu.</li>
            <li id="step06">Go to any SharePoint page in the host web and add the Bookstore orders add-in part.</li>
            <li id="step07">Review the localized <a href="../Lists/Orders">Orders</a> and <a href="../Lists/Order status">Order status</a> custom lists.</li>
        </ol>

    <!-- Use the localized strings in the resource JavaScript file -->
        <script type="text/javascript">
            window.onload = function () {
                <!-- Test whether a Resources.LL-CC.js loaded.
                    If none was, the invariant values remain unchanged. -->
                if (typeof instructionstitle != 'undefined')  
                {
                    document.getElementById("instructionsheading").innerText = instructionstitle;
                    document.getElementById("step01").innerText = step01;
                    document.getElementById("step02").innerText = step02;
                    document.getElementById("step03").innerText = step03;
                    document.getElementById("step04").innerText = step04;
                    document.getElementById("step05").innerText = step05;
                    document.getElementById("step06").innerText = step06;
                    document.getElementById("step07").innerHTML = step07;
                }
            }
        </script>

次の図は、アドインが完了したときの、英語バージョンのページのプレビューを示しています。

JavaScript リソースファイルのローカライズされた文字列を使用する Web ページ

ローカライズされた文字列を使用した SharePoint ページ

ホスト Web コンポーネントをローカライズする

AppManifest.xml ファイルで指定されているアドインタイトルをローカライズできます。これは、[Your Add-ins] ページでユーザーに対して表示されるデータです。 SharePoint アドインのホスト Web には、カスタムアクション、アドインパーツ、または両方を含めることができます。これらは、ホスト Web フィーチャーに展開されます。これらのコンポーネントの両方に、ローカライズ可能文字列を含められます。

ホスト Web コンポーネントのローカライズに不可欠な方法は、アドイン Web コンポーネントをローカライズする場合と同じです。ローカライズされたリソースは .resx ファイルに項目化され、マークアップファイルから呼び出されます。ただし、Visual Studio には、ホスト Web 機能に適用されるほど、このプロセスに対するツールサポートはありません。このセクションの後半で説明する手動プロセスが含まれます。

ホスト Web のリソースファイルを作成する方法

ソリューションエクスプローラーで、AppManifest.xml ファイルを選択してアドインマニフェストデザイナーツールを開きます。
[サポートされるロケール] タブを開きます。
[ロケール] 列の先頭の空のセルで、ドロップダウンリストを開き、サポートする最初のロケールを選択します。 2 つのファイルが作成されて、SharePoint アドインプロジェクトに追加されます。Resources.resx は、ロケールに依存しない言語のリソースファイルです。Resources.LL-CC.resx には、ローカライズされたリソースが格納されます。 これらのファイルの名前は変更しないでください。
アドインのローカライズバージョンによってサポートする各ロケールについて、前の手順を繰り返します。ロケールごとに、Resources.LL-CC.resx ファイルが追加作成されます。

注:

これらの各ファイルの [ビルドアクション] プロパティは、[リソース] ではなく [コンテンツ] に設定されます。 この設定は変更しないでください。
また、アドインをインストール可能にする、しかしロケールに依存しない言語を使用する必要のある (つまりアドインのローカライズバージョンを提供 しない) すべてのロケール用に、ロケールエントリを追加します。 それらのロケール用に作成される .resx ファイルを削除してください。
Resources.resx ファイルを開き、アドイン Web のリソースファイルの場合と同じように、リソースの名前と値をファイルに追加します。少なくとも、アドインタイトル用のリソースを用意する必要があります。ホスト Web フィーチャーは SharePoint UI のどこにも表示されないので、ホスト Web フィーチャーのタイトルや説明のローカライズされた文字列は必要ありません。フィーチャーにカスタムアクションがある場合は、CustomAction 要素の Title 属性用のリソースが必要であり、おそらくカスタムアクションマークアップ内に他の文字列も必要です。アドインパーツがある場合は、ClientWebPart 要素の Title 属性と Description 属性用のリソースが必要です。アドインパーツにカスタムプロパティがある場合は、同様にローカライズする必要のある属性が各 Property にあります。これらのすべてについて、リソースファイル内に該当する行が必要です。
Resources.resx ファイルの内容を、各 Resources.LL-CC.resx ファイルにコピーします。
各 Resources.LL-CC.resx ファイルの各リソースを、アドイン Web リソースファイルと同じようにローカライズします。

アドインマニフェストファイル、その他の XML ファイル内のローカライズされたリソースを呼び出す方法

AppManifest.xml ファイルを開き、Title 要素の値を、適切なリソース文字列の呼び出しに置き換えます。たとえば、文字列に Addin_Title という名前を付けた場合、Title 要素は次のようになります。
```
    <Title>$Resources:Addin_Title;</Title>
```
警告

Title の値には、リソースの呼び出しのみを含めることができます。それ以外のテキスト、記号、またはホワイトスペースは指定できません。
アドインパーツやカスタムアクションの Elements.xml など、他の XML ファイルのローカライズされたリソースを呼び出すには、アドインマニフェストファイルで使用したものと同じ形式を使用します。

SharePoint アドイン内のリモートコンポーネントをローカライズする

リモートコンポーネントが PHP などの Microsoft 以外のフォーマットの場合は、該当するプラットフォームのローカライズに関する説明を参照してください。リモートコンポーネントが ASP.NET の場合は、他のすべての ASP.NET アプリケーションと同様にローカライズします。詳細については、「ASP.NET のグローバリゼーションとローカリゼーション」を参照してください。

ホスト Web の言語に合うようにページの言語とスレッドの言語をオーバーライドしてください。これは ASP.NET ページの分離コードにある継承された InitializeCulture メソッドをオーバーライドすることによって行います。ホスト Web の言語を識別するには、SharePoint がリモートページに渡す SPLanguage クエリパラメーターを使用します。次のコードは、ASP.NET でこれを行う方法を示しています。 PHP Web アプリケーションや他のプラットフォームでも、類似の方法で行うことができます。

    protected override void InitializeCulture()
    {
        if (Request.QueryString["SPLanguage"] != null)
        {
            string selectedLanguage = Request.QueryString["SPLanguage"];
            
            // Override the page language.
            UICulture = selectedLanguage;
            Culture = selectedLanguage;

            // Reset the thread language.
            Thread.CurrentThread.CurrentCulture =
                CultureInfo.CreateSpecificCulture(selectedLanguage);
            Thread.CurrentThread.CurrentUICulture = new
                CultureInfo(selectedLanguage);
        }
        base.InitializeCulture();
    }

リモート JavaScript と SharePoint クロムコントロールのローカライズ

Web アプリケーションの JavaScript にローカライズ可能な文字列値がある場合、それらを JavaScript リソースファイルを使用してローカライズできます。ローカライズ可能な JavaScript の特に重要な例は SharePoint クロムコントロールで、これを使用するとリモートページを SharePoint ページのように見せることができます。このセクションでは、クロムコントロールのローカライズを例として使用します。

注:

このセクションでは、文字列のローカライズについてのみ説明します。日付や通貨形式など必要性のより大きなローカライズについては、「jQuery 用のグローバライズアドオン」などのローカライズまたはグローバリゼーションライブラリの使用を検討してください。

クロムコントロールをローカライズする方法

クロムコントロールの機能が開始した後に、クロムオプションを設定した renderChrome メソッドに戻ります。

    function renderChrome() {
        var options = {
            "appIconUrl": "siteicon.png",
            "appTitle": "My SharePoint add-in", // Localizable string
            "appHelpPageUrl": "Help.html?"
                + document.URL.split("?")[1],
            "onCssLoaded": "chromeLoaded()",
            "settingsLinks": [
                {
                    "linkUrl": "Account.html?"
                        + document.URL.split("?")[1],
                    "displayName": "Account settings" // Localizable string
                },
                {
                    "linkUrl": "Contact.html?"
                        + document.URL.split("?")[1],
                    "displayName": "Contact us" // Localizable string
                }
            ]
        };

コメントに記されているように、少なくとも 3 つのローカライズ可能な文字列があります。それぞれを、後の手順で宣言する変数名に置き換えます。

    function renderChrome() {
        var options = {
            "appIconUrl": "siteicon.png",
            "appTitle": chromeAppTitle, // Localized value
            "appHelpPageUrl": "Help.html?"
                + document.URL.split("?")[1],
            "onCssLoaded": "chromeLoaded()",
            "settingsLinks": [
                {
                    "linkUrl": "Account.html?"
                        + document.URL.split("?")[1],
                    "displayName": chromeAccountLinkName // Localized value
                },
                {
                    "linkUrl": "Contact.html?"
                        + document.URL.split("?")[1],
                    "displayName": chromeContactUsLinkName // Localized value
                }
            ]
        };

ChromeStrings という名前の JavaScript ファイルを Web アプリケーションプロジェクトに追加します。そこでは直前の手順で使用された変数を宣言して、ロケールに依存しない言語でそれぞれに値を割り当てる必要があります。
```
var chromeAppTitle = "My SharePoint add-in";
var chromeAccountLinkName = "Account settings";
var chromeContactUsLinkName = "Contact us";
```
アドインをローカライズする言語ごとに、ChromeStrings.LL-CC.js という名前の別の JavaScript ファイルを追加します。ここで、LL-CC は言語 ID です。 ファイル名のベース (このケースでは "ChromeStrings") は、ロケールに依存しない言語のファイルに使用したものと完全に同じでなければなりません。 ロケールに依存しない言語のファイルの内容をローカライズされる各ファイルにコピーして、それらの値を翻訳されたバージョンに置き換えます。
```
var chromeAppTitle = "Mi aplicación SharePoint";
var chromeAccountLinkName = "Preferencias";
var chromeContactUsLinkName = "Contacto";
```
スクリプト SP.UI.controls.js が呼び出されるすべてのページファイルで、その上の ChromeStrings.js に対する呼び出しを追加します。たとえば、SP.UI.controls.js への呼び出しが ChromeLoader.js という名前の中間ファイルに読み込まれる場合、この時点でのページのマークアップは次のようになるはずです。
```
<Scripts>
    <asp:ScriptReference Path="Scripts/ChromeStrings.js" />
    <asp:ScriptReference Path="Scripts/ChromeLoader.js" />
</Scripts>
```
文字列を呼び出す ScriptReference 要素に ResourceUICultures 属性を追加します。これはサポートする言語のコンマ区切りリストです。
```
<Scripts>
    <asp:ScriptReference Path="Scripts/ChromeStrings.js" ResourceUICultures="en-US,es-ES" />
    <asp:ScriptReference Path="Scripts/ChromeLoader.js" />
</Scripts>
```
ResourceUICultures 属性の効果として、ASP.NET は ChromeStrings.LL-CC.js という名前のファイルを検索して読み込みます。ここで、LL-CC はページの言語であり、それが読み込まれます。そのようなファイルが見つからない場合、ChromeStrings.js ファイルを読み込みます。

ローカライズされた SharePoint アドインをテストする

アドインでサポートされるいずれかの言語で準備された SharePoint Web サイトに展開することによって、アドインをテストします。 SharePoint Online Web サイトまたは社内 Web サイトでアドインをテストできます。

SharePoint Online Web サイトでアドインをテストするには

Office 365 管理センターに移動します。
ナビゲーションメニューで [サービス設定]、[サイト] の順に選択します。
サイトコレクションで [サイトコレクションの作成] を選択します。
[言語の選択] で、アドインをテストする言語を選択します。
[テンプレートの選択] で、[開発者向けサイト] を選択します。
SharePoint アドインプロジェクトで SiteUrl プロパティを、新しいサイトコレクションの URL で更新します。
F5 キーを選択してアドインを実行します。

サイトコレクションページの作成

オンプレミスの Web サイトでアドインをテストする方法

アドインをテストする言語パックをインストールします。詳細については、「SharePoint 用の言語パックをインストールまたはアンインストールする」および「SharePoint Server 2013 の言語パックのダウンロード」を参照してください。
ファームの全体管理を開きます。
[アプリケーション構成の管理] で、[サイトコレクションの作成] を選択します。
[言語の選択] で、アドインをテストする言語を選択します。
[テンプレートの選択] で、[開発者向けサイト] を選択します。
SharePoint アドインプロジェクトで SiteUrl プロパティを、新しく作成したサイトコレクションの URL に更新します。
F5 キーを選択してアドインを実行します。

SharePoint アドインをローカライズする

SharePoint アドインのローカライズを準備する

アドイン Web コンポーネントをローカライズする

アドイン Web のリソース ファイルを作成する方法

カスタム リスト内のローカライズされたリソースを呼び出す方法

カスタム リストの列名をローカライズする方法

カスタム ページ用の JavaScript リソース ファイルを作成する方法

カスタム ASPX ページでローカライズされた変数を呼び出す方法

ホスト Web コンポーネントをローカライズする

ホスト Web のリソース ファイルを作成する方法

アドイン マニフェスト ファイル、その他の XML ファイル内のローカライズされたリソースを呼び出す方法

SharePoint アドイン内のリモート コンポーネントをローカライズする

リモート JavaScript と SharePoint クロム コントロールのローカライズ

クロム コントロールをローカライズする方法