ResourceSet.GetString Método

Definição

Namespace:

System.Resources

Assembly:

System.Runtime.dll

Assembly:

System.Resources.ResourceManager.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Retorna um recurso String com um nome especificado.

Sobrecargas

GetString(String)	Pesquisa um recurso String com o nome especificado.
GetString(String, Boolean)	Pesquisa um recurso String com o nome especificado, não diferenciando maiúsculas de minúsculas, se solicitado.

GetString(String)

Pesquisa um recurso String com o nome especificado.

public:
 virtual System::String ^ GetString(System::String ^ name);

public virtual string? GetString (string name);

public virtual string GetString (string name);

abstract member GetString : string -> string
override this.GetString : string -> string

Public Overridable Function GetString (name As String) As String

Parâmetros

name

String

Nome do recurso a ser pesquisado.

Retornos

String

O valor de um recurso se o valor for um String.

Exceções

ArgumentNullException

O parâmetro name é null.

InvalidOperationException

O recurso especificado por name não é um String.

ObjectDisposedException

O objeto foi fechado ou descartado.

GetString(String, Boolean)

Pesquisa um recurso String com o nome especificado, não diferenciando maiúsculas de minúsculas, se solicitado.

public:
 virtual System::String ^ GetString(System::String ^ name, bool ignoreCase);

public virtual string? GetString (string name, bool ignoreCase);

public virtual string GetString (string name, bool ignoreCase);

abstract member GetString : string * bool -> string
override this.GetString : string * bool -> string

Public Overridable Function GetString (name As String, ignoreCase As Boolean) As String

Parâmetros

name

String

Nome do recurso a ser pesquisado.

ignoreCase

Boolean

Indica se as maiúsculas/minúsculas do nome especificado devem ser ignoradas.

Retornos

String

O valor de um recurso se o valor for um String.

Exceções

ArgumentNullException

O parâmetro name é null.

InvalidOperationException

O recurso especificado por name não é um String.

ObjectDisposedException

O objeto foi fechado ou descartado.

Comentários

Se o valor do ignoreCase parâmetro for true, um recurso com o nome "Resource" será equivalente ao recurso com o nome "resource". No entanto, observe que esse método sempre executa comparações de cadeia de caracteres que não diferenciam maiúsculas de minúsculas usando CultureInfo.InvariantCulture. A vantagem é que os resultados de comparações de cadeia de caracteres que não diferenciam maiúsculas de minúsculas executadas por esse método são os mesmos em todos os computadores, independentemente da cultura. A desvantagem é que os resultados não são consistentes com as regras de casing de todas as culturas.

Por exemplo, o alfabeto turco tem duas versões do caractere I: uma com um ponto e outra sem um ponto. Em turco, o caractere I (Unicode 0049) é considerado a versão maiúscula de um caractere diferente ı (Unicode 0131). O caractere i (Unicode 0069) é considerado a versão minúscula de mais um caractere İ (Unicode 0130). De acordo com essas regras de maiúsculas e minúsculas, uma comparação de cadeia de caracteres que não diferencia maiúsculas de minúsculas dos caracteres i (Unicode 0069) e I (Unicode 0049) deve falhar para a cultura "tr-TR" (turco na Turquia). Usando o GetString método com ignoreCase set to true, essa comparação é bem-sucedida.