Exportieren (0) Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

MissingSatelliteAssemblyException-Klasse

Die Ausnahme, die ausgelöst wird, wenn die Satellitenassembly für die Ressourcen der Standardkultur fehlt.

System.Object
  System.Exception
    System.SystemException
      System.Resources.MissingSatelliteAssemblyException

Namespace:  System.Resources
Assembly:  mscorlib (in mscorlib.dll)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class MissingSatelliteAssemblyException : SystemException

Der MissingSatelliteAssemblyException-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeMissingSatelliteAssemblyException()Initialisiert eine neue Instanz der MissingSatelliteAssemblyException-Klasse mit Standardeigenschaften.
Öffentliche MethodeMissingSatelliteAssemblyException(String)Initialisiert eine neue Instanz der MissingSatelliteAssemblyException-Klasse mit der angegebenen Fehlermeldung.
Geschützte MethodeMissingSatelliteAssemblyException(SerializationInfo, StreamingContext)Initialisiert eine neue Instanz der MissingSatelliteAssemblyException-Klasse mit serialisierten Daten.
Öffentliche MethodeMissingSatelliteAssemblyException(String, Exception)Initialisiert eine neue Instanz der MissingSatelliteAssemblyException-Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme, die diese Ausnahme ausgelöst hat.
Öffentliche MethodeMissingSatelliteAssemblyException(String, String)Initialisiert eine neue Instanz der MissingSatelliteAssemblyException-Klasse mit einer angegebenen Fehlermeldung und dem Namen einer neutralen Kultur.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftCultureNameRuft den Namen der Standardkultur ab.
Öffentliche EigenschaftDataRuft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zu der Ausnahme bereitstellen. (Von Exception geerbt.)
Öffentliche EigenschaftHelpLinkRuft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest. (Von Exception geerbt.)
Öffentliche EigenschaftHResultRuft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist. (Von Exception geerbt.)
Öffentliche EigenschaftInnerExceptionRuft die Exception-Instanz ab, die die aktuelle Ausnahme verursachte. (Von Exception geerbt.)
Öffentliche EigenschaftMessageRuft eine Meldung ab, die die aktuelle Ausnahme beschreibt. (Von Exception geerbt.)
Öffentliche EigenschaftSourceGibt den Namen der Anwendung oder des Objekts zurück, das den Fehler verursacht hat, oder legt diesen fest. (Von Exception geerbt.)
Öffentliche EigenschaftStackTraceRuft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab. (Von Exception geerbt.)
Öffentliche EigenschaftTargetSiteRuft die Methode ab, die die aktuelle Ausnahme auslöst. (Von Exception geerbt.)
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Geschützte MethodeFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeGetBaseExceptionGibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die ursprüngliche Ursache für eine oder mehrere nachfolgende Ausnahmen ist. (Von Exception geerbt.)
Öffentliche MethodeGetHashCodeFungiert als die Standardhashfunktion. (Von Object geerbt.)
Öffentliche MethodeGetObjectDataLegt beim Überschreiben in einer abgeleiteten Klasse die SerializationInfo mit Informationen über die Ausnahme fest. (Von Exception geerbt.)
Öffentliche MethodeGetTypeRuft den Laufzeittyp der aktuellen Instanz ab. (Von Exception geerbt.)
Geschützte MethodeMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche MethodeToStringErstellt eine Zeichenfolgenentsprechung der aktuellen Ausnahme und gibt diese zurück. (Von Exception geerbt.)
Zum Seitenanfang

  NameBeschreibung
Geschütztes EreignisSerializeObjectStateTritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt zu erstellen, das serialisierte Daten für die Ausnahme enthält. (Von Exception geerbt.)
Zum Seitenanfang

Die Standardkultur ist diejenige Kultur, deren Ressourcen geladen werden, wenn die entsprechenden kulturspezifische Ressourcen nicht gefunden werden können. Standardmäßig sind Ressourcen für die Standardkultur in der Hauptassembly, und MissingManifestResourceException wird ausgelöst, wenn die Ressourcen-Manager-Versuche abzurufen jedoch eine Ressource für die Standardkultur nicht findet. Allerdings wird .NET Framework die Ressourcen für die Standardkultur einer App aus einer Satellitenassembly, wenn das NeutralResourcesLanguageAttribute-Attribut dem Wert UltimateResourceFallbackLocation.Satellite für den Lageparameter angibt. Wenn dies der Fall ist, wird die Ausnahme MissingSatelliteAssemblyException ausgelöst, wenn Ressourcen-Manager versucht, eine Ressource der Standardkultur abzurufen und die Satellitenassembly für die Kultur, die im NeutralResourcesLanguageAttribute-Attribut angegeben wird, fehlt. Beachten Sie, dass die Ausnahme durch eine Ressourcenabrufmethode wie ResourceManager.GetString oder ResourceManager.GetObject wird nicht ausgelöst, und wenn das ResourceManager-Objekt instanziiert wird.

MissingSatelliteAssemblyException verwendet HRESULT COR_E_MISSINGSATELLITEASSEMBLY mit dem Wert 0x80131536.

MissingSatelliteAssemblyException verwendet die Equals-Standardimplementierung, die Verweisgleichheit unterstützt.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz der MissingSatelliteAssemblyException-Klasse finden Sie unter den MissingSatelliteAssemblyException-Konstruktoren.

HinweisHinweis

Sie sollten das Attribut immer NeutralResourcesLanguageAttribute verwenden, um die Standardkultur der App zu definieren, dass, wenn eine Ressource für eine bestimmte Kultur nicht verfügbar ist, die Anwendung zulässigen Verhalten dargestellt wird.

Im folgenden Beispiel wird das NeutralResourcesLanguageAttribute-Attribut, um anzugeben, dass " die Standardkultur der App ist und dass die Ressourcen in einer Satellitenassembly gespeichert werden. Das Beispiel selbst enthält Ressourcen in .txt- Dateien für die englischen und französischen Kulturen, wie in der folgenden Tabelle beschrieben:

Kultur

Ressourcenname/Wert

Dateiname

Englisch

Greet=Hello

Greet.en.txt

Französisch

Greet=Bonjour

Greet.fr.txt

Der folgende Quellcode erstellt eine App, die die aktuelle UI-Kultur zuerst in die (Französisch (Frankreich) und dann an) (Russische Föderation) und den Anzeigen eine entsprechende Ressource kulturspezifische in beiden Fällen ändert.


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 ass
//    embly named "HelloWorld.resources.dll, PublicKeyToken=" for fallback culture "en" either c
//    ould not be found or could not be loaded. This is generally a setup problem. Please consid
//    er 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


Sie können die folgende Batchdatei verwenden, um die C#-Version des Beispiels zu erstellen und auszuführen. Wenn Sie Visual Basic verwenden, ersetzen Sie csc durch vbc und die Erweiterung .cs durch .vb. Wenn das Beispiel ausgeführt wird, zeigt es eine Zeichenfolge in französischen Sprache an, wirft aber eine MissingSatelliteAssemblyException Ausnahme, wenn die aktuelle Kultur Russisch (Russland) ist. Dies liegt daran, dass die Satellitenassembly en\HelloWorld.dll, die die Ressourcen der Standardkultur enthält, nicht vorhanden ist.


vbc HelloWorld.vb

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

HelloWorld

Sie können die folgende Batchdatei verwenden, um die Visual Basic-Version des Beispiels zu erstellen und auszuführen. Wenn Sie C# verwenden, ersetzen Sie vbc durch csc und die Erweiterung .vb durch.cs. Wenn das Beispiel ausgeführt wird, wird eine Zeichenfolge in französischer Sprache an, wenn die aktuelle UI-Kultur Französisch (Frankreich) ist. Wenn die aktuelle UI-Kultur die Russische Föderation (russisch) ist, wird eine Zeichenfolge der englischen Sprache an, da Russisch Sprachressourcen nicht vorhanden sind, jedoch Ressourcen-Manager ist in der Lage, die Ressourcen der Standardkultur von der Satellitenassembly en\HelloWorld2.dll zu laden.


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

.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft