ResourceReader.GetResourceData(String, String, Byte[]) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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
ResourceTypeCodeopsommingslid dat het gegevenstype van de resource aangeeft.ResourceTypeCodeis 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 opsommingResourceTypeCodede waarden die in de volgende tabel worden weergegeven.ResourceTypeCode-waarde Beschrijving ResourceTypeCode.ByteArrayDe gegevens zijn een bytematrix. Dit gegevenstype resulteert meestal uit de aanroep van de ResourceWriter.AddResource(String, Byte[]) methode. ResourceTypeCode.NullDe 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.StreamDe 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
resourceDataniet 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
resourceDataargument zijn toegewezen (bijvoorbeeldSystem.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 hetPersontype in deExtensionsnaamruimte 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=nullDe tekenreeks die wordt gebruikt om het gegevenstype in de ResourceWriter.AddResourceData methode-aanroep te beschrijven.