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

Definition

Namnområde:
System.Resources
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll

Hämtar typnamnet och data för en namngiven resurs från en öppen resursfil eller dataström.

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())

Parametrar

resourceName
String

Namnet på en resurs.

resourceType
String

När den här metoden returneras innehåller en sträng som representerar typnamnet för den hämtade resursen. Den här parametern skickas oinitierad.

resourceData
Byte[]

När den här metoden returnerar innehåller en bytematris som är den binära representationen av den hämtade typen. Den här parametern skickas oinitierad.

Undantag

ArgumentNullException

resourceName är null.

ArgumentException

resourceName finns inte.

BadImageFormatException

resourceName har en ogiltig typ.

FormatException

De hämtade resursdata är skadade.

InvalidOperationException

Det aktuella ResourceReader objektet initieras inte, förmodligen för att det är stängt.

Kommentarer

Metoden GetResourceData hämtar värdet för en namngiven resurs som en bytematris. Den används vanligtvis när egenskapen Value utlöser ett undantag när den försöker hämta värdet för en resurs.

resourceType är en sträng som representerar resursens datatyp. Det kan vara något av följande värden:

  • Strängrepresentationen av en ResourceTypeCode uppräkningsmedlem som anger resursens datatyp. ResourceTypeCode är en privat uppräkning som används av .för att indikera att ett särskilt binärt format används för att lagra en av 19 vanliga datatyper. Dessa omfattar primitiva .NET Framework-datatyper (Boolean, Byte, Char, Decimal, Double, Int16, Int32, Int64, Single, SByte, UInt16, UInt32, UInt64), samt String, DateTime och TimeSpan, Dessutom innehåller ResourceTypeCode uppräkning de värden som visas i följande tabell.

    ResourceTypeCode-värde Description
    ResourceTypeCode.ByteArray Data är en bytematris. Den här datatypen är vanligtvis resultatet av anropet ResourceWriter.AddResource(String, Byte[]) till metoden.
    ResourceTypeCode.Null Data är en null-referens. Den här datatypen är vanligtvis resultatet av anropet ResourceWriter.AddResource(String, Object) till metoden med ett objekt vars värde är null.
    ResourceTypeCode.Stream Data lagras i en dataström. Den här datatypen är vanligtvis resultatet av anropet ResourceWriter.AddResource(String, Stream) till metoden eller ResourceWriter.AddResource(String, Stream, Boolean) .

    Förutsatt att det resourceData inte har skadats kan den vanligtvis konverteras från en bytematris tillbaka till dess ursprungliga värde genom att anropa en BitConverter eller BinaryReader -metod.

  • En sträng som innehåller det fullständigt kvalificerade namnet på den typ vars serialiserade data har tilldelats argumentet (till resourceData exempel System.String). För typer som inte ingår i .NET-klassbiblioteket innehåller strängen dessutom namn, version, kultur och offentlig nyckel för sammansättningen som innehåller typen. Följande sträng anger till exempel att serialiserade data representerar en instans av Person typen i Extensions namnområdet, som finns i version 1.0 av en sammansättning med namnet Utility som inte har någon offentlig nyckel och ingen angiven kultur.

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

  • Strängen som används för att beskriva datatypen i metodanropet ResourceWriter.AddResourceData .

Gäller för

Se även