System.Resources.MissingManifestResourceException classe

Este artigo fornece observações complementares à documentação de referência para essa API.

Uma MissingManifestResourceException exceção é lançada por motivos diferentes em aplicativos .NET versus UWP.

Aplicativos .NET

Em aplicativos .NET, MissingManifestResourceException é lançado quando a tentativa de recuperar um recurso falha porque o conjunto de recursos para a cultura neutra não pôde ser carregado de um assembly específico. Embora a exceção seja lançada quando você tenta recuperar um recurso específico, ela é causada pela falha ao carregar o conjunto de recursos em vez da falha em localizar o recurso.

As principais causas da exceção incluem o seguinte:

• O conjunto de recursos não é identificado por seu nome totalmente qualificado. Por exemplo, se o baseName parâmetro na chamada para o método especificar o nome raiz do conjunto de recursos sem um namespace, mas o conjunto de recursos for atribuído a um namespace quando ele for armazenado em seu assembly, a chamada para o ResourceManager.GetStringResourceManager.ResourceManager(String, Assembly) método lançará essa exceção.

  Se você tiver incorporado o arquivo .resources que contém os recursos da cultura padrão em seu executável e seu aplicativo estiver lançando um MissingManifestResourceException, poderá usar uma ferramenta de reflexão, como o IL Disassembler (Ildasm.exe), para determinar o nome totalmente qualificado do recurso. No ILDasm, clique duas vezes no rótulo MANIFEST do executável para abrir a janela MANIFEST. Os recursos aparecem como .mresource itens e são listados após referências de assembly externo e atributos personalizados no nível do assembly. Você também pode compilar o seguinte utilitário simples, que lista os nomes totalmente qualificados de recursos incorporados no assembly cujo nome é passado para ele como um parâmetro de linha de comando.

  using System;
  using System.IO;
  using System.Reflection;
  
  public class Example0
  {
     public static void Main()
     {
        if (Environment.GetCommandLineArgs().Length == 1) { 
           Console.WriteLine("No filename.");
           return;
        }
        
        string filename = Environment.GetCommandLineArgs()[1].Trim();
        // Check whether the file exists.
        if (! File.Exists(filename)) {
           Console.WriteLine("{0} does not exist.", filename);
           return;
        }   
        
        // Try to load the assembly.
        Assembly assem = Assembly.LoadFrom(filename);
        Console.WriteLine("File: {0}", filename);
           
        // Enumerate the resource files.
        string[] resNames = assem.GetManifestResourceNames();
        if (resNames.Length == 0)
           Console.WriteLine("   No resources found.");
  
        foreach (var resName in resNames)
           Console.WriteLine("   Resource: {0}", resName.Replace(".resources", ""));
  
        Console.WriteLine();
     }
  }
  

  Imports System.IO
  Imports System.Reflection
  Imports System.Resources
  
  Module Example3
      Public Sub Main()
          If Environment.GetCommandLineArgs.Length = 1 Then
              Console.WriteLine("No filename.")
              Exit Sub
          End If
          Dim filename As String = Environment.GetCommandLineArgs(1).Trim()
          ' Check whether the file exists.
          If Not File.Exists(filename) Then
              Console.WriteLine("{0} does not exist.", filename)
              Exit Sub
          End If
  
          ' Try to load the assembly.
          Dim assem As Assembly = Assembly.LoadFrom(filename)
          Console.WriteLine("File: {0}", filename)
  
          ' Enumerate the resource files.
          Dim resNames() As String = assem.GetManifestResourceNames()
          If resNames.Length = 0 Then
              Console.WriteLine("   No resources found.")
          End If
          For Each resName In resNames
              Console.WriteLine("   Resource: {0}", resName.Replace(".resources", ""))
          Next
          Console.WriteLine()
      End Sub
  End Module
  

• Você identifica o conjunto de recursos por seu nome de arquivo de recurso (junto com seu namespace opcional) e sua extensão de arquivo, em vez de apenas por seu namespace e nome de arquivo raiz. Por exemplo, essa exceção será lançada se o conjunto de recursos da cultura neutra for nomeado GlobalResources e você fornecer um valor de (em vez de GlobalResourcesGlobalResources.resources ) para o baseNameResourceManager.ResourceManager(String, Assembly) parâmetro do construtor.

• O conjunto de recursos específicos da cultura identificado em uma chamada de método não pode ser encontrado e o conjunto de recursos de fallback não pode ser carregado. Por exemplo, se você criar assemblies satélite para as culturas inglês (Estados Unidos) e Rússia (russo), mas não fornecer um conjunto de recursos para a cultura neutra, essa exceção será lançada se a cultura atual do aplicativo for inglês (Reino Unido).

MissingManifestResourceException usa o HRESULT COR_E_MISSINGMANIFESTRESOURCE, que tem o valor 0x80131532.

MissingManifestResourceException usa a implementação Equals padrão, que oferece suporte à igualdade de referência.

Para obter uma lista de valores de propriedade inicial para uma instância do MissingManifestResourceException, consulte o MissingManifestResourceException construtores.

Aplicativos da UWP (Plataforma Universal do Windows)

Os aplicativos UWP implantam recursos para várias culturas, incluindo a cultura neutra, em um único arquivo de índice de recursos de pacote (.pri). Como resultado, em um aplicativo UWP, se os recursos para a cultura preferencial não puderem ser encontrados, o MissingManifestResourceException será lançado sob uma das seguintes condições:

• O aplicativo não inclui um arquivo .pri ou o arquivo .pri não pôde ser aberto.
• O arquivo .pri do aplicativo não contém um conjunto de recursos para o nome raiz fornecido.