Compartilhar via


SPUserResource class

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

Thread safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Ver também

Referência

SPUserResource members

Microsoft.SharePoint namespace

DescriptionResource

NameResource

DescriptionResource

TitleResource

SPList.DescriptionResource

SPList.TitleResource

SPList.UserResources

TitleResource

CommandUIExtensionResource

DescriptionResource

TitleResource

SPWeb.DescriptionResource

SPWeb.TitleResource

SPWeb.UserResources

SPWeb.SupportedUICultures

Outros recursos

Multilingual User Interface (MUI)