ModuleBuilder.DefineInitializedData(String, Byte[], FieldAttributes) Método

Definição

Espaço de Nomes:
System.Reflection.Emit
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll

Define um campo de dados inicializado na secção .sdata do ficheiro executável portátil (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

Parâmetros

name
String

O nome usado para se referir aos dados. name não pode conter nulos embutidos.

data
Byte[]

O objeto binário grande (BLOB) dos dados.

attributes
FieldAttributes

Os atributos do campo. A predefinição é Static.

Devoluções

FieldBuilder

Um campo para referenciar os dados.

Exceções

ArgumentException

O comprimento de name é zero.

-ou-

O tamanho de data é menor ou igual a zero, ou maior ou igual a 0x3f0000.

ArgumentNullException

name ou data é null.

InvalidOperationException

CreateGlobalFunctions() já foi anteriormente chamado.

Exemplos

O exemplo seguinte utiliza o DefineInitializedData método para definir um campo de dados inicializado na .sdata secção do ficheiro executável portátil (PE).

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

Observações

Static é automaticamente incluído em attributes.

Os dados definidos por este método não são criados até que o CreateGlobalFunctions método seja chamado.

Aplica-se a