IsPinned Kelas

Definisi

Ruang nama:

System.Runtime.CompilerServices

Rakitan:

System.Runtime.CompilerServices.VisualC.dll

Menunjukkan bahwa instans yang dimodifikasi disematkan dalam memori. Kelas ini tidak dapat diwariskan.

public ref class IsPinned abstract sealed

public static class IsPinned

type IsPinned = class

Public Class IsPinned

Warisan

Object

IsPinned

Contoh

Contoh berikut menunjukkan cara memancarkan IsPinned objek ke dalam perakitan menggunakan pantulan.

#using <mscorlib.dll>

using namespace System;
using namespace System::Reflection;
using namespace System::Reflection::Emit;
using namespace System::Runtime::CompilerServices;
using namespace System::Threading;


ref class CodeEmitter
{
private:
    AssemblyBuilder^ asmBuilder;
    String^ asmName;
    ModuleBuilder^ modBuilder;


    void prepareAssembly(String^ name){
        
        // Check the input.
        if(!name){
        
            throw gcnew ArgumentNullException("AssemblyName");
        }

        asmName = name;

        // Create an AssemblyName object and set the name.
        AssemblyName^ asmName = gcnew AssemblyName();

        asmName->Name = name;

        // Use the AppDomain class to create an AssemblyBuilder instance.

        AppDomain^ currentDomain = Thread::GetDomain();

        asmBuilder = currentDomain->DefineDynamicAssembly(asmName,AssemblyBuilderAccess::RunAndSave);

        // Create a dynamic module.
        modBuilder = asmBuilder->DefineDynamicModule(name);
    }


public:

    // Constructor.
    CodeEmitter(String ^ AssemblyName){

        prepareAssembly(AssemblyName);
    }

    // Create a new type.
    TypeBuilder^ CreateType(String^ name){
       
        // Check the input.
        if(!name){
        
            throw gcnew ArgumentNullException("AssemblyName");
        }

        return modBuilder->DefineType( name );
    }

    // Write the assembly.
    void WriteAssembly(MethodBuilder^ entryPoint){
    
        // Check the input.
        if(!entryPoint){
        
            throw gcnew ArgumentNullException("entryPoint");
        }

        asmBuilder->SetEntryPoint( entryPoint );
        asmBuilder->Save( asmName );
    }

};

void main()
{

    // Create a CodeEmitter to handle assembly creation.
    CodeEmitter ^ e = gcnew CodeEmitter("program.exe");

    // Create a new type.
    TypeBuilder^ mainClass = e->CreateType("MainClass");
    
    // Create a new method.
    MethodBuilder^ mBuilder = mainClass->DefineMethod("mainMethod", MethodAttributes::Static);

    // Create an ILGenerator and emit IL for 
    // a simple "Hello World." program.
    ILGenerator^ ilGen = mBuilder->GetILGenerator();

    ilGen->Emit(OpCodes::Ldstr, "Hello World");

    array<Type^>^mType = {String::typeid};

    MethodInfo^ writeMI = Console::typeid->GetMethod( "WriteLine", mType );

    ilGen->EmitCall(OpCodes::Call, writeMI, nullptr );

    ilGen->Emit( OpCodes::Ret );

    /////////////////////////////////////////////////
    /////////////////////////////////////////////////
    // Apply a required custom modifier
    // to a field.
    /////////////////////////////////////////////////
    /////////////////////////////////////////////////

    array<Type^>^fType = {IsPinned::typeid};

    mainClass->DefineField("modifiedInteger", Type::GetType("System.Int32"), fType, nullptr, FieldAttributes::Private);

    // Create the type.
    mainClass->CreateType();

    // Write the assembly using a reference to 
    // the entry point.
    e->WriteAssembly(mBuilder);

    Console::WriteLine(L"Assembly created.");
}

Keterangan

Pengkompilasi memancarkan pengubah kustom dalam metadata untuk mengubah cara pengkompilasi just-in-time (JIT) menangani nilai ketika perilaku default tidak sesuai. Ketika pengkompilasi JIT menemukan pengubah kustom, pengkompilasi menangani nilai dengan cara yang ditentukan pengubah. Pengkompilasi dapat menerapkan pengubah kustom ke metode, parameter, dan nilai yang dikembalikan. Pengkompilasi JIT harus merespons pengubah yang diperlukan tetapi dapat mengabaikan pengubah opsional. Pengkompilasi C++ dapat memancarkan pengubah kustom untuk menjelaskan bagaimana byte harus diperlakukan dalam kasus di mana pengkompilasi JIT memperlakukan byte dengan cara yang tidak kompatibel dengan C++ secara default.

Anda dapat memancarkan pengubah kustom ke dalam metadata menggunakan salah satu teknik berikut:

• Menggunakan metode di kelas seperti DefineMethod, , DefineConstructorDefineField, dan DefineProperty.TypeBuilder

• Menghasilkan file instruksi bahasa perantara Microsoft (MSIL) yang berisi panggilan ke modopt dan modreq, dan merakit file dengan Ilasm.exe (Perakit IL).

• Menggunakan API pantulan yang tidak dikelola.