IsLong Kelas

Definisi

Ruang nama:

System.Runtime.CompilerServices

Rakitan:

System.Runtime.CompilerServices.VisualC.dll

Menunjukkan bahwa bilangan bulat yang dimodifikasi adalah nilai C++ long standar. Kelas ini tidak dapat diwariskan.

public ref class IsLong abstract sealed

public static class IsLong

type IsLong = class

Public Class IsLong

Warisan

Object

IsLong

Contoh

Contoh berikut menunjukkan cara memancarkan IsLong 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 = {IsLong::typeid};

    mainClass->DefineField("modifiedInteger", Type::GetType("System.Int64"), 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

Standar C++ menunjukkan bahwa long nilai dan nilai bilangan bulat adalah jenis yang berbeda. Namun, keduanya diwakili menggunakan ELEMENT_TYPE_I4 dalam perakitan. Untuk membedakan long dari bilangan bulat di C++, pengkompilasi Microsoft C++ menambahkan pengubah ke instans IsLong apa long pun saat instans dipancarkan. Proses ini sangat penting untuk menjaga keamanan jenis tingkat bahasa.

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.

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

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

• Membuat 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 terkelola.