IsExplicitlyDereferenced Kelas

Definisi

Ruang nama:

System.Runtime.CompilerServices

Rakitan:

System.Runtime.CompilerServices.VisualC.dll

Menunjukkan bahwa pointer terkelola mewakili parameter pointer dalam tanda tangan metode. Kelas ini tidak dapat diwariskan.

public ref class IsExplicitlyDereferenced abstract sealed

public static class IsExplicitlyDereferenced

type IsExplicitlyDereferenced = class

Public Class IsExplicitlyDereferenced

Warisan

Object

IsExplicitlyDereferenced

Contoh

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

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

Di C++, pointer terkelola dan referensi terkelola dipancarkan ke metadata sebagai penunjuk. Untuk membedakan antara dua jenis dalam metadata, pengkompilasi Microsoft C++ menerapkan pengubah ini ke penunjuk terkelola. Ini tidak memancarkan pengubah pada jenis referensi terkelola. Pengkompilasi perlu mengetahui sintaks panggilan yang benar saat mengimpor metode dari cakupan metadata. Kelas IsExplicitlyDereferenced dan mitranya, IsImplicitlyDereferenced kelas , membedakan parameter referensi dari parameter penunjuk.

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

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