Melokalkan solusi SharePoint

Artikel
04/27/2023

Proses persiapan aplikasi Anda sehingga dapat digunakan di seluruh dunia dikenal sebagai pelokalan. Pelokalan menerjemahkan sumber daya ke budaya tertentu. Untuk mendapatkan informasi selengkapnya, lihat Melokalkan Aplikasi. Topik ini memberikan gambaran umum tentang cara melokalkan solusi SharePoint.

Untuk melokalkan solusi, Anda menghapus string yang dikodekan secara permanen dari kode dan mengabstraksikannya ke dalam file sumber. File Sumber Daya adalah file berbasis XML dengan .resx ekstensi. File sumber memuat versi string yang diterjemahkan yang digunakan dalam solusi Anda. Untuk mendapatkan informasi selengkapnya, lihat Sumber di Aplikasi.

Catatan

Tambahkan hanya sumber string untuk file sumber solusi SharePoint. Meskipun Editor Sumber Daya memungkinkan Anda menambahkan sumber daya non-string, sumber daya non-string tidak disebarkan ke SharePoint.

File sumber daya

Ada tiga jenis file sumber: default, netral bahasa, dan spesifik bahasa.

Jenis File Sumber	Deskripsi
Default	Juga dikenal sebagai sumber fallback, file sumber default memuat string yang dilokalkan untuk budaya default, seperti bahasa Inggris. File tersebut digunakan jika tidak ada file sumber daya yang dilokalkan untuk bahasa yang ditentukan yang dapat ditemukan. Sumber daya default tidak memiliki file terpisah, file tersebut disimpan di perakitan aplikasi utama.
Netral bahasa	File sumber yang memuat string yang dilokalkan untuk bahasa, tetapi bukan budaya tertentu. Contohnya, “fr” untuk bahasa Prancis.
Khusus bahasa	File sumber yang memuat string yang dilokalkan untuk bahasa dan budaya. Contohnya, “fr-CA” untuk Kanada Prancis.

Untuk mendapatkan informasi selengkapnya, lihat Organisasi Sumber Hierarkis untuk Pelokalan.

Untuk menentukan file sumber default dalam proyek SharePoint yang Anda kembangkan di Visual Studio, pilih Bahasa Invarian (Negara Invarian) dalam daftar budaya kotak dialog Tambahkan Sumber ketika Anda menambahkan file sumber.

Menambahkan file sumber daya

Perintah untuk menambahkan file sumber daya ada di menu pintasan node solusi dan node fitur di Penjelajah Solusi.

Untuk menambahkan file sumber daya global ke solusi SharePoint

Di Visual Studio, buka solusi SharePoint.
Di Penjelajah Solusi, pilih simpul proyek SharePoint, lalu, pada bilah menu, pilih Tambahkan Item Baru Proyek>.
Dalam kotak dialog Tambahkan Item Baru, pilih templat File Sumber Daya Global, lalu pilih tombol Tambahkan .

Catatan

Templat item proyek File Sumber Daya Global hanya muncul saat item proyek SharePoint dipilih.
Dalam kotak dialog Tambahkan Sumber Daya, pilih budaya untuk file sumber daya, seperti Bahasa Inggris (Amerika Serikat).

Langkah ini menambahkan file sumber daya global ke solusi Anda dalam format, , {Resource_x_}.{culture}.resxseperti, Resource1.en-US.resx.
Saat Editor Sumber Daya terbuka di Visual Studio, tambahkan sumber daya ke file sumber daya.

Untuk menambahkan file sumber daya fitur ke fitur SharePoint

Jika solusi SharePoint belum terbuka di Visual Studio, buka solusinya.
Di Penjelajah Solusi, buka menu pintasan untuk nama fitur di bawah node Fitur, lalu pilih Tambahkan Sumber Daya Fitur.

Langkah ini menambahkan file sumber daya ke fitur dalam format, , {ResourceFileName}.{culture}{.resx}seperti, Feature1.en-US.resx.
Saat Editor Sumber Daya terbuka di Visual Studio, tambahkan sumber daya ke file sumber daya.

Melokalkan solusi Visual Studio SharePoint

Ketika Anda melokalkan solusi, Anda harus mempertimbangkan semua informasi tekstual yang ditampilkan solusi Anda kepada pengguna. Pesan informasi, pesan kesalahan, dan string UI harus diterjemahkan dan terjemahan tersebut ditempatkan dalam file sumber.

Setiap string dalam file sumber memiliki pengidentifikasi unik. Gunakan pengidentifikasi yang sama untuk string yang diterjemahkan di setiap file sumber. Contohnya, jika “String1” adalah pengidentifikasi untuk string pertama dalam file sumber default, gunakan pengidentifikasi yang sama untuk string pertama dalam file sumber khusus bahasa.

Terdapat tiga area yang biasanya Anda lokalkan dalam aplikasi Visual Studio SharePoint: fitur, markup halaman ASPX, dan kode. Untuk tujuan ilustrasi, bagian berikut mengasumsikan Anda memiliki solusi SharePoint yang ingin Anda lokalkan ke dalam bahasa Jerman dan Jepang. Bahasa defaultnya adalah bahasa Inggris.

Melokalkan fitur

Untuk melokalkan fitur, Anda harus mengganti judul dan deskripsi fitur yang dikodekan secara permanen dengan ekspresi yang mereferensikan judul dan string yang diterjemahkan dalam file sumber yang dilokalkan. Anda melakukan perubahan ini di Perancang Fitur di Visual Studio.

Untuk melokalkan fitur bahasa Inggris Anda ke dalam bahasa Jerman dan Jepang, Anda menambahkan tiga item proyek File Sumber ke proyek Anda: satu item untuk bahasa Inggris, satu item untuk bahasa Jerman, dan satu item untuk bahasa Jepang. File sumber daya fitur tidak dapat digunakan untuk melokalisasi markup atau kode ASPX; file sumber daya terpisah diperlukan untuk file tersebut.

Setelah Anda membuat file sumber fitur, tambahkan string yang diterjemahkan ke file tersebut. Akses string yang dilokalkan dengan ekspresi dalam format berikut:

$Resources:String ID

Sumber fitur dalam Visual Studio selalu diberi nama Sumber. Jika Anda memilih bahasa selain Bahasa Invarian, maka ID budaya ditambahkan ke nama file sumber. Contohnya, jika Anda menambahkan file sumber fitur bahasa invarian (default), file tersebut disebut Resources.resx. Jika Anda menambahkan sumber fitur khusus bahasa dengan memilih budaya Jepang, file tersebut disebut Resources.ja-JP.resx. Nama file sumber daya fitur ditetapkan secara otomatis dan tidak dapat diubah.

Cakupan sumber daya fitur bersifat lokal untuk fitur tempat sumber daya tersebut ditambahkan. Untuk membuat sumber yang dapat digunakan oleh file fitur atau elemen dalam solusi, tambahkan item proyek File Sumber Global alih-alih File sumber fitur. Item proyek File Sumber Global terletak di folder 2010 di bawah SharePoint dalam kotak dialog Tambahkan Item Baru. File sumber global disebarkan ke folder \Resources dari folder akar SharePoint.

Untuk melokalkan fitur

Di Penjelajah Solusi, buka menu pintasan untuk node Feature1, lalu pilih Tambahkan Sumber Fitur.
Di kotak dialog Tambahkan Sumber, pilih Bahasa Invarian dari daftar sebagai kultur untuk file sumber fitur bahasa default.
Ulangi langkah sebelumnya untuk setiap bahasa yang dilokalkan, memilih bahasa pilihan Anda untuk file sumber fitur yang dilokalkan.

File sumber fitur terpisah dibuat: satu untuk bahasa default dan satu untuk setiap bahasa lokal yang ingin Anda dukung.
Buka setiap file sumber di Editor Sumber, lalu masukkan semua ID string dan nilainya.

Misalnya, di file sumber fitur default, masukkan ID string Judul dengan nilai Judul Fitur Saya, dan ID string kedua Deskripsi dengan nilai Deskripsi Fitur Saya. Untuk setiap file sumber yang dilokalkan, gunakan ID string yang sama yang digunakan dalam sumber fitur default, tetapi masukkan string yang dilokalkan untuk nilai.
Setelah Anda memasukkan semua nilai sumber, buka menu pintasan untuk fitur (misalnya, Feature1.feature), lalu pilih Tampilkan Perancang untuk membuka fitur di Desainer Fitur.
Untuk melokalkan bidang Judul dan Deskripsi di fitur, gunakan format berikut untuk memasukkan nilai dalam kotaknya:

$Resources:ID String

Misalnya, masukkan $Resources:Judul di kotak Feature Title, dan $Resources:Deskripsi di kotak Deskripsi Fitur.

ID string harus cocok dengan ID yang digunakan di file sumber.
Pilih kunci F5 untuk membangun dan menjalankan aplikasi.
Di SharePoint, buka menu Tindakan Situs, pilih Pengaturan Situs, lalu, di bagian Tindakan Situs pilih link Kelola Fitur Situs.
Di SharePoint, ubah bahasa tampilan dari default.

Judul dan deskripsi fitur yang dilokalkan muncul di aplikasi. Untuk menampilkan sumber yang dilokalkan, server SharePoint harus menginstal paket bahasa yang cocok dengan kultur file sumber.

Melokalkan markup halaman ASPX

Untuk melokalkan halaman ASP.NET, Anda menambahkan tiga item proyek File Sumber ke proyek Anda: satu item untuk bahasa Inggris, satu item untuk bahasa Jerman, dan satu item untuk bahasa Jepang. Jika Anda tidak perlu melokalisasi kode selain markup, Anda dapat menambahkan File Sumber Daya Global.

halaman ASP.NET (.aspx) biasanya menggunakan nilai string yang dikodekan secara permanen. Untuk melokalisasi string ini, ganti dengan ekspresi yang mereferensikan sumber daya yang dilokalkan.

Untuk melokalisasi markup ASPX

Tambahkan file sumber daya terpisah: satu untuk bahasa default dan satu untuk setiap bahasa yang dilokalkan.

Jika Anda hanya melokalisasi markup dan bukan kode, tambahkan item proyek File Sumber Daya Global. Jika Anda melokalisasi kode dan markup, tambahkan item proyek File Sumber Daya.
1. Untuk menambahkan File Sumber Daya Global, di Penjelajah Solusi, buka menu pintasan untuk item proyek SharePoint, lalu pilih Tambahkan>Item Baru. Di bawah simpul SharePoint 2010 , pilih templat File Sumber Daya Global.
2. Untuk menambahkan File Sumber Daya, di Penjelajah Solusi, buka menu pintasan untuk item proyek SharePoint, lalu pilih Tambahkan>Item Baru. Pilih templat File Sumber.
Catatan

Pastikan untuk menambahkan file sumber daya ke item proyek SharePoint untuk mengaktifkan properti Tipe Penyebaran. Properti ini akan diperlukan nanti dalam prosedur ini. Jika solusi Anda tidak memiliki item proyek SharePoint, Anda bisa menambahkan Proyek SharePoint Kosong dan menghapus file Elements.xml defaultnya.
Beri nama file sumber daya bahasa default pilihan Anda yang ditambahkan dengan .resx ekstensi, seperti MyAppResources.resx. Gunakan nama dasar yang sama untuk setiap file sumber yang dilokalkan, tetapi tambahkan ID kultur. Misalnya, beri nama sumber lokal Jerman MyAppResources.de-DE.resx.
Ubah nilai properti Jenis Penyebaran dari setiap file sumber daya ke AppGlobalResource untuk menyebabkannya disebarkan ke folder App_GlobalResources server. Folder App_GlobalResources terletak di C:\inetpub\wwwroot\wss\VirtualDirectories\<nomor port>\App_GlobalResources.
Jika Anda menggunakan sumber daya untuk melokalisasi kode selain markup ASPX, biarkan nilai properti Tindakan Build dari setiap file sebagai Sumber Daya Tersemat. Jika Anda menggunakan file sumber daya hanya untuk melokalisasi markup, Anda dapat secara opsional mengubah nilai properti file menjadi Konten. Untuk informasi selengkapnya, lihat Melokalkan solusi SharePoint.

Catatan

Jika Anda menggunakan file sumber non-global, pindahkan ke folder item proyek untuk mengaktifkan properti Jenis Penyebaran dan properti khusus SharePoint lainnya.
Buka setiap file sumber daya dan tambahkan string yang dilokalkan, menggunakan ID string yang sama di setiap file.

Di markup XML untuk halaman atau kontrol ASPX, ganti string yang dikodekan secara permanen dengan nilai yang menggunakan format berikut:

<%$Resources:Resource File Name, String ID%>

Misalnya, untuk melokalisasi teks untuk kontrol label pada halaman aplikasi, Anda akan mengubah:

<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
<asp:Label ID="lbl" runat="server" Text="Label text"></asp:Label>
</asp:Content>

<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
<asp:Label ID="lbl" runat="server" Text="<%$Resources:MyAppResources,String1%>"></asp:Label>
</asp:Content>

Pilih kunci F5 untuk membangun dan menjalankan aplikasi.
Di SharePoint, ubah bahasa tampilan dari default.

String yang dilokalkan akan muncul di aplikasi. Untuk menampilkan sumber yang dilokalkan, server SharePoint harus menginstal paket bahasa yang cocok dengan kultur file sumber.

Melokalkan kode

Selain melokalkan String fitur dan markup ASP.NET, Anda juga harus melokalkan string pesan dan string kesalahan yang muncul dalam kode solusi Anda. Pesan informasi dan kesalahan yang dilokalkan terdapat dalam rakitan satelit. Rakitan satelit memuat string yang terlihat oleh pengguna, seperti teks UI dan pesan output seperti pengecualian.

Visual Studio menggunakan hub .NET Framework standar dan model spoke. Hub, atau rakitan program utama, memuat sumber bahasa default. Spoke, atau rakitan satelit, memuat sumber khusus bahasa. Untuk mendapatkan informasi selengkapnya, lihat Mengemas dan Menyebarkan Sumber. Rakitan satelit dikompilasi dari file sumber daya (.resx). Ketika Anda menambahkan file sumber khusus bahasa ke proyek Anda dan paket solusi, Visual Studio mengompilasi file sumber ke dalam rakitan satelit bernama {Project Name}.resources.dll.

Untuk melokalkan kode

Di Penjelajah Solusi, buka menu pintasan untuk item proyek, lalu pilih Tambahkan>Modul.

Pilih templat File Sumber.

Catatan

Pastikan untuk menambahkan file sumber ke item proyek SharePoint sehingga properti Jenis Penyebaran tersedia. Properti ini akan diperlukan nanti dalam prosedur ini.
Beri nama file sumber daya bahasa default pilihan Anda yang ditambahkan dengan .resx ekstensi, seperti MyAppResources.resx.
Ulangi langkah 1 dan 2 untuk menambahkan file sumber terpisah ke item proyek SharePoint: masing-masing satu untuk setiap bahasa yang dilokalkan.

Gunakan nama dasar yang sama untuk setiap file sumber yang dilokalkan, tetapi tambahkan ID kultur. Misalnya, beri nama sumber lokal Jerman MyAppResources.de-DE.resx.
Buka setiap file sumber dan tambahkan string yang dilokalkan. Gunakan ID string yang sama di setiap file.
Ubah nilai properti Jenis Penyebaran dari setiap file sumber menjadi AppGlobalResource agar setiap file disebarkan ke folder App_GlobalResources server.
Biarkan nilai properti Tindakan Build dari setiap file sebagai Sumber Tersemat.

Sumber yang disematkan akan dikompilasi ke dalam DLL proyek.
Kompilasikan proyek untuk membuat DLL satelit sumber daya.
Di Desainer Paket, pilih tab Tingkat Lanjut, lalu tambahkan rakitan satelit.
Dalam kotak Lokasi, tambahkan folder ID kultur ke jalur Lokasi, seperti de-DE\<Nama Item Proyek>.resources.dll.
Jika solusi Anda belum mereferensikan assembly System.Web , tambahkan referensi ke dalamnya, dan tambahkan direktif dalam kode Anda ke System.Web.
Temukan semua string yang dikodekan secara permanen pada kode Anda yang terlihat oleh pengguna, seperti teks UI, kesalahan, dan teks pesan. Ganti dengan panggilan ke metode GetGlobalResourceObject menggunakan sintaks berikut:
```
HttpContext.GetGlobalResourceObject("Resource File Name", "String ID")
```
Pilih kunci F5 untuk membangun dan menjalankan aplikasi.
Di SharePoint, ubah bahasa tampilan dari default.

String yang dilokalkan akan muncul di aplikasi. Untuk menampilkan sumber yang dilokalkan, server SharePoint harus menginstal paket bahasa yang cocok dengan kultur file sumber.

Kode yang tidak dilokalkan menggunakan nilai string yang dikodekan secara permanen. Untuk melokalkan string kode, ganti dengan panggilan ke GetGlobalResourceObject, yang merupakan metode yang mereferensikan sumber yang dilokalkan.

Pelokalan kode bagian web

Bagian web menyertakan fitur editor properti kustom yang menyertakan atribut kode yang menggunakan string yang dikodekan secara permanen, seperti WebDisplayName, Category, dan WebDescription. Untuk mengganti nilai string atribut ini, buat kelas terpisah yang berasal dari kelas atribut. Di kelas tersebut, atur properti atribut. Properti atribut bergantung pada kelas dasar. Contohnya, properti atribut WebDisplayName adalah DisplayNameValue dan properti atribut WebDescription adalah DescriptionValue.

Di kelas turunan, referensikan ID string dari file sumber dan objek ResourceManager untuk mendapatkan nilai yang dilokalkan untuk ID string. Kembalikan nilai ini ke atribut editor properti.

Lihat juga

Cara: Menggunakan file sumber daya untuk menentukan nama, properti, dan izin yang dilokalkan

Bagikan melalui