InstructionEncoder Структура

Определение

Пространство имен:

System.Reflection.Metadata.Ecma335

Сборка:

System.Reflection.Metadata.dll

Пакет:

System.Reflection.Metadata v9.0.0-rc.2.24473.5

Исходный код:

InstructionEncoder.cs

Кодирует инструкции CIL.

public value class InstructionEncoder

public readonly struct InstructionEncoder

type InstructionEncoder = struct

Public Structure InstructionEncoder

Наследование

Object

ValueType

InstructionEncoder

Примеры

В этом примере показано, как создать тело метода с помощью InstructionEncoder:

// The following code emits a method body similar to this C# code:

/*public static double CalcRectangleArea(double length, double width)
{
    if (length < 0.0)
    {
        throw new ArgumentOutOfRangeException("length");
    }

    if (width < 0.0)
    {
        throw new ArgumentOutOfRangeException("width");
    }

    return length * width;
}*/

private static InstructionEncoder EmitMethodBody(MetadataBuilder metadata, AssemblyReferenceHandle corlibAssemblyRef)
{
    var codeBuilder = new BlobBuilder();
    var encoder = new InstructionEncoder(codeBuilder, new ControlFlowBuilder());

    // Get a reference to the System.ArgumentOutOfRangeException type
    TypeReferenceHandle typeRefHandle = metadata.AddTypeReference(
    corlibAssemblyRef,
    metadata.GetOrAddString("System"),
    metadata.GetOrAddString("ArgumentOutOfRangeException"));

    // Signature: .ctor(string)
    var ctorSignature = new BlobBuilder();

    new BlobEncoder(ctorSignature).
        MethodSignature(isInstanceMethod: true).
        Parameters(1, returnType => returnType.Void(), parameters => parameters.AddParameter().Type().String());

    BlobHandle ctorBlobIndex = metadata.GetOrAddBlob(ctorSignature);

    // Get a reference to the System.ArgumentOutOfRangeException constructor
    MemberReferenceHandle ctorMemberRef = metadata.AddMemberReference(
        typeRefHandle,
        metadata.GetOrAddString(".ctor"),
        ctorBlobIndex);

    LabelHandle label1 = encoder.DefineLabel();
    LabelHandle label2 = encoder.DefineLabel();

    // ldarg.0
    encoder.OpCode(ILOpCode.Ldarg_0);

    // ldc.r8 0
    encoder.LoadConstantR8(0);

    // bge.un.s LABEL1
    encoder.Branch(ILOpCode.Bge_un_s, label1);

    // ldstr "length"
    encoder.LoadString(metadata.GetOrAddUserString("length"));

    // newobj instance void [System.Runtime]System.ArgumentOutOfRangeException::.ctor(string)
    encoder.OpCode(ILOpCode.Newobj);
    encoder.Token(ctorMemberRef);

    // throw
    encoder.OpCode(ILOpCode.Throw);

    // LABEL1: ldarg.1
    encoder.MarkLabel(label1);
    encoder.OpCode(ILOpCode.Ldarg_1);

    // ldc.r8 0
    encoder.LoadConstantR8(0);

    // bge.un.s LABEL2
    encoder.Branch(ILOpCode.Bge_un_s, label2);

    // ldstr "width"
    encoder.LoadString(metadata.GetOrAddUserString("width"));

    // newobj instance void [System.Runtime]System.ArgumentOutOfRangeException::.ctor(string)
    encoder.OpCode(ILOpCode.Newobj);
    encoder.Token(ctorMemberRef);

    // throw
    encoder.OpCode(ILOpCode.Throw);

    // LABEL2: ldarg.0
    encoder.MarkLabel(label2);
    encoder.OpCode(ILOpCode.Ldarg_0);

    // ldarg.1
    encoder.OpCode(ILOpCode.Ldarg_1);

    // mul
    encoder.OpCode(ILOpCode.Mul);

    // ret
    encoder.OpCode(ILOpCode.Ret);

    return encoder;
}

Комментарии

Класс InstructionEncoder используется для выдачи инструкций CIL, составляющих тело метода. Полный пример создания метода см. в документации по классу MetadataBuilder .

Конструкторы

InstructionEncoder(BlobBuilder, ControlFlowBuilder)

Создает кодировщик, поддерживающий код и сборщики потока управления.

Свойства

CodeBuilder	Базовый построитель, в котором записываются закодированные инструкции.
ControlFlowBuilder	Метки отслеживания построителя, ветви и обработчики исключений.
Offset	Смещение следующей закодированной инструкции.

Методы

Branch(ILOpCode, LabelHandle)	Кодирует инструкцию ветви.
Call(EntityHandle)	Кодирует инструкцию call и ее операнд.
Call(MemberReferenceHandle)	Кодирует инструкцию call и ее операнд.
Call(MethodDefinitionHandle)	Кодирует инструкцию call и ее операнд.
Call(MethodSpecificationHandle)	Кодирует инструкцию call и ее операнд.
CallIndirect(StandaloneSignatureHandle)	Кодирует инструкцию calli и ее операнд.
DefineLabel()	Определяет метку, которую впоследствии можно использовать для пометки и ссылки на расположение в потоке инструкций.
LoadArgument(Int32)	Кодирует инструкцию загрузки аргументов.
LoadArgumentAddress(Int32)	Кодирует инструкцию загрузки адреса аргумента.
LoadConstantI4(Int32)	Кодирует инструкцию загрузки константы Int32.
LoadConstantI8(Int64)	Кодирует инструкцию загрузки константы Int64.
LoadConstantR4(Single)	Кодирует инструкцию загрузки константы Single.
LoadConstantR8(Double)	Кодирует инструкцию загрузки константы Double.
LoadLocal(Int32)	Кодирует инструкцию загрузки локальных переменных.
LoadLocalAddress(Int32)	Кодирует инструкцию загрузки адресов локальной переменной.
LoadString(UserStringHandle)	Кодирует инструкцию ldstr и ее операнд.
MarkLabel(LabelHandle)	Связывает указанную метку с текущим смещением IL.
OpCode(ILOpCode)	Кодирует указанный код операции.
StoreArgument(Int32)	Кодирует инструкцию хранилища аргументов.
StoreLocal(Int32)	Кодирует инструкцию хранилища локальной переменной.
Switch(Int32)	Начинает кодирование инструкции переключателя.
Token(EntityHandle)	Кодирует маркер.
Token(Int32)	Кодирует маркер.