ResourceReader.GetResourceData(String, String, Byte[]) Methode

Definitie

Haalt de typenaam en gegevens van een benoemde resource op uit een geopend resourcebestand of -stream.

public:
 void GetResourceData(System::String ^ resourceName, [Runtime::InteropServices::Out] System::String ^ % resourceType, [Runtime::InteropServices::Out] cli::array <System::Byte> ^ % resourceData);
public void GetResourceData(string resourceName, out string resourceType, out byte[] resourceData);
member this.GetResourceData : string * string * Byte[] -> unit
Public Sub GetResourceData (resourceName As String, ByRef resourceType As String, ByRef resourceData As Byte())

Parameters

resourceName
String

De naam van een resource.

resourceType
String

Wanneer deze methode wordt geretourneerd, bevat deze een tekenreeks die de typenaam van de opgehaalde resource vertegenwoordigt. Deze parameter wordt niet-geïnitialiseerd doorgegeven.

resourceData
Byte[]

Wanneer deze methode wordt geretourneerd, bevat een bytematrix die de binaire weergave van het opgehaalde type is. Deze parameter wordt niet-geïnitialiseerd doorgegeven.

Uitzonderingen

resourceName is null.

resourceName bestaat niet.

resourceName heeft een ongeldig type.

De opgehaalde resourcegegevens zijn beschadigd.

Het huidige ResourceReader object is niet geïnitialiseerd, waarschijnlijk omdat het is gesloten.

Opmerkingen

De GetResourceData methode haalt de waarde van een benoemde resource op als een bytematrix. Deze wordt meestal gebruikt wanneer de Value eigenschap een uitzondering genereert wanneer wordt geprobeerd de waarde van een resource op te halen.

resourceType is een tekenreeks die het gegevenstype van de resource vertegenwoordigt. Dit kan een van de volgende waarden zijn:

  • De tekenreeksweergave van een ResourceTypeCode opsommingslid dat het gegevenstype van de resource aangeeft. ResourceTypeCode is een persoonlijke opsomming die wordt gebruikt door .om aan te geven dat een speciale binaire indeling wordt gebruikt om een van de 19 algemene gegevenstypen op te slaan. Deze omvatten de primitieve gegevenstypen van .NET Framework (Boolean, Byte, Char, Decimal, Double, Int16, Int32, Int64, Single, SByte, UInt16, UInt32, UInt64), evenals String, DateTime en TimeSpan, Daarnaast bevat de opsomming ResourceTypeCode de waarden die in de volgende tabel worden weergegeven.

    ResourceTypeCode-waarde Beschrijving
    ResourceTypeCode.ByteArray De gegevens zijn een bytematrix. Dit gegevenstype resulteert meestal uit de aanroep van de ResourceWriter.AddResource(String, Byte[]) methode.
    ResourceTypeCode.Null De gegevens zijn een null-verwijzing. Dit gegevenstype resulteert meestal uit de aanroep van de ResourceWriter.AddResource(String, Object) methode met een object waarvan de waarde is null.
    ResourceTypeCode.Stream De gegevens worden opgeslagen in een stroom. Dit gegevenstype resulteert meestal uit de aanroep naar de ResourceWriter.AddResource(String, Stream) of ResourceWriter.AddResource(String, Stream, Boolean) methode.

    Ervan uitgaande dat dit resourceData niet is beschadigd, kan deze meestal worden geconverteerd van een bytematrix naar de oorspronkelijke waarde door een BitConverter of BinaryReader methode aan te roepen.

  • Een tekenreeks die de volledig gekwalificeerde naam van het type bevat waarvan de geserialiseerde gegevens aan het resourceData argument zijn toegewezen (bijvoorbeeld System.String). Daarnaast bevat de tekenreeks voor typen die geen deel uitmaken van de .NET klassebibliotheek de naam, versie, cultuur en openbare sleutel van de assembly die het type bevat. De volgende tekenreeks geeft bijvoorbeeld aan dat de geserialiseerde gegevens een exemplaar van het Person type in de Extensions naamruimte vertegenwoordigen, dat wordt gevonden in versie 1.0 van een assembly met de naam Utility die geen openbare sleutel en geen aangewezen cultuur heeft.

    Extensions.Person, Utility, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null

  • De tekenreeks die wordt gebruikt om het gegevenstype in de ResourceWriter.AddResourceData methode-aanroep te beschrijven.

Van toepassing op

Zie ook