MissingSatelliteAssemblyException Sınıf

Tanım

Varsayılan kültür kaynakları için uydu derlemesi eksik olduğunda oluşturulan özel durum.The exception that is thrown when the satellite assembly for the resources of the default culture is missing.

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
MissingSatelliteAssemblyException
Öznitelikler

Örnekler

Aşağıdaki örnek, NeutralResourcesLanguageAttribute İngilizce uygulamanın varsayılan kültürü olduğunu ve kaynaklarının bir uydu derlemesinde depolandığını göstermek için özniteliğini kullanır.The following example uses the NeutralResourcesLanguageAttribute attribute to indicate that English is the app's default culture and that its resources are stored in a satellite assembly. Örnek, aşağıdaki tabloda açıklandığı gibi, Ingilizce ve Fransızca kültürleri için. txt dosyalarındaki kaynakları içerir:The example itself includes resources in .txt files for the English and French cultures, as described in the following table:

KültürCulture Kaynak adı/değeriResource name/value Dosya adıFile name
İngilizceEnglish Greet = MerhabaGreet=Hello Greet.en.txtGreet.en.txt
FransızcaFrench Greet = BonjourGreet=Bonjour Greet.fr.txtGreet.fr.txt

Aşağıdaki kaynak kodu, önce geçerli kullanıcı Arabirimi kültürünü Fransızca (Fransa) ve ardından Rusça (Rusya) olarak değiştiren bir uygulama oluşturur ve her iki durumda da kültüre özgü uygun bir kaynak görüntüler.The following source code builds an app that changes the current UI culture first to French (France) and then to Russian (Russia) and displays an appropriate culture-specific resource in both cases.

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

Örnek C# sürümünü derlemek ve yürütmek için aşağıdaki toplu iş dosyasını kullanabilirsiniz.You can use the following batch file to build and execute the C# version of the example. Visual Basic kullanıyorsanız, csc ile değiştirin vbc ve .cs uzantısını ile değiştirin .vb .If you're using Visual Basic, replace csc with vbc, and replace the .cs extension with .vb. Örnek yürütüldüğünde, bir Fransızca dil dizesi görüntüler, ancak MissingSatelliteAssemblyException geçerli kültür Rusça (Rusya) olduğunda bir özel durum oluşturur.When the example is executed, it displays a French language string but throws a MissingSatelliteAssemblyException exception when the current culture is Russian (Russia). Bunun nedeni, varsayılan kültürün kaynaklarını içeren uydu derlemesinin en\HelloWorld.dll yoktur.This is because the satellite assembly en\HelloWorld.dll that contains the resources of the default culture does not exist.

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ı, örneğin Visual Basic sürümünü derlemek ve yürütmek için kullanabilirsiniz.You can use the following batch file to build and execute the Visual Basic version of the example. C# kullanıyorsanız, vbc ile değiştirin csc ve .vb uzantısını ile değiştirin .cs .If you're using C#, replace vbc with csc, and replace the .vb extension with .cs. Örnek yürütüldüğünde, geçerli UI kültürü Fransızca (Fransa) olduğunda bir Fransızca dil dizesi görüntüler.When the example is executed, it displays a French language string when the current UI culture is French (France). Geçerli Kullanıcı arabirimi kültürü Rusya (Rusça) olduğunda, Rusça dil kaynakları mevcut olmadığından ve Resource Manager varsayılan kültürün kaynaklarını uydu derlemesinden en\HelloWorld2.dll yükleyebildiğinden, bu bir Ingilizce dil dizesi görüntüler.When the current UI culture is Russia (Russian), it displays an English language string because Russian language resources do not exist, but the resource manager is able to load the resources of the default culture from the satellite assembly en\HelloWorld2.dll.

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üklenmiş olan kültürdür.The default culture is the culture whose resources are loaded if the appropriate culture-specific resources cannot be found. Varsayılan olarak, varsayılan kültür için kaynaklar ana derlemede bulunur ve MissingManifestResourceException Kaynak Yöneticisi varsayılan kültür için bir kaynak bulmaya çalışırsa bir oluşturulur.By default, resources for the default culture are located in the main assembly, and a MissingManifestResourceException is thrown if the resource manager tries to retrieve but cannot find a resource for the default culture. Ancak, NeutralResourcesLanguageAttribute öznitelik konum parametresi için bir değer belirtiyorsa, .NET Framework bir uydu derlemesinden uygulamanın varsayılan kültürünün kaynaklarını yükler UltimateResourceFallbackLocation.Satellite .However, the .NET Framework will load the resources for an app's default culture from a satellite assembly if the NeutralResourcesLanguageAttribute attribute specifies a value of UltimateResourceFallbackLocation.Satellite for the location parameter. Bu durumda, MissingSatelliteAssemblyException Resource Manager varsayılan kültür kaynağını almaya çalıştığında ve özniteliğinde belirtilen kültürün uydu derlemesi eksik olduğunda özel durum oluşturulur NeutralResourcesLanguageAttribute .When this is the case, the MissingSatelliteAssemblyException exception is thrown when the resource manager tries to retrieve a resource of the default culture and the satellite assembly for the culture specified in the NeutralResourcesLanguageAttribute attribute is missing. Özel durumun, veya gibi bir kaynak alma yöntemi tarafından ResourceManager.GetString ResourceManager.GetObject , nesne örneği oluşturulduğunda değil, olduğunu unutmayın ResourceManager .Note that the exception is thrown by a resource retrieval method such as ResourceManager.GetString or ResourceManager.GetObject, and not when the ResourceManager object is instantiated.

MissingSatelliteAssemblyException 0x80131536 değerine sahip HRESULT COR_E_MISSINGSATELLITEASSEMBLY kullanır.MissingSatelliteAssemblyException uses the HRESULT COR_E_MISSINGSATELLITEASSEMBLY, which has the value 0x80131536.

MissingSatelliteAssemblyExceptionEquals, başvuru eşitliğini destekleyen varsayılan uygulamayı kullanır.MissingSatelliteAssemblyException uses the default Equals implementation, which supports reference equality.

Sınıfının bir örneği için ilk özellik değerlerinin listesi için MissingSatelliteAssemblyException bkz MissingSatelliteAssemblyException . oluşturucular.For a list of initial property values for an instance of the MissingSatelliteAssemblyException class, see the MissingSatelliteAssemblyException constructors.

Not

NeutralResourcesLanguageAttributeBelirli bir kültür için bir kaynak kullanılamaz hale gelirse, uygulamanızın kabul edilebilir bir davranışı görüntülemesi için uygulamanızın varsayılan kültürünü tanımlamak üzere her zaman özniteliğini kullanmanız gerekir.You should always use the NeutralResourcesLanguageAttribute attribute to define your app's default culture so that if a resource for a specific culture is unavailable, your application will display acceptable behavior.

Oluşturucular

MissingSatelliteAssemblyException()

Varsayılan özelliklerle sınıfının yeni bir örneğini başlatır MissingSatelliteAssemblyException .Initializes a new instance of the MissingSatelliteAssemblyException class with default properties.

MissingSatelliteAssemblyException(SerializationInfo, StreamingContext)

MissingSatelliteAssemblyExceptionSeri hale getirilen verilerden sınıfının yeni bir örneğini başlatır.Initializes a new instance of the MissingSatelliteAssemblyException class from serialized data.

MissingSatelliteAssemblyException(String)

MissingSatelliteAssemblyExceptionBelirtilen hata iletisiyle sınıfın yeni bir örneğini başlatır.Initializes a new instance of the MissingSatelliteAssemblyException class with the specified error message.

MissingSatelliteAssemblyException(String, Exception)

MissingSatelliteAssemblyExceptionBelirtilen bir hata iletisiyle sınıfın yeni bir örneğini ve bu özel durumun nedeni olan iç özel duruma bir başvuruyu başlatır.Initializes a new instance of the MissingSatelliteAssemblyException class with a specified error message and a reference to the inner exception that is the cause of this exception.

MissingSatelliteAssemblyException(String, String)

MissingSatelliteAssemblyExceptionBelirtilen bir hata iletisiyle sınıfının yeni bir örneğini ve nötr kültürün adını başlatır.Initializes a new instance of the MissingSatelliteAssemblyException class with a specified error message and the name of a neutral culture.

Özellikler

CultureName

Varsayılan kültürün adını alır.Gets the name of the default culture.

Data

Özel durum hakkında ek kullanıcı tanımlı bilgiler sağlayan anahtar/değer çiftleri koleksiyonunu alır.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Devralındığı yer: Exception)
HelpLink

Bu özel durumla ilişkili Yardım dosyasının bağlantısını alır veya ayarlar.Gets or sets a link to the help file associated with this exception.

(Devralındığı yer: Exception)
HResult

Belirli bir özel duruma atanan kodlanmış bir sayısal değer olan HRESULT 'yi alır veya ayarlar.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Devralındığı yer: Exception)
InnerException

ExceptionGeçerli özel duruma neden olan örneği alır.Gets the Exception instance that caused the current exception.

(Devralındığı yer: Exception)
Message

Geçerli özel durumu açıklayan bir ileti alır.Gets a message that describes the current exception.

(Devralındığı yer: Exception)
Source

Uygulamanın veya hataya neden olan nesnenin adını alır veya ayarlar.Gets or sets the name of the application or the object that causes the error.

(Devralındığı yer: Exception)
StackTrace

Çağrı yığınında anlık çerçevelerin dize gösterimini alır.Gets a string representation of the immediate frames on the call stack.

(Devralındığı yer: Exception)
TargetSite

Geçerli özel durumu oluşturan yöntemi alır.Gets the method that throws the current exception.

(Devralındığı yer: Exception)

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetBaseException()

Türetilmiş bir sınıfta geçersiz kılınırsa, Exception bir veya daha fazla sonraki özel durumun kök nedeni olan öğesini döndürür.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Devralındığı yer: Exception)
GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetObjectData(SerializationInfo, StreamingContext)

Türetilmiş bir sınıfta geçersiz kılınırsa, SerializationInfo özel durum hakkındaki bilgileri ayarlar.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Devralındığı yer: Exception)
GetType()

Geçerli örneğin çalışma zamanı türünü alır.Gets the runtime type of the current instance.

(Devralındığı yer: Exception)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
ToString()

Geçerli özel durumun dize gösterimini oluşturur ve döndürür.Creates and returns a string representation of the current exception.

(Devralındığı yer: Exception)

Ekinlikler

SerializeObjectState

Özel durum hakkında serileştirilmiş veri içeren bir özel durum nesnesi oluşturmak için bir özel durum serileştirildiğinde gerçekleşir.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Devralındığı yer: Exception)

Şunlara uygulanır

Ayrıca bkz.