SharePoint çözümlerini yerelleştirme

Makale
01/13/2024

Uygulamalarınızı dünya çapında kullanılabilmesi için hazırlama işlemi yerelleştirme olarak bilinir. Yerelleştirme, kaynakları belirli bir kültüre çevirir. Daha fazla bilgi için bkz . Uygulamaları Genelleştirme ve Yerelleştirme. Bu konu, SharePoint çözümünü yerelleştirmeye yönelik genel bir bakış sağlar.

Bir çözümü yerelleştirmek için koddan sabit kodlanmış dizeleri kaldırır ve kaynak dosyalarına soyutlarsınız. Kaynak dosyası, uzantılı XML tabanlı bir .resx dosyadır. Kaynak dosyası, çözümünüzde kullanılan dizelerin çevrilmiş sürümlerini içerir. Daha fazla bilgi için bkz . Uygulamalardaki Kaynaklar.

Not

SharePoint çözümü kaynak dosyalarına yalnızca dize kaynaklarını ekleyin. Kaynak Düzenleyicisi dize dışı kaynaklar eklemenize olanak sağlar ancak dize olmayan kaynaklar SharePoint'e dağıtılamaz.

Kaynak dosyalar

Üç tür kaynak dosyası vardır: varsayılan, dilden bağımsız ve dile özgü.

Kaynak Dosya Türü	Açıklama
Varsayılan	Geri dönüş kaynağı olarak da bilinen varsayılan kaynak dosyaları, İngilizce gibi varsayılan kültür için yerelleştirilmiş dizeler içerir. Belirtilen dil için yerelleştirilmiş kaynak dosyası bulunamazsa kullanılırlar. Varsayılan kaynakların ayrı dosyaları yoktur, bunlar ana uygulama derlemesinde depolanır.
Dilden bağımsız	Bir dil için yerelleştirilmiş ancak belirli bir kültür için yerelleştirilmiş dizeler içeren bir kaynak dosyası. Örneğin, Fransızca için "fr".
Dile özgü	Bir dil ve kültür için yerelleştirilmiş dizeler içeren bir kaynak dosyası. Örneğin, Fransızca Kanada için "fr-CA".

Daha fazla bilgi için bkz . Yerelleştirme için Kaynakların Hiyerarşik Kuruluşu.

Visual Studio'da geliştirdiğiniz SharePoint projelerinde varsayılan kaynak dosyalarını belirtmek için, kaynak dosyası eklediğinizde Kaynak Ekle iletişim kutusunun kültür listesinde Sabit Dil (Sabit Ülke) seçeneğini belirleyin.

Kaynak dosyası ekleme

Kaynak dosyaları ekleme komutları, Çözüm Gezgini çözüm düğümünün ve özellik düğümlerinin kısayol menüsünde bulunur.

SharePoint çözümüne genel kaynak dosyası eklemek için

Visual Studio'da bir SharePoint çözümü açın.
Çözüm Gezgini bir SharePoint proje düğümü seçin ve ardından menü çubuğunda Proje>Yeni Öğe Ekle'yi seçin.
Yeni Öğe Ekle iletişim kutusunda Genel Kaynaklar Dosya şablonunu ve ardından Ekle düğmesini seçin.

Not

Genel Kaynaklar Dosyası proje öğesi şablonu yalnızca bir SharePoint proje öğesi seçildiğinde görüntülenir.
Kaynak Ekle iletişim kutusunda, kaynak dosyası için İngilizce (Birleşik Devletler) gibi bir kültür seçin.

Bu adım, {Resource_x_}.{culture}.resxçözümünüze Resource1.en-US.resx gibi biçiminde bir genel kaynak dosyası ekler.
Kaynak Düzenleyicisi Visual Studio'da açıldığında kaynak dosyasına kaynak ekleyin.

SharePoint özelliğine özellik kaynak dosyası eklemek için

SharePoint çözümü Visual Studio'da açık değilse çözümü açın.
Çözüm Gezgini,Özellikler düğümünün altındaki bir özelliğin adı için kısayol menüsünü açın ve ardından Özellik Kaynağı Ekle'yi seçin.

Bu adım özelliğe {ResourceFileName}.{culture}{.resx}Feature1.en-US.resx gibi biçiminde bir kaynak dosyası ekler.
Kaynak Düzenleyicisi Visual Studio'da açıldığında kaynak dosyasına kaynak ekleyin.

Visual Studio SharePoint çözümlerini yerelleştirme

Bir çözümü yerelleştirirken, çözümünüzün kullanıcılara gösterdiği tüm metin bilgilerini göz önünde bulundurmanız gerekir. Bilgilendirici iletiler, hata iletileri ve kullanıcı arabirimi dizeleri çevrilmeli ve bu çeviriler kaynak dosyalarına yerleştirilmelidir.

Kaynak dosyasındaki her dizenin benzersiz bir tanımlayıcısı vardır. Her kaynak dosyasında çevrilen dize için aynı tanımlayıcıyı kullanın. Örneğin, "Dize1" varsayılan kaynak dosyasındaki ilk dizenin tanımlayıcısıysa, dile özgü kaynak dosyalarındaki ilk dize için aynı tanımlayıcıyı kullanın.

Visual Studio SharePoint uygulamalarında genellikle yerelleştirdiğiniz üç alan vardır: özellikler, ASPX sayfa işaretlemesi ve kod. Aşağıdaki bölümlerde, çizim amacıyla, Almanca ve Japonca olarak yerelleştirmek istediğiniz bir SharePoint çözümünüz olduğu varsayılır. Varsayılan dil İngilizce'dir.

Özellikleri yerelleştirme

Bir özelliği yerelleştirmek için, özelliğin sabit kodlanmış başlığını ve açıklamasını, yerelleştirilmiş kaynaklar dosyasındaki çevrilmiş başlığa ve dizeye başvuran bir ifadeyle değiştirmeniz gerekir. Bu değişikliği Visual Studio'daki Özellik Tasarım Aracı yaparsınız.

İngilizce özelliğinizi Almanca ve Japonca olarak yerelleştirmek için projenize üç Kaynak Dosyası proje öğesi eklersiniz: biri İngilizce, biri Almanca ve biri Japonca için. Özellik kaynak dosyaları ASPX işaretlemesini veya kodunu yerelleştirmek için kullanılamaz; bunlar için ayrı kaynak dosyaları gereklidir.

Özellik kaynak dosyalarını oluşturduktan sonra, bunlara çevrilmiş dizeler ekleyin. Aşağıdaki biçimde bir ifadeyle yerelleştirilmiş dizelere erişin:

$Resources:String ID

Visual Studio'daki özellik kaynakları her zaman Kaynaklar olarak adlandırılır. Sabit Dil dışında bir dil seçerseniz, kaynak dosya adına bir kültür kimliği eklenir. Örneğin, sabit bir dil (varsayılan) özellik kaynak dosyası eklerseniz, buna Resources.resx adı verilir. Japonca (Japonya) kültürü seçerek dile özgü bir özellik kaynağı eklerseniz, dosya Resources.ja-JP.resx olarak adlandırılır. Özellik kaynak dosyası adları otomatik olarak atanır ve değiştirilemez.

Özellik kaynaklarının kapsamı, eklendikleri özelliğin yerelidir. Çözümdeki herhangi bir özellik veya öğe dosyası tarafından kullanılabilecek kaynaklar oluşturmak için özellik kaynağı Dosyası yerine Genel Kaynaklar Dosyası proje öğesi ekleyin. Genel Kaynaklar Dosyası proje öğesi, Yeni Öğe Ekle iletişim kutusundaki SharePoint'in altındaki 2010 klasöründe bulunur. Genel kaynak dosyaları SharePoint kök klasörünün \Resources klasörüne dağıtılır.

Bir özelliği yerelleştirmek için

Çözüm Gezgini'de, Feature1 düğümünün kısayol menüsünü açın ve ardından Özellik Kaynağı Ekle'yi seçin.
Kaynak Ekle iletişim kutusunda, varsayılan dil özelliği kaynak dosyasının kültürü olarak listeden Sabit Dil'i seçin.
Yerelleştirilmiş özellik kaynak dosyaları için seçtiğiniz dilleri seçerek her yerelleştirilmiş dil için önceki adımı yineleyin.

Ayrı özellik kaynak dosyaları oluşturulur: biri varsayılan dil için, diğeri de desteklemek istediğiniz her yerelleştirilmiş dil için.
Her kaynak dosyasını Kaynak Düzenleyicisi'nde açın ve tüm dize kimliklerini ve değerlerini girin.

Örneğin, varsayılan özellik kaynak dosyasında, Özellik Başlığım değerine sahip başlık dizesi kimliğini ve Özellik Açıklamam değeriyle açıklamanın ikinci dize kimliğini girin. Her yerelleştirilmiş kaynak dosyası için varsayılan özellik kaynağında kullanılan dize kimliklerini kullanın, ancak değerler için yerelleştirilmiş dizeler girin.
Tüm kaynak değerlerini girdikten sonra özelliğin kısayol menüsünü açın (örneğin, Feature1.feature) ve ardından Özelliği Özellik Tasarım Aracı açmak için Tasarım Aracı Görüntüle'yi seçin.
Özellikteki Başlık ve Açıklama alanlarını yerelleştirmek için, kutularına değer girmek için aşağıdaki biçimi kullanın:

$Resources:Dize Kimliği

Örneğin, Özellik Başlığı kutusuna $Resources:Başlıkyazın ve Özellik Açıklaması kutusuna $Resources:Açıklama yazın.

Dize kimlikleri, kaynak dosyalarında kullanılanlarla eşleşmelidir.
Uygulamayı derlemek ve çalıştırmak için F5 anahtarını seçin.
SharePoint'te, Site Eylemleri menüsünü açın, Site Ayarlar'ı seçin ve ardından Site Eylemleri bölümünde Site Özelliklerini Yönet bağlantısını seçin.
SharePoint'te görüntüleme dilini varsayılandan değiştirin.

Yerelleştirilmiş özellik başlığı ve açıklaması uygulamada görünür. Yerelleştirilmiş kaynakları görüntülemek için, SharePoint sunucusunda kaynak dosyasının kültürüyle eşleşen bir dil paketi yüklü olmalıdır.

ASPX sayfa işaretlemesini yerelleştirme

ASP.NET sayfaları yerelleştirmek için projenize üç Kaynak Dosyası proje öğesi eklersiniz: biri İngilizce, biri Almanca ve biri Japonca. İşaretlemenin yanı sıra kodu yerelleştirmeniz gerekmiyorsa, bunun yerine Genel Kaynak Dosyaları ekleyebilirsiniz.

ASP.NET (.aspx) sayfaları genellikle sabit kodlanmış dize değerleri kullanır. Bu dizeleri yerelleştirmek için, bunları yerelleştirilmiş kaynaklara başvuran ifadelerle değiştirin.

ASPX işaretlemesini yerelleştirmek için

Ayrı kaynak dosyaları ekleyin: varsayılan dil için bir dosya ve her yerelleştirilmiş dil için bir tane.

Kod değil de yalnızca işaretlemeyi yerelleştiriyorsanız, genel kaynaklar dosyası proje öğesi ekleyin. Kodu ve işaretlemeyi yerelleştiriyorsanız bir Kaynak Dosyası proje öğesi ekleyin.
1. Genel Kaynaklar Dosyası eklemek için, Çözüm Gezgini sharepoint proje öğesinin kısayol menüsünü açın ve ardından Yeni Öğe Ekle'yi>seçin. SharePoint 2010 düğümü altında Genel Kaynaklar Dosyası şablonunu seçin.
2. Kaynak Dosyası eklemek için, Çözüm Gezgini bir SharePoint proje öğesinin kısayol menüsünü açın ve ardından Yeni Öğe Ekle'yi>seçin. Kaynak Dosyası şablonunu seçin.
Not

Dağıtım Türü özelliğini etkinleştirmek için kaynak dosyalarını bir SharePoint proje öğesine eklediğinizden emin olun. Bu özellik, bu yordamın ilerleyen bölümlerinde gereklidir. Çözümünüzde SharePoint proje öğesi yoksa Boş Bir SharePoint Projesi ekleyebilir ve varsayılan Elements.xml dosyasını kaldırabilirsiniz.
Varsayılan dil kaynak dosyasına, MyAppResources.resx gibi bir uzantı eklenmiş olarak seçtiğiniz bir .resx ad verin. Her yerelleştirilmiş kaynak dosyası için aynı temel adı kullanın, ancak kültür kimliğini ekleyin. Örneğin, MyAppResources.de-DE.resx adlı Bir Alman yerelleştirilmiş kaynağını adlandırarak.
Her kaynak dosyasının Dağıtım Türü özelliğinin değerini AppGlobalResource olarak değiştirerek sunucunun App_GlobalResources klasörüne dağıtılmasına neden olun. App_GlobalResources klasörü C:\inetpub\wwwroot\wss\VirtualDirectories\<port number>\App_GlobalResources konumunda bulunur.
ASPX işaretlemesine ek olarak kodu yerelleştirmek için kaynakları kullanıyorsanız, her dosyanın Derleme Eylemi özelliğinin değerini Katıştırılmış Kaynak olarak bırakın. Kaynak dosyalarını yalnızca işaretlemeyi yerelleştirmek için kullanıyorsanız, isteğe bağlı olarak dosyaların özellik değerini İçerik olarak değiştirebilirsiniz. Daha fazla bilgi için bkz . SharePoint çözümlerini yerelleştirme.

Not

Genel olmayan kaynak dosyaları kullanıyorsanız, Dağıtım Türü özelliğini ve SharePoint'e özgü diğer özellikleri etkinleştirmek için bunları proje öğesi klasörüne taşıyın.
Her kaynak dosyasını açın ve her dosyadaki aynı dize kimliklerini kullanarak yerelleştirilmiş dizeler ekleyin.

ASPX sayfasının veya denetiminin XML işaretlemesinde, sabit kodlanmış dizeleri aşağıdaki biçimi kullanan değerlerle değiştirin:

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

Örneğin, bir uygulama sayfasındaki etiket denetiminin metnini yerelleştirmek için şunları değiştirebilirsiniz:

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

kullanıcısı

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

Uygulamayı derlemek ve çalıştırmak için F5 anahtarını seçin.
SharePoint'te görüntüleme dilini varsayılandan değiştirin.

Yerelleştirilmiş dizeler uygulamada görünür. Yerelleştirilmiş kaynakları görüntülemek için, SharePoint sunucusunda kaynak dosyasının kültürüyle eşleşen bir dil paketi yüklü olmalıdır.

Kodu yerelleştirme

Özellik dizelerini ve ASP.NET işaretlemesini yerelleştirmeye ek olarak, çözüm kodunuzda görünen ileti dizelerini ve hata dizelerini de yerelleştirmeniz gerekir. Yerelleştirilmiş bilgi ve hata iletileri uydu derlemelerinde yer alır. Uydu derlemeleri, kullanıcı arabirimi metni ve özel durumlar gibi çıkış iletileri gibi kullanıcılar tarafından görülebilen dizeler içerir.

Visual Studio standart .NET Framework hub ve uç modelini kullanır. Hub veya ana program derlemesi varsayılan dil kaynaklarını içerir. Uçlar veya uydu derlemeleri dile özgü kaynakları içerir. Daha fazla bilgi için bkz . Kaynakları Paketleme ve Dağıtma. Uydu derlemeleri kaynak (.resx) dosyalardan derlenir. Projenize ve çözüm paketine dile özgü kaynak dosyaları eklediğinizde, Visual Studio kaynak dosyalarını {Project Name}.resources.dll adlı uydu derlemelerinde derler.

Kodu yerelleştirmek için

Çözüm Gezgini bir proje öğesinin kısayol menüsünü açın ve modül ekle'yi> seçin.

Kaynak Dosyası şablonunu seçin.

Not

Dağıtım Türü özelliğinin kullanılabilir olması için kaynak dosyasını bir SharePoint proje öğesine eklediğinizden emin olun. Bu özellik, bu yordamın ilerleyen bölümlerinde gereklidir.
Varsayılan dil kaynak dosyasına, MyAppResources.resx gibi bir uzantı eklenmiş olarak seçtiğiniz bir .resx ad verin.
SharePoint proje öğesine ayrı kaynak dosyaları eklemek için 1. ve 2. adımları yineleyin: her yerelleştirilmiş dil için bir tane.

Her yerelleştirilmiş kaynak dosyası için aynı temel adı kullanın, ancak kültür kimliğini ekleyin. Örneğin, MyAppResources.de-DE.resx adlı Bir Alman yerelleştirilmiş kaynağını adlandırarak.
Her kaynak dosyasını açın ve yerelleştirilmiş dizeler ekleyin. Her dosyada aynı dize kimliklerini kullanın.
Her dosyanın sunucunun App_GlobalResources klasörüne dağıtılmasına neden olmak için her kaynak dosyasının Dağıtım Türü özelliğinin değerini AppGlobalResource olarak değiştirin.
Her dosyanın Derleme Eylemi özelliğinin değerini Katıştırılmış Kaynak olarak bırakın.

Katıştırılmış kaynaklar projenin DLL'sinde derlenir.
Kaynak uydu DLL'lerini oluşturmak için projeyi oluşturun.
Paket Tasarım Aracı Gelişmiş sekmesini seçin ve uydu derlemesini ekleyin.
Konum kutusunda, konum yoluna de-DE\<Project Item Name.resources.dll> gibi bir kültür kimliği klasörü ekleyin.
Çözümünüz henüz derlemeye System.Web başvurmuyorsa, buna bir başvuru ekleyin ve kodunuza System.Webbir yönerge ekleyin.
Kodunuzda kullanıcı arabirimi metni, hatalar ve ileti metni gibi kullanıcılar tarafından görülebilen tüm sabit kodlanmış dizeleri bulun. Aşağıdaki söz dizimini kullanarak bunları yöntemine yapılan GetGlobalResourceObject bir çağrıyla değiştirin:
```
HttpContext.GetGlobalResourceObject("Resource File Name", "String ID")
```
Uygulamayı derlemek ve çalıştırmak için F5 anahtarını seçin.
SharePoint'te görüntüleme dilini varsayılandan değiştirin.

Yerelleştirilmiş dizeler uygulamada görünür. Yerelleştirilmiş kaynakları görüntülemek için, SharePoint sunucusunda kaynak dosyasının kültürüyle eşleşen bir dil paketi yüklü olmalıdır.

Ayrılmamış kod, sabit kodlanmış dize değerlerini kullanır. Kod dizelerini yerelleştirmek için, yerelleştirilmiş kaynaklara GetGlobalResourceObjectbaşvuran bir yöntem olan çağrısıyla değiştirin.

Web bölümü kodu yerelleştirmesi

Web bölümleri, WebDisplayName, Category ve WebDescription gibi sabit kodlanmış dizeler kullanan kod özniteliklerini içeren özel bir özellik düzenleyicisi özelliği içerir. Bu özniteliklerin dize değerlerini değiştirmek için özniteliğin sınıfından türetilen ayrı bir sınıf oluşturun. Bu sınıflarda özniteliğin özelliğini ayarlayın. öznitelik özelliği temel sınıfa bağlıdır. Örneğin, WebDisplayName öznitelik özelliği DisplayNameValue ve WebDescription öznitelik özelliği DescriptionValue'dır.

Türetilen sınıfta, dize kimliği için yerelleştirilmiş değeri almak için kaynak dosyasından dize kimliğine ve ResourceManager nesnesine başvurun. Bu değeri özellik düzenleyicisi özniteliğine döndür.

Ayrıca bkz.

Nasıl yapılır: Yerelleştirilmiş adları, özellikleri ve izinleri belirtmek için kaynak dosyası kullanma

Aracılığıyla paylaş