ModuleBuilder.DefineInitializedData(String, Byte[], FieldAttributes) Methode

Definition

Namespace:

System.Reflection.Emit

Assemblys:

netstandard.dll, System.Reflection.Emit.dll

Quelle:

ModuleBuilder.cs

Definiert ein initialisiertes Datenfeld im .sdata-Abschnitt der übertragbaren ausführbaren Datei (Portable Executable, PE).

public:
 System::Reflection::Emit::FieldBuilder ^ DefineInitializedData(System::String ^ name, cli::array <System::Byte> ^ data, System::Reflection::FieldAttributes attributes);

public System.Reflection.Emit.FieldBuilder DefineInitializedData(string name, byte[] data, System.Reflection.FieldAttributes attributes);

member this.DefineInitializedData : string * byte[] * System.Reflection.FieldAttributes -> System.Reflection.Emit.FieldBuilder

Public Function DefineInitializedData (name As String, data As Byte(), attributes As FieldAttributes) As FieldBuilder

Parameter

name

String

Der Name, der zum Verweisen auf die Daten verwendet wird. name darf keine eingebetteten NULL-Werte enthalten.

data

Byte[]

Das BLOB (Binary Large Object) der Daten.

attributes

FieldAttributes

Die Attribute für das Feld. Der Standardwert ist Static.

Gibt zurück

FieldBuilder

Ein Feld zum Verweisen auf die Daten.

Ausnahmen

ArgumentException

Die Länge von name ist 0 (null).

- oder -

Die Größe von data ist kleiner oder gleich 0 bzw. größer oder gleich 0x3f0000.

ArgumentNullException

name oder data ist null.

InvalidOperationException

CreateGlobalFunctions() wurde bereits zuvor aufgerufen.

Beispiele

Im folgenden Beispiel wird die DefineInitializedData -Methode verwendet, um ein initialisiertes Datenfeld im .sdata Abschnitt der portablen ausführbaren Datei (PE) zu definieren.

AppDomain currentDomain;
AssemblyName myAssemblyName;

// Get the current application domain for the current thread.
currentDomain = AppDomain.CurrentDomain;
myAssemblyName = new AssemblyName();
myAssemblyName.Name = "TempAssembly";

// Define a dynamic assembly in the 'currentDomain'.
myAssemblyBuilder =
   currentDomain.DefineDynamicAssembly
               (myAssemblyName, AssemblyBuilderAccess.Run);

// Define a dynamic module in "TempAssembly" assembly.
myModuleBuilder = myAssemblyBuilder.DefineDynamicModule("TempModule");

// Define the initialized data field in the .sdata section of the PE file.
FieldBuilder myFieldBuilder =
    myModuleBuilder.DefineInitializedData("MyField",new byte[]{01,00,01},
               FieldAttributes.Static|FieldAttributes.Public);
 myModuleBuilder.CreateGlobalFunctions();

Dim currentDomain As AppDomain
Dim myAssemblyName As AssemblyName
' Get the current application domain for the current thread.
currentDomain = AppDomain.CurrentDomain
myAssemblyName = New AssemblyName()
myAssemblyName.Name = "TempAssembly"
' Define a dynamic assembly in the 'currentDomain'.
myAssemblyBuilder = _
      currentDomain.DefineDynamicAssembly(myAssemblyName, AssemblyBuilderAccess.Run)
' Define a dynamic module in "TempAssembly" assembly.
myModuleBuilder = myAssemblyBuilder.DefineDynamicModule("TempModule")
' Define the initialized data field in the .sdata section of the PE file.
Dim myFieldBuilder As FieldBuilder = _
      myModuleBuilder.DefineInitializedData("MyField", New Byte() {1, 0, 1}, _
      FieldAttributes.Static Or FieldAttributes.Public)
myModuleBuilder.CreateGlobalFunctions()

Hinweise

Static ist automatisch in attributesenthalten.

Die von dieser Methode definierten Daten werden erst erstellt, wenn die CreateGlobalFunctions Methode aufgerufen wird.

Hinweis

Ab dem .NET Framework 2.0 Service Pack 1 benötigt ReflectionPermission dieses Mitglied nicht mehr das ReflectionPermissionFlag.ReflectionEmit Flag. (Siehe Sicherheitsprobleme in Reflection Emit.) Um diese Funktionalität zu verwenden, sollte Ihre Anwendung auf die .NET Framework 3.5 oder höher abzielen.