IsByValue Kelas

Definisi

Ruang nama:

System.Runtime.CompilerServices

Rakitan:

System.Runtime.CompilerServices.VisualC.dll

Menunjukkan bahwa argumen metode yang dimodifikasi harus ditafsirkan sebagai memiliki semantik objek yang diteruskan oleh nilai. Pengubah ini diterapkan ke jenis referensi. Kelas ini tidak dapat diwariskan.

public ref class IsByValue abstract sealed

public static class IsByValue

type IsByValue = class

Public Class IsByValue

Warisan

Object

IsByValue

Contoh

Contoh berikut menunjukkan cara memancarkan IsByValue 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 = {IsByValue::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

Kelas IsByValue ini digunakan oleh pengkompilasi Microsoft C++ untuk menunjukkan parameter metode dan mengembalikan nilai yang semantiknya mengikuti aturan C++ untuk objek yang diteruskan oleh nilai.

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.