CultureAndRegionInfoBuilder.Parent Propriedade

Definição

Namespace:

System.Globalization

Assembly:

sysglobl.dll

Obtém ou define o objeto CultureInfo que representa a cultura pai da cultura personalizada atual.

public:
 property System::Globalization::CultureInfo ^ Parent { System::Globalization::CultureInfo ^ get(); void set(System::Globalization::CultureInfo ^ value); };

public System.Globalization.CultureInfo Parent { get; set; }

member this.Parent : System.Globalization.CultureInfo with get, set

Public Property Parent As CultureInfo

Valor da propriedade

CultureInfo

O CultureInfo objeto que representa a cultura pai da cultura personalizada atual.

Exceções

InvalidOperationException

Em uma operação de conjuntos, o valor de cultura não foi encontrado. Possivelmente, o valor atribuído é uma cultura personalizada não registrada.

ArgumentNullException

Em uma operação de conjuntos, o valor é null.

ArgumentException

Em uma operação de conjuntos que atravessa os ancestrais da cultura atual, a cultura invariável não foi encontrada dentro de 10 gerações de ancestrais.

- ou -

Em uma operação de conjuntos, uma referência circular foi descoberta: o valor atribuído é um ancestral da cultura personalizada atual.

Comentários

As culturas têm uma hierarquia. Para culturas predefinidas, o pai de uma cultura específica é uma cultura neutra e o pai de uma cultura neutra é o InvariantCulture. A cultura pai abrange apenas o conjunto de informações que é comum entre seus filhos.

Geralmente, é recomendável que as culturas personalizadas estejam em conformidade com essa hierarquia. No entanto, por padrão, o Parent de uma cultura personalizada é a Parent da cultura na qual se baseia. Se o aplicativo criar uma cultura com CultureName "en-US-MyCulture" com base em "en-US", seu pai será "en" porque esse é o Parent de "en-US". Se o aplicativo usar "en-US" como a Parent da nova cultura personalizada, ele deverá definir esse valor explicitamente.

Se os recursos da cultura específica não estiverem disponíveis no sistema, os recursos para a cultura neutra serão usados. Se os recursos para a cultura neutra não estiverem disponíveis, os recursos inseridos no assembly main serão usados. Para obter mais informações sobre o processo de fallback de recursos, consulte Empacotamento e implantação de recursos.

A lista de culturas na API do Windows é ligeiramente diferente da lista de culturas no .NET Framework. Se a interoperabilidade com o Windows for necessária, por exemplo, por meio do mecanismo de invocação de plataforma, o aplicativo deverá usar uma cultura específica definida no .NET Framework. Isso garante a consistência com a localidade equivalente do Windows, que é identificada com o mesmo LCID.