MissingSatelliteAssemblyException Sınıf

Tanım

public ref class MissingSatelliteAssemblyException : SystemException

public class MissingSatelliteAssemblyException : SystemException

[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class MissingSatelliteAssemblyException : SystemException

type MissingSatelliteAssemblyException = class
    inherit SystemException

[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type MissingSatelliteAssemblyException = class
    inherit SystemException

Public Class MissingSatelliteAssemblyException
Inherits SystemException

Devralma

Object

Exception

SystemException

MissingSatelliteAssemblyException

Öznitelikler

ComVisibleAttribute SerializableAttribute

Örnekler

Aşağıdaki örnek, İngilizce'nin NeutralResourcesLanguageAttribute uygulamanın varsayılan kültürü olduğunu ve kaynaklarının bir uydu derlemesinde depolandığını belirtmek için özniteliğini kullanır. Örnek, aşağıdaki tabloda açıklandığı gibi İngilizce ve Fransızca kültürleri için .txt dosyalarındaki kaynakları içerir:

Aşağıdaki kaynak kodu, geçerli kullanıcı arabirimi kültürünü önce Fransızca (Fransa) ve ardından Rusça (Rusya) olarak değiştiren ve her iki durumda da kültüre özgü uygun bir kaynak görüntüleyen bir uygulama oluşturur.

using System;
using System.Globalization;
using System.Resources;
using System.Threading;

[assembly:NeutralResourcesLanguageAttribute("en", UltimateResourceFallbackLocation.Satellite)]

public class Example
{
   public static void Main()
   {
      ResourceManager rm = new ResourceManager("GreetResources", typeof(Example).Assembly); 
      Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("fr-FR");
      Console.WriteLine("The current UI culture is {0}", Thread.CurrentThread.CurrentUICulture.Name);
      Console.WriteLine(rm.GetString("Greet"));
      
      Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("ru-RU");
      Console.WriteLine("The current UI culture is {0}", Thread.CurrentThread.CurrentUICulture.Name);
      Console.WriteLine(rm.GetString("Greet"));
   }
}
// The example displays the following output when created using BuildNoDefault.bat: 
//    The current UI culture is fr-FR
//    Bonjour
//    The current UI culture is ru-RU
//    
//    Unhandled Exception: System.Resources.MissingSatelliteAssemblyException: 
//    The satellite assembly named "HelloWorld.resources.dll, PublicKeyToken=" for fallback culture 
//    "en" either could not be found or could not be loaded. This is generally a setup problem. 
//    Please consider reinstalling or repairing the application.
//       at System.Resources.ManifestBasedResourceGroveler.HandleSatelliteMissing()
//       at System.Resources.ManifestBasedResourceGroveler.GrovelForResourceSet(CultureInfo cult
//    ure, Dictionary`2 localResourceSets, Boolean tryParents, Boolean createIfNotExists, StackC
//    rawlMark& stackMark)
//       at System.Resources.ResourceManager.InternalGetResourceSet(CultureInfo requestedCulture
//    , Boolean createIfNotExists, Boolean tryParents, StackCrawlMark& stackMark)
//       at System.Resources.ResourceManager.InternalGetResourceSet(CultureInfo culture, Boolean
//     createIfNotExists, Boolean tryParents)
//       at System.Resources.ResourceManager.GetString(String name, CultureInfo culture)
//       at Example.Main()
// The example displays the following output when created using BuildDefault.bat:
//    The current UI culture is fr-FR
//    Bonjour
//    The current UI culture is ru-RU
//    Hello

Imports System.Globalization
Imports System.Resources
Imports System.Threading

<assembly:NeutralResourcesLanguageAttribute("en", UltimateResourceFallbackLocation.Satellite)>

Module Example
   Public Sub Main()
      Dim rm As New ResourceManager("GreetResources", GetType(Example).Assembly) 
      Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("fr-FR")
      Console.WriteLine("The current UI culture is {0}", Thread.CurrentThread.CurrentUICulture.Name)
      Console.WriteLine(rm.GetString("Greet"))
      
      Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("ru-RU")
      Console.WriteLine("The current UI culture is {0}", Thread.CurrentThread.CurrentUICulture.Name)
      Console.WriteLine(rm.GetString("Greet"))
   End Sub
End Module
' The example displays the following output:
'    The current UI culture is fr-FR
'    Bonjour
'    The current UI culture is ru-RU
'    
'    Unhandled Exception: System.Resources.MissingSatelliteAssemblyException: 
'    The satellite assembly named "HelloWorld.resources.dll, PublicKeyToken=" for fallback culture 
'    "en" either could not be found or could not be loaded. This is generally a setup problem. 
'    Please consider reinstalling or repairing the application.
'       at System.Resources.ManifestBasedResourceGroveler.HandleSatelliteMissing()
'       at System.Resources.ManifestBasedResourceGroveler.GrovelForResourceSet(CultureInfo cult
'    ure, Dictionary`2 localResourceSets, Boolean tryParents, Boolean createIfNotExists, StackC
'    rawlMark& stackMark)
'       at System.Resources.ResourceManager.InternalGetResourceSet(CultureInfo requestedCulture
'    , Boolean createIfNotExists, Boolean tryParents, StackCrawlMark& stackMark)
'       at System.Resources.ResourceManager.InternalGetResourceSet(CultureInfo culture, Boolean
'     createIfNotExists, Boolean tryParents)
'       at System.Resources.ResourceManager.GetString(String name, CultureInfo culture)
'       at Example.Main()
' The example displays the following output when created using BuildDefault.bat:
'    The current UI culture is fr-FR
'    Bonjour
'    The current UI culture is ru-RU
'    Hello

Aşağıdaki toplu iş dosyasını kullanarak örneğin C# sürümünü derleyebilir ve yürütebilirsiniz. Visual Basic kullanıyorsanız öğesini csc ile vbcdeğiştirin ve uzantısını .cs ile .vbdeğiştirin. Örnek yürütülürken Fransızca dil dizesini görüntüler ancak geçerli kültür Rusça (Rusya) olduğunda bir MissingSatelliteAssemblyException özel durum oluşturur. Bunun nedeni, uydu derlemesinin varsayılan kültürün kaynaklarını içeren en\HelloWorld.dll mevcut olmamasıdır.

vbc HelloWorld.vb  

md fr  
resgen Greet.fr.txt  
al /out:fr\HelloWorld.resources.dll /culture:fr /embed:GreetResources.fr.resources  

HelloWorld  

Aşağıdaki toplu iş dosyasını kullanarak örneğin Visual Basic sürümünü derleyebilir ve yürütebilirsiniz. C# kullanıyorsanız değerini vbc ile cscdeğiştirin ve uzantısını .vb ile .csdeğiştirin. Örnek yürütürken, geçerli kullanıcı arabirimi kültürü Fransızca (Fransa) olduğunda bir Fransızca dil dizesi görüntüler. Geçerli kullanıcı arabirimi kültürü Rusya (Rusça) olduğunda, Rusça dil kaynakları mevcut olmadığından bir İngilizce dil dizesi görüntüler, ancak kaynak yöneticisi varsayılan kültürün kaynaklarını uydu derlemesinden en\HelloWorld2.dll yükleyebilir.

vbc HelloWorld.vb /out:HelloWorld2.exe  

md fr  
resgen GreetResources.fr.txt  
al /out:fr\HelloWorld2.resources.dll /culture:fr /embed:GreetResources.fr.resources  

md en  
resgen GreetResources.en.txt  
al /out:en\HelloWorld2.resources.dll /culture:en /embed:GreetResources.en.resources  

HelloWorld2  

Açıklamalar

Varsayılan kültür, uygun kültüre özgü kaynaklar bulunamazsa kaynakları yüklenen kültürdür. Varsayılan olarak, varsayılan kültüre yönelik kaynaklar ana derlemede bulunur ve MissingManifestResourceException kaynak yöneticisi varsayılan kültür için bir kaynak almayı dener ancak bulamazsa oluşturulur. Ancak özniteliği konum parametresi için değerini belirtirseNeutralResourcesLanguageAttribute, .NET Framework bir uygulamanın varsayılan kültürüne yönelik UltimateResourceFallbackLocation.Satellite kaynakları uydu derlemesinden yükler. Bu durumda, MissingSatelliteAssemblyException kaynak yöneticisi varsayılan kültürün kaynağını almaya çalıştığında ve özniteliğinde NeutralResourcesLanguageAttribute belirtilen kültür için uydu derlemesi eksik olduğunda özel durum oluşturulur. Özel durumun, nesne örneği oluşturulurken değil veya ResourceManager.GetObjectgibi ResourceManager.GetString bir kaynak alma yöntemi tarafından oluştuğunu ResourceManager unutmayın.

MissingSatelliteAssemblyException değeri 0x80131536 olan HRESULT COR_E_MISSINGSATELLITEASSEMBLY kullanır.

MissingSatelliteAssemblyException başvuru eşitliğini destekleyen varsayılan Equals uygulamayı kullanır.

Sınıfının bir örneğinin ilk özellik değerlerinin MissingSatelliteAssemblyException listesi için oluşturuculara MissingSatelliteAssemblyException bakın.

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır

Ayrıca bkz.

• ResourceManager
• MissingManifestResourceException
• Uydu Derlemeleri Oluşturma
• Kaynakları Paketleme ve Dağıtma