del método SPUtility.GetLocalizedString

Artículo
05/13/2015

Recupera el valor de una cadena de recurso con nombre del archivo de recursos para un idioma especificado.

Espacio de nombres: Microsoft.SharePoint.Utilities
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
Public Shared Function GetLocalizedString ( _
    source As String, _
    defaultResourceFile As String, _
    language As UInteger _
) As String
'Uso
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
)

Parámetros

source
Tipo: System.String

Una expresión de recurso ASP.NET en el formulario $Resources:keyname, donde keyname es el nombre de la mitad de un par de nombre/valor en un archivo de recursos (.resx).

defaultResourceFile
Tipo: System.String

El nombre de archivo base del archivo de recursos de idioma que contiene un valor de cadena localizada. Por ejemplo, si dispone de una serie de recursos con nombre de los archivos myresources.en-us.resx, myresources.es-es.resx, myresources.de-de.resx, y así sucesivamente, el valor para pasar en este parámetro es myresources.

language
Tipo: System.UInt32

El LCID del idioma de destino. Para obtener una lista, vea el tema de información general de la clase CultureInfo .

Valor devuelto

Tipo: System.String
El valor de cadena para el idioma especificado. Si no se encuentra un valor en el idioma solicitado, se devuelve el valor de todos los idiomas. Si no existe un archivo de recursos para todos los idiomas o el nombre de recurso especificado no existe, se devuelve la cadena de origen sin localización.

Comentarios

Este método puede recuperar un valor de cadena de un archivo de recursos que se encuentra en la carpeta de recursos que está justo debajo de la raíz de instalación SharePoint Foundation. El token que Visual Studio se usa para esta carpeta es {SharePointRoot}\Resources. La ruta de acceso completa es %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ recursos.

Ejemplos

En el siguiente ejemplo es una aplicación de consola que enumera los idiomas admitidos por un sitio Web. Para cada idioma, la aplicación obtiene el valor para el recurso denominado "onet_TeamSite" desde el archivo de recursos con el nombre de archivo base "principal".

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