SPUtility.GetLocalizedString 方法

从指定的语言的资源文件中检索的已命名的资源字符串的值。

命名空间： Microsoft.SharePoint.Utilities
程序集： Microsoft.SharePoint（位于 Microsoft.SharePoint.dll 中）

语法

声明
Public Shared Function GetLocalizedString ( _
    source As String, _
    defaultResourceFile As String, _
    language As UInteger _
) As String
用法
Dim source As String
Dim defaultResourceFile As String
Dim language As UInteger
Dim returnValue As String

returnValue = SPUtility.GetLocalizedString(source, _
    defaultResourceFile, language)

public static string GetLocalizedString(
    string source,
    string defaultResourceFile,
    uint language
)

参数

source
类型：System.String

窗体$Resources:keyname，其中keyname是名称中的 ASP.NET 资源表达式中的资源文件 (.resx) 的名称/值对的一半。

defaultResourceFile
类型：System.String

基文件名，包含本地化的字符串值的语言资源文件。例如，如果您有一系列的资源文件命名myresources.en-us.resx、 myresources.es-es.resx、 myresources.de-de.resx，和等等，此参数中传递的值是myresources。

language
类型：System.UInt32

目标语言的 LCID。有关列表，请参阅CultureInfo类概述主题。

返回值

类型：System.String
指定语言的字符串值。如果找不到请求的语言中的一个值，则返回固定语言的值。如果固定语言资源文件不存在或不存在指定的资源名称，源字符串返回，而不本地化。

备注

此方法可以从位于下方SharePoint Foundation安装根的资源文件夹的资源文件中检索一个 string 值。令牌该Visual Studio使用此文件夹是{SharePointRoot}\Resources。完整路径是%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\资源。

示例

下面的示例是一个控制台应用程序，枚举网站支持的语言。对于每种语言，应用程序获取基文件名"核心的"名为"onet_TeamSite"的资源文件中的资源的值。

using System;
using System.Collections.Generic;
using System.Globalization;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Utilities;

namespace ConsoleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            using (SPSite site = new SPSite("https://localhost"))
            {
                using (SPWeb web = site.RootWeb)
                {
                    if (web.IsMultilingual)
                    {
                        IEnumerable<CultureInfo> cultures = web.SupportedUICultures;
                        foreach (CultureInfo culture in cultures)
                        {
                            // Print the value of a language resource in the current language.
                            string str = "$Resources:onet_TeamWebSite";
                            string locStr = SPUtility.GetLocalizedString(str, "core", (uint)culture.LCID);

                            Console.WriteLine("{0}  {1}", culture.Name, locStr);
                        }
                    }
                }
            }
            Console.Write("\nPress ENTER to continue....");
            Console.ReadLine();
        }
    }
}

Imports System
Imports System.Collections.Generic
Imports System.Globalization
Imports Microsoft.SharePoint
Imports Microsoft.SharePoint.Utilities

Module ConsoleApp

    Sub Main()

        Using site As New SPSite("https://localhost")
            Using web As SPWeb = site.RootWeb

                Dim cultures As IEnumerable(Of CultureInfo) = web.SupportedUICultures
                For Each culture As CultureInfo In cultures

                    ' Print the value of a language resource in the current language.
                    Dim str As String = "$Resources:onet_TeamWebSite"
                    Dim locStr As String = SPUtility.GetLocalizedString(str, "core", CUInt(culture.LCID))

                    Console.WriteLine("{0}  {1}", culture.Name, locStr)

                Next

            End Using
        End Using

        Console.Write(vbCrLf & "Press ENTER to continue....")
        Console.Read()
    End Sub

End Module