SPUserResource class

Artigo
05/12/2015

Representa um recurso localizável definida pelo usuário.

Inheritance hierarchy

System.Object
Microsoft.SharePoint.SPUserResource

Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaração
Public NotInheritable Class SPUserResource
'Uso
Dim instance As SPUserResource

public sealed class SPUserResource

Comentários

Um recurso do usuário é uma cadeia de caracteres que contém o texto que é usado pela interface do usuário multilíngue (MUI). Por exemplo, um recurso pode representar a descrição de um site. Nesse caso, um objeto único SPUserResource que representa a descrição conteria texto usado para cada uma das culturas suportadas pelo site da Web.

Quando um novo recurso é criado, o texto para todos os cultura é no idioma padrão do site da Web. Subsequentemente, alguém pode converter o texto para uma determinada cultura e adicionar a tradução para o recurso, substituindo o texto não traduzido. Uma maneira de fazer isso é para definir a propriedade Thread.CurrentUICulture do thread atualmente em execução para a cultura desejada e, em seguida, defina a propriedade de Value do objeto recursos como a cadeia de caracteres localizada. Outra técnica é chamar o método SetValueForUICulture , especificando a cultura e o valor localizado.

Examples

O exemplo a seguir é um aplicativo de console que imprime os dados do objeto SPUserResource retornado pela propriedade TitleResource de um objeto SPWeb . O aplicativo primeiramente imprime o nome do idioma associado a execução do thread e o valor de recurso correspondente. Imprime o nome do idioma padrão para o site e seu valor correspondente do recurso. Finalmente, se o MUI está habilitado para o site da Web, o aplicativo imprime os nomes e valores do recurso para cada idioma alternativo que suporta o site.

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

namespace ConsoleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            using (SPSite site = new SPSite("https://localhost"))
            {
                using (SPWeb web = site.RootWeb)
                {
                    // Get the user resource for the Web site's title.
                    SPUserResource resource = web.TitleResource;

                    string format = "Language: {0} | Value: {1}";

                    // Display the value of the resource in the language of the current thread.
                    Console.WriteLine("Current Thread");
                    Console.WriteLine(format, CultureInfo.CurrentCulture.Name, resource.Value);

                    // Display the value for the default language.
                    CultureInfo uiDefault = web.UICulture;
                    Console.WriteLine("\nWeb Site Default");
                    Console.WriteLine(format, uiDefault.Name, resource.GetValueForUICulture(uiDefault));

                    if (web.IsMultilingual)
                    {
                        // Display the value of the resource for each supported language.
                        Console.WriteLine("\nAlternate Languages");

                        IEnumerable<CultureInfo> cultures = web.SupportedUICultures;
                        foreach (CultureInfo culture in cultures)
                        {
                            if (culture.LCID == uiDefault.LCID)
                                continue;

                            string value = resource.GetValueForUICulture(culture);
                            Console.WriteLine(format, culture.Name, value);
                        }
                    }
                    else
                    {
                        Console.WriteLine("\nMUI is not enabled.");
                    }
                }
            }
            Console.Write("\nPress ENTER to continue....");
            Console.Read();
        }
    }
}

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

Module ConsoleApp

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

                ' Get the user resource for the Web site's title.
                Dim resource As SPUserResource = web.TitleResource

                Dim format As String = "Language: {0} | Value: {1}"

                ' Display the value of the resource in the language of the current thread.
                Console.WriteLine("Current Thread")
                Console.WriteLine(format, CultureInfo.CurrentCulture.Name, resource.Value)

                ' Display the value for the default language.
                Dim uiDefault As CultureInfo = web.UICulture
                Console.WriteLine(vbLf & "Web Site Default")
                Console.WriteLine(format, uiDefault.Name, resource.GetValueForUICulture(uiDefault))

                If web.IsMultilingual Then
                    ' Display the value of the resource for each supported language.
                    Console.WriteLine(vbLf & "Alternate Languages")

                    Dim cultures As IEnumerable(Of CultureInfo) = web.SupportedUICultures
                    For Each culture As CultureInfo In cultures
                        If culture.LCID = uiDefault.LCID Then
                            Continue For
                        End If

                        Dim value As String = resource.GetValueForUICulture(culture)
                        Console.WriteLine(format, culture.Name, value)
                    Next
                Else
                    Console.WriteLine(vbLf & "MUI is not enabled.")
                End If

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