InstructionEncoder Yapı

Tanım

Ad Alanı:

System.Reflection.Metadata.Ecma335

Bütünleştirilmiş Kod:

System.Reflection.Metadata.dll

Kaynak:

InstructionEncoder.cs

Ortak Ara Dil (CIL) yönergelerini kodlar.

public value class InstructionEncoder

public readonly struct InstructionEncoder

type InstructionEncoder = struct

Public Structure InstructionEncoder

Devralma

Object

ValueType

InstructionEncoder

Örnekler

Bu örnekte kullanarak InstructionEncoderbir yöntem gövdesini yayma gösterilmektedir:

// 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;
}

Açıklamalar

InstructionEncoder sınıfı, yöntem gövdesini oluşturan CIL yönergelerini yaymak için kullanılır. Yöntem yayma işleminin tam örneği için sınıf belgelerine MetadataBuilder bakın.

Oluşturucular

InstructionEncoder(BlobBuilder, ControlFlowBuilder)

Kod ve denetim akışı oluşturucuları tarafından yedeklenen bir kodlayıcı oluşturur.

Özellikler

CodeBuilder	Kodlanmış yönergelerin yazıldığı temel oluşturucu.
ControlFlowBuilder	Oluşturucu izleme etiketleri, dallar ve özel durum işleyicileri.
Offset	Sonraki kodlanmış yönergenin uzaklığı.

Yöntemler

Branch(ILOpCode, LabelHandle)	Dal yönergesi kodlar.
Call(EntityHandle)	Yönergeyi ve işlenenini kodlar call .
Call(MemberReferenceHandle)	Yönergeyi ve işlenenini kodlar call .
Call(MethodDefinitionHandle)	Yönergeyi ve işlenenini kodlar call .
Call(MethodSpecificationHandle)	Yönergeyi ve işlenenini kodlar call .
CallIndirect(StandaloneSignatureHandle)	Yönergeyi ve işlenenini kodlar calli .
DefineLabel()	Daha sonra yönerge akışındaki bir konumu işaretlemek ve buna başvurmak için kullanılabilecek bir etiket tanımlar.
LoadArgument(Int32)	Bağımsız değişken yükleme yönergesi kodlar.
LoadArgumentAddress(Int32)	Bağımsız değişken adresi yükleme yönergesi kodlar.
LoadConstantI4(Int32)	Sabit yük yönergesi kodlar Int32 .
LoadConstantI8(Int64)	Sabit yük yönergesi kodlar Int64 .
LoadConstantR4(Single)	Sabit yük yönergesi kodlar Single .
LoadConstantR8(Double)	Sabit yük yönergesi kodlar Double .
LoadLocal(Int32)	Yerel değişken yükleme yönergesi kodlar.
LoadLocalAddress(Int32)	Yerel değişken adresi yükleme yönergesi kodlar.
LoadString(UserStringHandle)	Yönergeyi ve işlenenini kodlar ldstr .
MarkLabel(LabelHandle)	Belirtilen etiketi geçerli IL uzaklığıyla ilişkilendirir.
OpCode(ILOpCode)	Belirtilen op-code kodunu kodlar.
StoreArgument(Int32)	Bağımsız değişken deposu yönergesi kodlar.
StoreLocal(Int32)	Yerel değişken deposu yönergesi kodlar.
Switch(Int32)	Anahtar yönergesi kodlamayı başlatır.
Token(EntityHandle)	Bir belirteci kodlar.
Token(Int32)	Bir belirteci kodlar.